net.jxta.resolver
Interface ResolverService

All Superinterfaces:

GenericResolver, Module, Service

public interface ResolverService

extends Service, GenericResolver

ResolverService Service provides a generic mechanism for jxta Services to send "Queries", and receive "Responses". It removes the burden for registered handlers in deal with :

• Setting message tags, to ensure uniqueness of tags and ensures that messages are sent to the correct address, and group

• Authentication, and Verification of credentials

• drop rogue messages

The ResolverService does not proccess the queries, nor does it not compose reponses. Handling of queries, and composition of responses are left up to the registered handlers. Services that wish to handle queries, and generate reponses must implement QueryHandler

Message Format :

A Query message <?xml version="1.0" standalone='yes'?> <ResolverQuery> <handlername> name </handlername> <credentialServiecUri> uri </credentialServiecUri> <credentialToken> token </credentialToken> <srcpeerid> srcpeerid </srcpeerid> <queryid> id </queryid> <query> query </query> </ResolverQuery> Note: queryid is unique to the originating node only, it can be utilized to match queries to responses. A Response Message <?xml version="1.0" standalone='yes'?> <ResolverResponse> <handlername> name </handlername> <credentialServiecUri> uri </credentialServiecUri> <credentialToken> token </credentialToken> <queryid> id </queryid> <response> response </response> </ResolverResponse> Note: queryid is unique to the originating node only, it can be utilized to match queries to responses

Since:

JXTA 1.0

See Also:

Service, GenericResolver, QueryHandler, ResolverQueryMsg, ResolverResponseMsg

Method Summary

QueryHandler	registerHandler(java.lang.String name, QueryHandler handler) Registers a given ResolveHandler.
QueryHandler	unregisterHandler(java.lang.String name) unregisters a given ResolveHandler.

Methods inherited from interface net.jxta.service.Service

getImplAdvertisement, getInterface

Methods inherited from interface net.jxta.platform.Module

init, startApp, stopApp

Methods inherited from interface net.jxta.resolver.GenericResolver

sendQuery, sendResponse

Method Detail

registerHandler

public QueryHandler registerHandler(java.lang.String name,
                                    QueryHandler handler)

Registers a given ResolveHandler.

Parameters:

name - The name under which this handler is to be registered.

handler - The handler.

Returns:

The previous handler registered under this name

Since:

JXTA 1.0

unregisterHandler

public QueryHandler unregisterHandler(java.lang.String name)

unregisters a given ResolveHandler.

Parameters:

name - The name of the handler to unregister.

Returns:

The previous handler registered under this name

Since:

JXTA 1.0