org.objectweb.jonas_ejb.container
Class JHome

java.lang.Object
  javax.rmi.PortableRemoteObject
      org.objectweb.jonas_ejb.container.JHome

All Implemented Interfaces:

javax.ejb.EJBHome, java.rmi.Remote

Direct Known Subclasses:

JEntityHome, JSessionHome

public abstract class JHome

extends javax.rmi.PortableRemoteObject

implements javax.ejb.EJBHome

This class represents an EJBHome Remote Interface It is shared between Sessions and Entities.

Author:

Philippe Coq, Philippe Durieux

Field Summary

protected JFactory	bf
protected BeanDesc	dd
protected JMetaData	ejbMetaData
protected boolean	unregistered

Constructor Summary

JHome(BeanDesc dd, JFactory bf)
Constructor for the base class of the specific generated Home object.

Method Summary

void	checkSecurity(EJBInvocation ejbInv) Check if the access to the bean is authorized
JFactory	getBf()
BeanDesc	getDd()
javax.ejb.EJBMetaData	getEJBMetaData() Obtains the EJBMetaData for the enterprise Bean.
javax.ejb.HomeHandle	getHomeHandle() Obtain a handle for the home object.
java.lang.String	getJndiName() Get the jndi name for the bean
void	postInvoke(RequestCtx rctx) postInvoke is called after any request.
RequestCtx	preInvoke(int txa) preInvoke is called before any request.
protected void	register() register this bean to JNDI (rebind)
abstract void	remove(javax.ejb.Handle handle) Removes an EJB object identified by its handle.
abstract void	remove(java.lang.Object primaryKey) Removes an EJB object identified by its primary key.
protected void	unregister() unregister this bean in JNDI (unbind)

Methods inherited from class javax.rmi.PortableRemoteObject

connect, exportObject, narrow, toStub, unexportObject

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ejbMetaData

protected JMetaData ejbMetaData

dd

protected BeanDesc dd

bf

protected JFactory bf

unregistered

protected boolean unregistered

Constructor Detail

JHome

public JHome(BeanDesc dd,
             JFactory bf)
      throws java.rmi.RemoteException

Constructor for the base class of the specific generated Home object.

Parameters:

dd - The Been Deployment Descriptor

bf - The Bean Factory

Throws:

java.rmi.RemoteException - exception

Method Detail

getEJBMetaData

public javax.ejb.EJBMetaData getEJBMetaData()
                                     throws java.rmi.RemoteException

Obtains the EJBMetaData for the enterprise Bean.

Specified by:

getEJBMetaData in interface javax.ejb.EJBHome

Returns:

The enterprise Bean's EJBMetaData

Throws:

java.rmi.RemoteException - exception

getHomeHandle

public javax.ejb.HomeHandle getHomeHandle()
                                   throws java.rmi.RemoteException

Obtain a handle for the home object. The handle can be used at later time to re-obtain a reference to the home object, possibly in a different Java Virtual Machine.

Specified by:

getHomeHandle in interface javax.ejb.EJBHome

Returns:

A handle for the home object.

Throws:

java.rmi.RemoteException - - Thrown when the method failed due to a system-level failure.

remove

public abstract void remove(javax.ejb.Handle handle)
                     throws java.rmi.RemoteException,
                            javax.ejb.RemoveException

Removes an EJB object identified by its handle.

Specified by:

remove in interface javax.ejb.EJBHome

Parameters:

handle - The EJB Handle

Throws:

java.rmi.RemoteException - exception

javax.ejb.RemoveException - exception

remove

public abstract void remove(java.lang.Object primaryKey)
                     throws java.rmi.RemoteException,
                            javax.ejb.RemoveException

Removes an EJB object identified by its primary key.

Specified by:

remove in interface javax.ejb.EJBHome

Parameters:

primaryKey - The Primary Key

Throws:

java.rmi.RemoteException - exception

javax.ejb.RemoveException - exception

register

protected void register()
                 throws javax.naming.NamingException

register this bean to JNDI (rebind)

Throws:

javax.naming.NamingException - exception

unregister

protected void unregister()
                   throws javax.naming.NamingException

unregister this bean in JNDI (unbind)

Throws:

javax.naming.NamingException - exception

getJndiName

public java.lang.String getJndiName()

Get the jndi name for the bean

Returns:

The jndi name

Throws:

java.rmi.RemoteException

preInvoke

public RequestCtx preInvoke(int txa)
                     throws java.rmi.RemoteException

preInvoke is called before any request.

Parameters:

txa - Transaction Attribute (Supports, Required, ...)

Returns:

A RequestCtx object

Throws:

java.rmi.RemoteException - unexpected exception in preinvoke

checkSecurity

public void checkSecurity(EJBInvocation ejbInv)

Check if the access to the bean is authorized

Parameters:

ejbInv - object containing security signature of the method, args of method, etc

postInvoke

public void postInvoke(RequestCtx rctx)
                throws java.rmi.RemoteException

postInvoke is called after any request.

Parameters:

rctx - The RequestCtx that was returned at preInvoke()

Throws:

java.rmi.RemoteException - unexpected exception in postinvoke

getDd

public BeanDesc getDd()

Returns:

Returns the dd.

getBf

public JFactory getBf()

Returns:

the bean factory