com.ibm.portal.resolver.service
Interface CorPocServiceHome

All Superinterfaces:
CacheFactory, ContentHandlerURIParserFactory, PocServiceHome, PocURIFactory, PooledTransformerFactory

public interface CorPocServiceHome
extends PocServiceHome

Home interface to instantiate PocService in the scope of a COR Context. Example:

      CorPocServiceHome psh;
      javax.naming.Context ctx = new javax.naming.InitialContext();
      try {
           psh = (CorPocServiceHome) 
              ctx.lookup(CorPocServiceHome.JNDI_NAME);
      } catch(javax.naming.NameNotFoundException ex) {
           ... error handling ...
      }
      ...
      // request the service via the home interface
      PocService service = psh.getCorPocService(context);
      ...
      service.dispose();
 
 

Since:
8.0.0

Nested Class Summary
 
Nested classes/interfaces inherited from interface com.ibm.portal.resolver.service.PocServiceHome
PocServiceHome.FilterType
 
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 CorPocServiceHome
static java.lang.String EXTENSION_POINT_ID
          ID of the CorPocServiceHome extension point
static java.lang.String JNDI_NAME
          JNDI name of this service
 
Fields inherited from interface com.ibm.portal.resolver.service.PocServiceHome
CACHED, UNCACHED
 
Method Summary
 PocService getCorPocService(Context ctx)
          Returns a PocService instance which is valid within the scope of one COR context.
 
Methods inherited from interface com.ibm.portal.resolver.service.PocServiceHome
convert, convert, createDigestURI, createDigestURI, createURI, createURI, createURI, getContext, getDataSinkFactory, getDataSinkFactory, getDataSourceFactory, getFileTypeMap, getIdentityTemplates, getInvalidationEventListener, getLookupService, getObjectPoolFactory, getResolutionService, newFilter
 
Methods inherited from interface com.ibm.portal.resolver.xml.PooledTransformerFactory
newPooledTemplates, newPooledTemplates, newPooledTemplates
 
Methods inherited from interface com.ibm.portal.resolver.xml.ContentHandlerURIParserFactory
createContentHandlerURIParser
 
Methods inherited from interface com.ibm.portal.resolver.cache.CacheFactory
getCachedDataSourceFactory, getCachedDataSourceFactory
 

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 CorPocServiceHome 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 CorPocServiceHome

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

getCorPocService

PocService getCorPocService(Context ctx)
                            throws StateManagerException
Returns a PocService instance which is valid within the scope of one COR context. Storing the instance across requests causes errors. Make sure to call Disposable.dispose() on the PocService instance before it leaves scope.

Parameters:
ctx - The current COR context. Must not be null.
Returns:
A configured PocService instance. Not null.
Throws:
StateManagerException - In case that the service cannot be retrieved.