de.fhg.igd.atlas.core
Interface LSServerService

All Known Implementing Classes:

LSServerServiceImpl

public interface LSServerService

Defines the interface to a LSServerService implementation. The LSServerService provides the functionality of the Location Server Server (LSServer) which can store location entries of mobile agents in its internal storage database.

Version:

"$Id: LSServerService.java 1913 2007-08-08 02:41:53Z jpeters $"

Author:

Jan Peters

See Also:

LSServer, StorageDB

Method Summary

LSPReply	lookup(LSPLookup request) Handles the given lookup request (see LSPLookup).
LSPReply	refresh(LSPRefresh request) Handles the given refresh request (see LSPRefresh).
LSPReply	registerEncoded(LSPRegisterEncoded request) Handles the given register encoded request (see LSPRegisterEncoded).
LSPReply	registerEncrypted(LSPRegisterEncrypted request) Handles the given register encrypted request (see LSPRegisterEncrypted).
LSPReply	registerPlain(LSPRegisterPlain request) Handles the given register plain request (see LSPRegisterPlain).

Method Detail

lookup

public LSPReply lookup(LSPLookup request)

Handles the given lookup request (see LSPLookup). Following reply states and bodies are possible (see LSPReply):

• ACKNOWLEDGE (LSPLookupResult body)
• IMPLICIT_NAME_NOT_FOUND (no body)

Parameters:

request - The lookup request.

Returns:

The reply to the given request.

registerPlain

public LSPReply registerPlain(LSPRegisterPlain request)

Handles the given register plain request (see LSPRegisterPlain). Following reply states are possible (see LSPReply):

• ACKNOWLEDGE
• REQUEST_BODY_INVALID
• CONTACT_ADDRESS_NOT_EXISTENT
• COOKIE_INVALID
• IMPLICIT_NAME_NOT_PRESENT

Parameters:

request - The register plain request.

Returns:

The reply to the given request.

registerEncrypted

public LSPReply registerEncrypted(LSPRegisterEncrypted request)

Handles the given register encrypted request (see LSPRegisterEncrypted). Following reply states are possible (see LSPReply):

• ACKNOWLEDGE
• REQUEST_BODY_INVALID
• CONTACT_ADDRESS_NOT_EXISTENT
• COOKIE_INVALID
• IMPLICIT_NAME_NOT_PRESENT
• ENCRYPTING_NOT_SUPPORTED
• ENCRYPTED_DATA_INVALID

Parameters:

request - The register encrypted request.

Returns:

The reply to the given request.

registerEncoded

public LSPReply registerEncoded(LSPRegisterEncoded request)

Handles the given register encoded request (see LSPRegisterEncoded). Following reply states are possible (see LSPReply):

• ACKNOWLEDGE
• REQUEST_BODY_INVALID
• CONTACT_ADDRESS_NOT_EXISTENT
• COOKIE_INVALID
• IMPLICIT_NAME_NOT_PRESENT
• ENCODED_NOT_SUPPORTED
• ENCODED_DATA_INVALID

Parameters:

request - The register encoded request.

Returns:

The reply to the given request.

refresh

public LSPReply refresh(LSPRefresh request)

Handles the given refresh request (see LSPRefresh). Following reply states and bodies are possible (see LSPReply):

• ACKNOWLEDGE (no body)
• SOME_IMPLICIT_NAMES_NOT_PRESENT (LSPRefreshResult body)

Parameters:

request - The refresh request.

Returns:

The reply to the given request.