retrieveContext(Object) method

This method may be used to retrieve an already-created context from the local environment.

Syntax

SecContext retrieveContext ( Object environmentObject ) throws SecException

Parameters

environmentObject – The object that is provided to aid in retrieving the stored SecContext object.

Returns

the stored SecContext object

Exceptions

SecException class – if no stored SecContext object was found

Usage

This operation may require the inclusion of some environment data from the local environment. For example, in a servlet it might require the HttpServletRequest object whereas in an EJB implementation it might require the EJBContext object. Other situations may not require any environment object at all.