org.sblim.slp.internal

Class LocatorImpl

Implemented Interfaces:
Locator

public class LocatorImpl
extends java.lang.Object
implements Locator

The class LocatorImpl implements the Locator interface as defined by RFC 3224

Method Summary

ServiceLocationEnumeration
findAttributes(ServiceType pServiceType, Vector pScopes, 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, Vector pScopes, Vector pAttributeIds, Vector directoryAgents)
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 pServiceUrl, Vector pScopes, 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, Vector pScopes, Vector pAttributeIds, Vector directoryAgents)
For the URL and scope, return a Vector of ServiceLocationAttribute objects whose ids match the String patterns in the attributeIds Vector.
ServiceLocationEnumeration
findServiceTypes(String pNamingAuthority, Vector pScopes)
Returns an enumeration of ServiceType objects giving known service types for the given scopes and given naming authority.
ServiceLocationEnumeration
findServiceTypes(String pNamingAuthority, Vector pScopes, Vector pDirectoryAgent)
Returns an enumeration of ServiceType objects giving known service types for the given scopes and given naming authority.
ServiceLocationEnumeration
findServices(ServiceType pServicetype, Vector pScopes, String pQuery)
Returns a vector of ServiceURL objects for services matching the query, and having a matching type in the given scopes.
ServiceLocationEnumeration
findServices(ServiceType pServicetype, Vector pScopes, String pQuery, Vector pDiscoveryAgents)
Returns a vector of ServiceURL objects for services matching the query, and having a matching type in the given scopes.
Locale
getLocale()
Return the language locale with which this object was created.

Method Details

findAttributes

public ServiceLocationEnumeration findAttributes(ServiceType pServiceType,
                                                 Vector pScopes,
                                                 Vector pAttributeIds)
            throws ServiceLocationException
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:
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,
                                                 Vector pScopes,
                                                 Vector pAttributeIds,
                                                 Vector directoryAgents)
            throws ServiceLocationException
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.
Returns:
The enumeration

findAttributes

public ServiceLocationEnumeration findAttributes(ServiceURL pServiceUrl,
                                                 Vector pScopes,
                                                 Vector pAttributeIds)
            throws ServiceLocationException
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:
Returns:
The enumeration

findAttributes

public ServiceLocationEnumeration findAttributes(ServiceURL pURL,
                                                 Vector pScopes,
                                                 Vector pAttributeIds,
                                                 Vector directoryAgents)
            throws ServiceLocationException
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.
Returns:
The enumeration

findServiceTypes

public ServiceLocationEnumeration findServiceTypes(String pNamingAuthority,
                                                   Vector pScopes)
            throws ServiceLocationException
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(String pNamingAuthority,
                                                   Vector pScopes,
                                                   Vector pDirectoryAgent)
            throws ServiceLocationException
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 pServicetype,
                                               Vector pScopes,
                                               String pQuery)
            throws ServiceLocationException
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:
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

findServices

public ServiceLocationEnumeration findServices(ServiceType pServicetype,
                                               Vector pScopes,
                                               String pQuery,
                                               Vector pDiscoveryAgents)
            throws ServiceLocationException
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:
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

getLocale

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

Copyright © 2005, 2006 IBM Corporation. All Rights Reserved.