org.sape.carbon.services.ejb.remote
Interface RemoteHomeFactory

All Superinterfaces:

FunctionalInterface

All Known Implementing Classes:

RemoteHomeFactoryImpl

public interface RemoteHomeFactory

extends FunctionalInterface

This interface defines the functional APIs for a home factory component that provides facilities for retrieving the home interfaces of remotely deployed Enterprise Java Beans (EJBHome objects).

Copyright 2002 Sapient

Since:

carbon 1.0

Version:

$Revision: 1.7 $($Author: dvoet $ / $Date: 2003/05/05 21:21:28 $)

Author:

Erik M Gottesman, June 2002

Method Summary

EnterpriseBeanConfiguration	getEJBDetails(String logicalName) Utility method for retrieving an EJB's configuration information as declared in the associated XML configuration.
javax.ejb.EJBHome	lookup(String logicalName) Handles JNDI lookups for remotely deployed EJBs using the default context properties declared in the associated configuration.
javax.ejb.EJBHome	lookup(String logicalName, Context context) Handles JNDI lookups for remotely deployed EJBs using a context object specified at run-time.
javax.ejb.EJBHome	lookup(String logicalName, String principal, String credentials) Handles JNDI lookups for remotely deployed EJBs using the default context properties declared in the associated configuration with the exception of the security principal and credentials which are passed at run-time.

Method Detail

lookup

public javax.ejb.EJBHome lookup(String logicalName)
                         throws HomeFactoryException

Handles JNDI lookups for remotely deployed EJBs using the default context properties declared in the associated configuration.

Parameters:

logicalName - String representation of the EJB's logical name in JNDI

Returns:

EJBHome The home interface object for the remote EJB

Throws:

HomeFactoryException - Wraps any checked exception that occurs during the JNDI lookup

lookup

public javax.ejb.EJBHome lookup(String logicalName,
                                Context context)
                         throws HomeFactoryException

Handles JNDI lookups for remotely deployed EJBs using a context object specified at run-time.

Parameters:

logicalName - a String representation of the EJB's logical name in JNDI

context - A javax.naming.Context object to be used in performing the JNDI lookup

Returns:

EJBHome The home interface object for the remote EJB

Throws:

HomeFactoryException - Wraps any checked exception that occurs during the JNDI lookup

lookup

public javax.ejb.EJBHome lookup(String logicalName,
                                String principal,
                                String credentials)
                         throws HomeFactoryException

Handles JNDI lookups for remotely deployed EJBs using the default context properties declared in the associated configuration with the exception of the security principal and credentials which are passed at run-time.

Parameters:

logicalName - a String representation of the EJB's logical name in JNDI

principal - String representation of the security principal

credentials - The credentials associated with the security principal in String format

Returns:

EJBHome The home interface object for the remote EJB

Throws:

HomeFactoryException - Wraps any checked exception that occurs during the JNDI lookup

getEJBDetails

public EnterpriseBeanConfiguration getEJBDetails(String logicalName)

Utility method for retrieving an EJB's configuration information as declared in the associated XML configuration.

Parameters:

logicalName - String representation of the EJB's logical name in JNDI

Returns:

EnterpriseBeanConfiguration An encapsulation of the EJB's declared configuration details