org.sblim.slp
Interface Locator
- LocatorImpl
The Locator is the UA interface, allowing clients to query the SLP framework
about existing service types, services instances, and about the attributes of
an existing service instance or service type. Queries for services and
attributes are made in the locale with which the Locator was created, queries
for service types are independent of locale.
abstract ServiceLocationEnumeration | findAttributes(ServiceType pType, 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.
|
abstract ServiceLocationEnumeration | findAttributes(ServiceType pType, Vector pScopes, Vector pAttributeIds, 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.
|
abstract ServiceLocationEnumeration | findAttributes(ServiceURL URL, Vector scopes, Vector attributeIds) - For the URL and scope, return a Vector of ServiceLocationAttribute
objects whose ids match the String patterns in the attributeIds Vector.
|
abstract ServiceLocationEnumeration | findAttributes(ServiceURL pURL, Vector pScopes, Vector pAttributeIds, Vector pDirectoryAgents) - For the URL and scope, return a Vector of ServiceLocationAttribute
objects whose ids match the String patterns in the attributeIds Vector.
|
abstract ServiceLocationEnumeration | findServiceTypes(String pNamingAuthority, Vector pScopes) - Returns an enumeration of ServiceType objects giving known service types
for the given scopes and given naming authority.
|
abstract 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.
|
abstract ServiceLocationEnumeration | findServices(ServiceType pType, Vector pScopes, String pSearchFilter) - Returns a vector of ServiceURL objects for services matching the query,
and having a matching type in the given scopes.
|
abstract ServiceLocationEnumeration | findServices(ServiceType pType, Vector pScopes, String pSearchFilter, Vector pDirectoryAgents) - Returns a vector of ServiceURL objects for services matching the query,
and having a matching type in the given scopes.
|
abstract Locale | getLocale() - Return the language locale with which this object was created.
|
findAttributes
public abstract ServiceLocationEnumeration findAttributes(ServiceType pType,
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.
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.
findAttributes
public abstract ServiceLocationEnumeration findAttributes(ServiceType pType,
Vector pScopes,
Vector pAttributeIds,
Vector pDirectoryAgents)
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.
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.
findAttributes
public abstract ServiceLocationEnumeration findAttributes(ServiceURL URL,
Vector scopes,
Vector attributeIds)
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.
URL
- The URL for which the attributes are desired.scopes
- A Vector of scope names. The vector should be selected from
the results of a findScopes() API invocation. Use "DEFAULT"
for the default scope.attributeIds
- 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.
findAttributes
public abstract ServiceLocationEnumeration findAttributes(ServiceURL pURL,
Vector pScopes,
Vector pAttributeIds,
Vector pDirectoryAgents)
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.
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.
findServiceTypes
public abstract 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.
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.
findServiceTypes
public abstract 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.
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.
findServices
public abstract ServiceLocationEnumeration findServices(ServiceType pType,
Vector pScopes,
String pSearchFilter)
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.
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.
findServices
public abstract ServiceLocationEnumeration findServices(ServiceType pType,
Vector pScopes,
String pSearchFilter,
Vector pDirectoryAgents)
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.
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.
getLocale
public abstract Locale getLocale()
Return the language locale with which this object was created.
Copyright © 2005, 2009 IBM Corporation. All Rights Reserved.