edu.wisc.trace.uch
Interface ITAListener

All Known Implementing Classes:

TargetListener

public interface ITAListener

ITAListener forwards call of the methods from TA to the relative UIPM.

Version:

$Revision: 1.11 $

Author:

Parikshit Thakur & Team, Trace R&D Center

Method Summary

void	abortSession(String sessionId) The TA has terminated a session, the TA will have no knowledge about that session.
String	getDocument(String uri, String postData) Get specified document through HTTP GET or POST.
String	getIpAddress() Get the IP address of the UCH.
IUCHStore	getLocalUCHStore() Gets an Object of LocalUCHStore.
List<Map<String,Object>>	getResources(String sessionId, List<Map<String,String>> resProps) Get resource from the UCH specified by Resource Properties.
Map<String,String>	getUCHProps() Get a Map or UCH Properties.
boolean	isImplemented(String functionName) Return whether specified function is implemented or not.
void	sessionForwardRequest(String sessionId, Map<String,String> forwardInfo) The TA requests the client to open a session with different socket.
boolean	setValidation(ITA ta, boolean activate) Check whether to do validation for the TA or not.
String	startUriService(ITA ta, String scheme, int port, boolean portIsFlexible, String basePath, boolean basePathIsFlexible) The ITA requests the UCH to start servicing a URI which is made up of a given scheme, port, and base path.
void	stopUriService(String uri) The ITA requests the UCH to stop servicing a URI that was requested to be serviced in a previous call to startUriService().
void	updateDynRes(List<String> sessionIds, List<String> eltIds) Signals that the set of atomic resources pertaining to a specific socket element has changed.
void	updateValues(List<String> sessionIds, List<String> paths, List<String> operations, List<String> values, List<Boolean> hasDynRes) The TA signals a change in the target’s status, affecting one or more sessions.

Method Detail

sessionForwardRequest

void sessionForwardRequest(String sessionId,
                           Map<String,String> forwardInfo)

The TA requests the client to open a session with different socket.

Parameters:

sessionId - a String value of sessionId

forwardInfo - Map<String, String>

abortSession

void abortSession(String sessionId)

The TA has terminated a session, the TA will have no knowledge about that session.

Parameters:

sessionId - a String value of sessionId

updateValues

void updateValues(List<String> sessionIds,
                  List<String> paths,
                  List<String> operations,
                  List<String> values,
                  List<Boolean> hasDynRes)

The TA signals a change in the target’s status, affecting one or more sessions.

Parameters:

sessionIds - a List<String> of sessionIds

paths - a List<String> of paths

operations - a List<String> of operations

values - a List<String> of values

hasDynRes - a List<Boolean> of hasDynRes

updateDynRes

void updateDynRes(List<String> sessionIds,
                  List<String> eltIds)

Signals that the set of atomic resources pertaining to a specific socket element has changed.

Parameters:

sessionIds - a List<String> of sessionIds

eltIds - a List<String> of elementIds

setValidation

boolean setValidation(ITA ta,
                      boolean activate)

Check whether to do validation for the TA or not.

Parameters:

ta - an Object of ITA

activate - a boolean value of activate

Returns:

boolean whether to do validation for the TA or not

getLocalUCHStore

IUCHStore getLocalUCHStore()

Gets an Object of LocalUCHStore.

Returns:

an Object of IUCHStore

startUriService

String startUriService(ITA ta,
                       String scheme,
                       int port,
                       boolean portIsFlexible,
                       String basePath,
                       boolean basePathIsFlexible)
                       throws UCHException

The ITA requests the UCH to start servicing a URI which is made up of a given scheme, port, and base path. If successful, the UCH will forward all messages that have this URI as its base, to controllerRequest().

Parameters:

ta - an ITA object

scheme - a String value of schema

port - a port no

portIsFlexible - a boolean value

basePath - a String value of basePath

basePathIsFlexible - a boolean value

Returns:

a String value of URI

Throws:

UCHException

stopUriService

void stopUriService(String uri)
                    throws UCHException

The ITA requests the UCH to stop servicing a URI that was requested to be serviced in a previous call to startUriService().

Parameters:

uri - a String value of URI

Throws:

UCHException

getIpAddress

String getIpAddress()

Get the IP address of the UCH.

Returns:

return a string value

getResources

List<Map<String,Object>> getResources(String sessionId,
                                      List<Map<String,String>> resProps)

Get resource from the UCH specified by Resource Properties.

Parameters:

sessionId - a String value of sessionId

resProps - a List<Map<String, String>> of Resource Properties

Returns:

a List<Map<String, Object>> value

getDocument

String getDocument(String uri,
                   String postData)
                   throws UCHException

Get specified document through HTTP GET or POST.

Parameters:

uri - a String value of URI

postData - a String value of postData

Returns:

a String value of requested Document

Throws:

UCHException

getUCHProps

Map<String,String> getUCHProps()

Get a Map or UCH Properties.

Returns:

an object of Map<String, String> or UCH Properties

isImplemented

boolean isImplemented(String functionName)

Return whether specified function is implemented or not.

Parameters:

functionName - a String value of function Name

Returns:

whether the function is implemented or not