com.ibm.itim.remoteservices.provider
Interface PlatformContext

All Known Implementing Classes:

InitialPlatformContext

public interface PlatformContext

Interface to retrieve provisioning platform context information, such as a directory naming context for retrieving directory entries. This interface is used for asynchronous communication and event notification by protocol implementers wishing to call back into the TIM system.

An instance of a class implementing this interface should be obtained from the class InitialPlatformContext. A protocol implementer should obtain an instance of a class implementing this interface and then use it to complete processing of the asynchronous request or unsolicited event.

See Also:

Notifier, DirContext, InitialPlatformContext

Method Summary

javax.naming.directory.DirContext	getDirectoryContext() Deprecated. See UnsolicitedNotificationHandler.findService().
Notifier	getNotifier() Retrieves a new Notifier for notifying the platform or request responses.
UnsolicitedEventProcessor	getUnsolicitedEventProcessor() Retrieves a new UnsolicitedEventProcessor for processing unsolicited notification request.
void	setSubject(javax.security.auth.Subject subject) After authenticating with a loginContext the client should set the subject to allow for authentication.

Method Detail

getNotifier

public Notifier getNotifier()
                     throws RemoteServicesException

Retrieves a new Notifier for notifying the platform or request responses.

Returns:

new Notifier instance.

Throws:

RemoteServicesException - on error

getUnsolicitedEventProcessor

public UnsolicitedEventProcessor getUnsolicitedEventProcessor()
                                                       throws RemoteServicesException

Retrieves a new UnsolicitedEventProcessor for processing unsolicited notification request.

Returns:

A new instance of UnsolicitedEventProcessor

Throws:

RemoteServicesException - on error

getDirectoryContext

public javax.naming.directory.DirContext getDirectoryContext()
                                                      throws javax.naming.NamingException

Deprecated. See UnsolicitedNotificationHandler.findService().

Retrieves a new directory naming context that can be used to query the platform's data store.

Returns:

new DirContext instance.

Throws:

javax.naming.NamingException - thrown if unable to create the DirContext.

setSubject

public void setSubject(javax.security.auth.Subject subject)

After authenticating with a loginContext the client should set the subject to allow for authentication.

Parameters:

subject -