Package org.apache.sis.metadata.iso.citation

Class DefaultOnlineResource

java.lang.Object
org.apache.sis.metadata.AbstractMetadata
org.apache.sis.metadata.ModifiableMetadata
org.apache.sis.metadata.iso.ISOMetadata
org.apache.sis.metadata.iso.citation.DefaultOnlineResource
All Implemented Interfaces:
Serializable, Emptiable, LenientComparable, IdentifiedObject, org.opengis.metadata.citation.OnlineResource
public class DefaultOnlineResource extends ISOMetadata implements org.opengis.metadata.citation.OnlineResource
Information about on-line sources from which the dataset, specification, or community profile name and extended metadata elements can be obtained. The following property is mandatory in a well-formed metadata according ISO 19115:
CI_OnlineResource   └─linkage……………… Location (address) for on-line access using a Uniform Resource Locator address or similar addressing scheme.

Limitations

  • Instances of this class are not synchronized for multi-threading. Synchronization, if needed, is caller's responsibility.
  • Serialized objects of this class are not guaranteed to be compatible with future Apache SIS releases. Serialization support is appropriate for short term storage or RMI between applications running the same version of Apache SIS. For long term storage, use XML instead.
Since:
0.3
Version:
1.0
See Also:

  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      Serial number for inter-operability with different versions.
      See Also:

    • linkage

      private URI linkage
      Location (address) for on-line access using a Uniform Resource Locator address or similar addressing scheme such as "http://www.statkart.no/isotc211".

    • protocol

      private String protocol
      The connection protocol to be used.

    • applicationProfile

      private String applicationProfile
      Name of an application profile that can be used with the online resource.

    • name

      private String name
      Name of the online resources.

    • description

      private org.opengis.util.InternationalString description
      Detailed text description of what the online resource is/does.

    • function

      private org.opengis.metadata.citation.OnLineFunction function
      Code for function performed by the online resource.

    • protocolRequest

      private String protocolRequest
      Request used to access the resource depending on the protocol. This is used mainly for POST requests.

  • Constructor Details

    • DefaultOnlineResource

      public DefaultOnlineResource()
      Creates an initially empty on line resource.

    • DefaultOnlineResource

      public DefaultOnlineResource(URI linkage)
      Creates an on line resource initialized to the given URI.
      Parameters:
      linkage - the location for on-line access using a Uniform Resource Locator address, or null if none.

    • DefaultOnlineResource

      public DefaultOnlineResource(org.opengis.metadata.citation.OnlineResource object)
      Constructs a new instance initialized with the values from the specified metadata object. This is a shallow copy constructor, because the other metadata contained in the given object are not recursively copied.
      Parameters:
      object - the metadata to copy values from, or null if none.
      See Also:

  • Method Details

    • castOrCopy

      public static DefaultOnlineResource castOrCopy(org.opengis.metadata.citation.OnlineResource object)
      Returns a SIS metadata implementation with the values of the given arbitrary implementation. This method performs the first applicable action in the following choices:
      • If the given object is null, then this method returns null.
      • Otherwise if the given object is already an instance of DefaultOnlineResource, then it is returned unchanged.
      • Otherwise a new DefaultOnlineResource instance is created using the copy constructor and returned. Note that this is a shallow copy operation, because the other metadata contained in the given object are not recursively copied.
      Parameters:
      object - the object to get as a SIS implementation, or null if none.
      Returns:
      a SIS implementation containing the values of the given object (may be the given object itself), or null if the argument was null.

    • getApplicationProfile

      public String getApplicationProfile()
      Returns the name of an application profile that can be used with the online resource. Returns null if none.
      Specified by:
      getApplicationProfile in interface org.opengis.metadata.citation.OnlineResource
      Returns:
      application profile that can be used with the online resource, or null.

    • setApplicationProfile

      public void setApplicationProfile(String newValue)
      Sets the name of an application profile that can be used with the online resource.
      Parameters:
      newValue - the new application profile.

    • getName

      public String getName()
      Name of the online resource. Returns null if none.
      Upcoming API change — internationalization
      The return type may be changed from String to InternationalString in GeoAPI 4.0.
      Specified by:
      getName in interface org.opengis.metadata.citation.OnlineResource
      Returns:
      name of the online resource, or null.

    • setName

      public void setName(String newValue)
      Sets the name of the online resource.
      Upcoming API change — internationalization
      The argument type may be changed from String to InternationalString in GeoAPI 4.0.
      Parameters:
      newValue - the new name, or null if none.

    • getDescription

      public org.opengis.util.InternationalString getDescription()
      Returns the detailed text description of what the online resource is/does.
      Specified by:
      getDescription in interface org.opengis.metadata.citation.OnlineResource
      Returns:
      text description of what the online resource is/does, or null.

    • setDescription

      public void setDescription(org.opengis.util.InternationalString newValue)
      Sets the detailed text description of what the online resource is/does.
      Parameters:
      newValue - the new description, or null if none.

    • getFunction

      public org.opengis.metadata.citation.OnLineFunction getFunction()
      Returns the code for function performed by the online resource.
      Specified by:
      getFunction in interface org.opengis.metadata.citation.OnlineResource
      Returns:
      function performed by the online resource, or null.

    • setFunction

      public void setFunction(org.opengis.metadata.citation.OnLineFunction newValue)
      Sets the code for function performed by the online resource.
      Parameters:
      newValue - the new function, or null if none.

    • getLinkage

      public URI getLinkage()
      Returns the location (address) for on-line access using a Uniform Resource Locator address or similar addressing scheme.
      Specified by:
      getLinkage in interface org.opengis.metadata.citation.OnlineResource
      Returns:
      location for on-line access using a Uniform Resource Locator address or similar scheme, or null.

    • setLinkage

      public void setLinkage(URI newValue)
      Sets the location (address) for on-line access using a Uniform Resource Locator address or similar addressing scheme such as "http://www.statkart.no/isotc211".
      Parameters:
      newValue - the new linkage, or null if none.

    • getProtocol

      public String getProtocol()
      Returns the connection protocol to be used.
      Example: ftp, http get KVP, http POST, etc.
      Specified by:
      getProtocol in interface org.opengis.metadata.citation.OnlineResource
      Returns:
      connection protocol to be used, or null.

    • setProtocol

      public void setProtocol(String newValue)
      Sets the connection protocol to be used.
      Parameters:
      newValue - the new protocol, or null if none.

    • getProtocolRequest

      @UML(identifier="protocolRequest", obligation=OPTIONAL, specification=ISO_19115) public String getProtocolRequest()
      Returns the request used to access the resource depending on the protocol. This is used mainly for POST requests.
      Example:
      Returns:
      Request used to access the resource.
      Since:
      0.5

    • setProtocolRequest

      public void setProtocolRequest(String newValue)
      Sets the request to be used.
      Parameters:
      newValue - the new request, or null if none.
      Since:
      0.5