com.ibm.portal.resolver.service
Interface PortalPocServiceHome

public interface PortalPocServiceHome

Home interface that can be looked up in JNDI and that provides access to the POC services from the context of a portal request.
Example:

      PortalPocServiceHome psh;
      javax.naming.Context ctx = new javax.naming.InitialContext();
      try {
           psh = (PortalPocServiceHome) 
              ctx.lookup("portal:service/resolver/PocService");
      } catch(javax.naming.NameNotFoundException ex) {
           ... error handling ...
      }
      ...
      // request the service via the home interface
      PortalPocService service = psh.getPortalPocService(request, response);
      ...
      service.dispose();
 
 

Since:

6.0.1

Field Summary

static java.lang.String	ATTR_CLASS name of the class attribute used for instantiation
static java.lang.String	DEFAULT_EXTENSION_ID ID of the default implementation of the PortalPocServiceHome
static java.lang.String	EXTENSION_POINT_ID ID of the PortalPocServiceHome extension point
static java.lang.String	JNDI_NAME JNDI name of this service

Method Summary

PortalPocService

getPortalPocService(HttpServletRequest request, HttpServletResponse response) Returns a PortalPocService instance which is valid within the scope of one request.

Field Detail

JNDI_NAME

static final java.lang.String JNDI_NAME

JNDI name of this service

See Also:

Constant Field Values

EXTENSION_POINT_ID

static final java.lang.String EXTENSION_POINT_ID

ID of the PortalPocServiceHome extension point

See Also:

Constant Field Values

DEFAULT_EXTENSION_ID

static final java.lang.String DEFAULT_EXTENSION_ID

ID of the default implementation of the PortalPocServiceHome

See Also:

Constant Field Values

ATTR_CLASS

static final java.lang.String ATTR_CLASS

name of the class attribute used for instantiation

See Also:

Constant Field Values

Method Detail

getPortalPocService

PortalPocService getPortalPocService(HttpServletRequest request,
                                     HttpServletResponse response)
                                     throws StateManagerException

Returns a PortalPocService instance which is valid within the scope of one request. Storing the instance across requests causes errors. Make sure to call Disposable.dispose() on the PortalPocService instance before it leaves scope.

Parameters:

request - The current portal servlet request. Must not be null.

response - The current portal servlet response. Must not be null.

Returns:

A configured PortalPocService instance. Not null.

Throws:

StateManagerException - In case that the service cannot be retrieved.