Class LocatorImpl

  • All Implemented Interfaces:
    Locator

    public class LocatorImpl
    extends java.lang.Object
    implements Locator
    LocatorImpl
    • Constructor Summary

      Constructors 
      Constructor Description
      LocatorImpl​(java.util.Locale pLocale)
      Ctor.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      ServiceLocationEnumeration findAttributes​(ServiceType pType, java.util.Vector pScopes, java.util.Vector pAttributeIds)
      For the type and scope, return a Vector of all ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector regardless of the Locator's locale.
      ServiceLocationEnumeration findAttributes​(ServiceType pType, java.util.Vector pScopes, java.util.Vector pAttributeIds, java.util.Vector pDirectoryAgents)
      For the type and scope, return a Vector of all ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector regardless of the Locator's locale.
      ServiceLocationEnumeration findAttributes​(ServiceURL pURL, java.util.Vector pScopes, java.util.Vector pAttributeIds)
      For the URL and scope, return a Vector of ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector.
      ServiceLocationEnumeration findAttributes​(ServiceURL pURL, java.util.Vector pScopes, java.util.Vector pAttributeIds, java.util.Vector pDirectoryAgents)
      For the URL and scope, return a Vector of ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector.
      ServiceLocationEnumeration findServices​(ServiceType pType, java.util.Vector pScopes, java.lang.String pSearchFilter)
      Returns a vector of ServiceURL objects for services matching the query, and having a matching type in the given scopes.
      ServiceLocationEnumeration findServices​(ServiceType pType, java.util.Vector pScopes, java.lang.String pSearchFilter, java.util.Vector pDirectoryAgents)
      Returns a vector of ServiceURL objects for services matching the query, and having a matching type in the given scopes.
      ServiceLocationEnumeration findServiceTypes​(java.lang.String pNamingAuthority, java.util.Vector pScopes)
      Returns an enumeration of ServiceType objects giving known service types for the given scopes and given naming authority.
      ServiceLocationEnumeration findServiceTypes​(java.lang.String pNamingAuthority, java.util.Vector pScopes, java.util.Vector pDirectoryAgent)
      Returns an enumeration of ServiceType objects giving known service types for the given scopes and given naming authority.
      java.util.Locale getLocale()
      Return the language locale with which this object was created.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • LocatorImpl

        public LocatorImpl​(java.util.Locale pLocale)
        Ctor.
        Parameters:
        pLocale -
    • Method Detail

      • findAttributes

        public ServiceLocationEnumeration findAttributes​(ServiceURL pURL,
                                                         java.util.Vector pScopes,
                                                         java.util.Vector pAttributeIds)
        Description copied from interface: Locator
        For the URL and scope, return a Vector of ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector. The request is made in the language locale of the Locator. If no attributes match, an empty enumeration is returned.
        Specified by:
        findAttributes in interface Locator
        Parameters:
        pURL - The URL for which the attributes are desired.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        pAttributeIds - A Vector of String patterns identifying the desired attributes. An empty vector means return all attributes. As described in [7], the patterns may include wildcards to match substrings. The strings may include SLP reserved characters, they will be escaped by the API before transmission.
        Returns:
        The enumeration
      • findAttributes

        public ServiceLocationEnumeration findAttributes​(ServiceURL pURL,
                                                         java.util.Vector pScopes,
                                                         java.util.Vector pAttributeIds,
                                                         java.util.Vector pDirectoryAgents)
        Description copied from interface: Locator
        For the URL and scope, return a Vector of ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector. The request is made in the language locale of the Locator. If no attributes match, an empty enumeration is returned.

        This method is not part of the RFC 2614 interface definition.
        Specified by:
        findAttributes in interface Locator
        Parameters:
        pURL - The URL for which the attributes are desired.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        pAttributeIds - A Vector of String patterns identifying the desired attributes. An empty vector means return all attributes. As described in [7], the patterns may include wildcards to match substrings. The strings may include SLP reserved characters, they will be escaped by the API before transmission.
        pDirectoryAgents - A vector of InetAddress that specify the directory agents to look for.
        Returns:
        The enumeration
      • findAttributes

        public ServiceLocationEnumeration findAttributes​(ServiceType pType,
                                                         java.util.Vector pScopes,
                                                         java.util.Vector pAttributeIds)
        Description copied from interface: Locator
        For the type and scope, return a Vector of all ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector regardless of the Locator's locale. The request is made independent of language locale. If no attributes are found, an empty vector is returned.
        Specified by:
        findAttributes in interface Locator
        Parameters:
        pType - The service type.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        pAttributeIds - A Vector of String patterns identifying the desired attributes. An empty vector means return all attributes. As described in [7], the patterns may include wildcards to match all prefixes or suffixes. The patterns may include SLP reserved characters, they will be escaped by the API before transmission.
        Returns:
        The enumeration
      • findAttributes

        public ServiceLocationEnumeration findAttributes​(ServiceType pType,
                                                         java.util.Vector pScopes,
                                                         java.util.Vector pAttributeIds,
                                                         java.util.Vector pDirectoryAgents)
        Description copied from interface: Locator
        For the type and scope, return a Vector of all ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector regardless of the Locator's locale. The request is made independent of language locale. If no attributes are found, an empty vector is returned.

        This method is not part of the RFC 2614 interface definition.
        Specified by:
        findAttributes in interface Locator
        Parameters:
        pType - The service type.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        pAttributeIds - A Vector of String patterns identifying the desired attributes. An empty vector means return all attributes. As described in [7], the patterns may include wildcards to match all prefixes or suffixes. The patterns may include SLP reserved characters, they will be escaped by the API before transmission.
        pDirectoryAgents - A vector of InetAddress that specify the directory agents to look for.
        Returns:
        The enumeration
      • findServiceTypes

        public ServiceLocationEnumeration findServiceTypes​(java.lang.String pNamingAuthority,
                                                           java.util.Vector pScopes)
        Description copied from interface: Locator
        Returns an enumeration of ServiceType objects giving known service types for the given scopes and given naming authority. If no service types are found, an empty enumeration is returned.
        Specified by:
        findServiceTypes in interface Locator
        Parameters:
        pNamingAuthority - The naming authority. Use "" for the default naming authority and "*" for all naming authorities.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        Returns:
        The enumeration
      • findServiceTypes

        public ServiceLocationEnumeration findServiceTypes​(java.lang.String pNamingAuthority,
                                                           java.util.Vector pScopes,
                                                           java.util.Vector pDirectoryAgent)
        Description copied from interface: Locator
        Returns an enumeration of ServiceType objects giving known service types for the given scopes and given naming authority. If no service types are found, an empty enumeration is returned.

        This method is not part of the RFC 2614 interface definition.
        Specified by:
        findServiceTypes in interface Locator
        Parameters:
        pNamingAuthority - The naming authority. Use "" for the default naming authority and "*" for all naming authorities.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        pDirectoryAgent - A vector of InetAddress that specify the directory agents to look for.
        Returns:
        The enumeration
      • findServices

        public ServiceLocationEnumeration findServices​(ServiceType pType,
                                                       java.util.Vector pScopes,
                                                       java.lang.String pSearchFilter)
        Description copied from interface: Locator
        Returns a vector of ServiceURL objects for services matching the query, and having a matching type in the given scopes. If no services are found, an empty enumeration is returned.
        Specified by:
        findServices in interface Locator
        Parameters:
        pType - The SLP service type of the service.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        pSearchFilter - An LDAPv3 [4] string encoded query. If the filter is empty, i.e. "", all services of the requested type in the specified scopes are returned. SLP reserved characters must be escaped in the query. Use ServiceLocationAttribute.escapeId() and ServiceLocationAttribute.escapeValue() to construct the query.
        Returns:
        The enumeration
      • findServices

        public ServiceLocationEnumeration findServices​(ServiceType pType,
                                                       java.util.Vector pScopes,
                                                       java.lang.String pSearchFilter,
                                                       java.util.Vector pDirectoryAgents)
        Description copied from interface: Locator
        Returns a vector of ServiceURL objects for services matching the query, and having a matching type in the given scopes. If no services are found, an empty enumeration is returned.

        This method is not part of the RFC 2614 interface definition.
        Specified by:
        findServices in interface Locator
        Parameters:
        pType - The SLP service type of the service.
        pScopes - A Vector of scope names. The vector should be selected from the results of a findScopes() API invocation. Use "DEFAULT" for the default scope.
        pSearchFilter - An LDAPv3 [4] string encoded query. If the filter is empty, i.e. "", all services of the requested type in the specified scopes are returned. SLP reserved characters must be escaped in the query. Use ServiceLocationAttribute.escapeId() and ServiceLocationAttribute.escapeValue() to construct the query.
        pDirectoryAgents - A vector of InetAddress that specify the directory agents to look for.
        Returns:
        The enumeration
      • getLocale

        public java.util.Locale getLocale()
        Description copied from interface: Locator
        Return the language locale with which this object was created.
        Specified by:
        getLocale in interface Locator
        Returns:
        The locale