Module org.opengis.geoapi

Package org.opengis.metadata.constraint

Class Restriction

Object

CodeList<Restriction>

Restriction

All Implemented Interfaces:

Serializable, Comparable<Restriction>, ControlledVocabulary

@UML(identifier="MD_RestrictionCode",
     specification=ISO_19115)
public final class Restriction
extends CodeList<Restriction>

Limitation(s) placed upon the access or use of the data.

Since:

2.0

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.opengis.util.CodeList

CodeList.Filter

Field Summary

Fields

Modifier and Type	Field	Description
static final Restriction	CONFIDENTIAL	Not available to the public contains information that could be prejudicial to a commercial, industrial, or national interest.
static final Restriction	COPYRIGHT	Exclusive right to the publication, production, or sale of the rights to a literary, dramatic, musical, or artistic work, or to the use of a commercial print or label, granted by law for a specified period of time to an author, composer, artist, distributor.
static final Restriction	IN_CONFIDENCE	With trust.
static final Restriction	INTELLECTUAL_PROPERTY_RIGHTS	Rights to financial benefit from and control of distribution of non-tangible property that is a result of creativity.
static final Restriction	LICENCE	Formal permission to do something.
static final Restriction	LICENCE_DISTRIBUTOR	Formal permission required for a person or an entity to commercialize or distribute the resource.
static final Restriction	LICENCE_END_USER	Formal permission required for a person or an entity to use the resource and that may differ from the person that orders or purchases it.
static final Restriction	LICENCE_UNRESTRICTED	Formal permission not required to use the resource.
static final Restriction	LICENSE	Deprecated. As of ISO 19115:2014, renamed LICENCE.
static final Restriction	OTHER_RESTRICTIONS	Limitation not listed.
static final Restriction	PATENT	Government has granted exclusive right to make, sell, use or license an invention or discovery.
static final Restriction	PATENT_PENDING	Produced or sold information awaiting a patent.
static final Restriction	PRIVATE	Protects rights of individual or organisations from observation, intrusion, or attention of others.
static final Restriction	RESTRICTED	Withheld from general circulation or disclosure.
static final Restriction	SENSITIVE_BUT_UNCLASSIFIED	Although unclassified, requires strict controls over its distribution.
static final Restriction	STATUTORY	Prescribed by law.
static final Restriction	TRADEMARK	A name, symbol, or other device identifying a product, officially registered and legally restricted to the use of the owner or manufacturer.
static final Restriction	UNRESTRICTED	No constraints exist.

Method Summary

Modifier and Type	Method	Description
Restriction[]	family()	Returns the list of codes of the same kind as this code list element.
String[]	names()	Returns the programmatic name and the UML identifier of this code, together with legacy UML identifier if any.
static Restriction	valueOf(String code)	Returns the restriction that matches the given string, or returns a new one if none match it.
static Restriction[]	values()	Returns the list of Restrictions.

Methods inherited from class org.opengis.util.CodeList

compareTo, identifier, name, ordinal, readResolve, toString, valueOf, valueOf, valueOf, values

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

COPYRIGHT

@UML(identifier="copyright",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction COPYRIGHT

Exclusive right to the publication, production, or sale of the rights to a literary, dramatic, musical, or artistic work, or to the use of a commercial print or label, granted by law for a specified period of time to an author, composer, artist, distributor.

PATENT

@UML(identifier="patent",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction PATENT

Government has granted exclusive right to make, sell, use or license an invention or discovery.

PATENT_PENDING

@UML(identifier="patentPending",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction PATENT_PENDING

Produced or sold information awaiting a patent.

TRADEMARK

@UML(identifier="trademark",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction TRADEMARK

A name, symbol, or other device identifying a product, officially registered and legally restricted to the use of the owner or manufacturer.

LICENCE

@UML(identifier="licence",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction LICENCE

Formal permission to do something. Note: it was spelled "license" in ISO 19115:2003.

Since:

3.1

LICENSE

@Deprecated(since="3.1")
@UML(identifier="license",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final Restriction LICENSE

Deprecated.

As of ISO 19115:2014, renamed LICENCE.

Formal permission to do something (ISO 19115:2003 spelling).

INTELLECTUAL_PROPERTY_RIGHTS

@UML(identifier="intellectualPropertyRights",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction INTELLECTUAL_PROPERTY_RIGHTS

Rights to financial benefit from and control of distribution of non-tangible property that is a result of creativity.

RESTRICTED

@UML(identifier="restricted",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction RESTRICTED

Withheld from general circulation or disclosure.

OTHER_RESTRICTIONS

@UML(identifier="otherRestrictions",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction OTHER_RESTRICTIONS

Limitation not listed.

UNRESTRICTED

@UML(identifier="unrestricted",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction UNRESTRICTED

No constraints exist.

Since:

3.1

LICENCE_UNRESTRICTED

@UML(identifier="licenceUnrestricted",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction LICENCE_UNRESTRICTED

Formal permission not required to use the resource.

Since:

3.1

LICENCE_END_USER

@UML(identifier="licenceEndUser",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction LICENCE_END_USER

Formal permission required for a person or an entity to use the resource and that may differ from the person that orders or purchases it.

Since:

3.1

LICENCE_DISTRIBUTOR

@UML(identifier="licenceDistributor",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction LICENCE_DISTRIBUTOR

Formal permission required for a person or an entity to commercialize or distribute the resource.

Since:

3.1

PRIVATE

@UML(identifier="private",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction PRIVATE

Protects rights of individual or organisations from observation, intrusion, or attention of others.

Since:

3.1

STATUTORY

@UML(identifier="statutory",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction STATUTORY

Prescribed by law.

Since:

3.1

CONFIDENTIAL

@UML(identifier="confidential",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction CONFIDENTIAL

Not available to the public contains information that could be prejudicial to a commercial, industrial, or national interest.

Since:

3.1

SENSITIVE_BUT_UNCLASSIFIED

@UML(identifier="sensitiveButUnclassified",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction SENSITIVE_BUT_UNCLASSIFIED

Although unclassified, requires strict controls over its distribution.

Since:

3.1

IN_CONFIDENCE

@UML(identifier="in-confidence",
     obligation=CONDITIONAL,
     specification=ISO_19115)
public static final Restriction IN_CONFIDENCE

With trust.

Since:

3.1

Method Details

names

public String[] names()

Returns the programmatic name and the UML identifier of this code, together with legacy UML identifier if any. In particular, LICENCE is known as both "licence" (from ISO 19115:2014) and "license" (from ISO 19115:2003).

Returns:

Names of this code, including legacy names if any.

values

public static Restriction[] values()

Returns the list of Restrictions.

Returns:

the list of codes declared in the current JVM.

family

public Restriction[] family()

Returns the list of codes of the same kind as this code list element. Invoking this method is equivalent to invoking values(), except that this method can be invoked on an instance of the parent CodeList class.

Specified by:

family in interface ControlledVocabulary

Specified by:

family in class CodeList<Restriction>

Returns:

all code values for this code list.

valueOf

public static Restriction valueOf(String code)

Returns the restriction that matches the given string, or returns a new one if none match it. This methods returns the first instance (in declaration order) for which the name is equals, ignoring case, to the given name. If no existing instance is found, then a new one is created for the given name.

For compatibility reasons, the "LICENSE" string (derived from ISO 19115:2003) is taken as synonymous to "LICENCE" (derived from ISO 19115:2014).

Parameters:

code - the name of the code to fetch or to create.

Returns:

a code matching the given name.