Package net.ontopia.infoset.core

Interface LocatorIF

All Known Subinterfaces:
MLocator
All Known Implementing Classes:
AbstractLocator, DataTypeLocator, GenericLocator, RDBMSLocator, SourceLocator, SubjectIndicatorLocator, SubjectLocator, URIFragmentLocator, URILocator
public interface LocatorIF
PUBLIC: Locators that refer to resources. Implementations of this interface must implement the toString(), equals() and hashCode() methods. Note that the result of toString() must include not just the locator itself but also the notation name. Implementations should always be immutable.

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    getAddress()
    PUBLIC: Returns the locator address in absolute and normalized form.
    String
    getExternalForm()
    PUBLIC: Returns the address of the locator in external form; that is, with special characters that need to be escaped escaped using the escape syntax of the locator notation.
    String
    getNotation()
    PUBLIC: Gets the locator notation.
    LocatorIF
    resolveAbsolute(String address)
    PUBLIC: Given a locator address string that is relative to this locator, return an absolute locator.

  • Method Details

    • getNotation

      String getNotation()
      PUBLIC: Gets the locator notation. The default notation is URI. Ontopia will never use notation names which begin with 'x-'. Notation names are case-insensitive.

      Note that only the URI notation is supported in release OKS 4.0 and newer.

    • getAddress

      String getAddress()
      PUBLIC: Returns the locator address in absolute and normalized form. Whether addresses are case-sensitive or not depends on the locator notation.

    • resolveAbsolute

      LocatorIF resolveAbsolute(String address)
      PUBLIC: Given a locator address string that is relative to this locator, return an absolute locator. If the input locator address is absolute the returned locator object will simply contain that absolute locator address.

    • getExternalForm

      String getExternalForm()
      PUBLIC: Returns the address of the locator in external form; that is, with special characters that need to be escaped escaped using the escape syntax of the locator notation.
      Since:
      2.0.3