StatefulEJBHomeHandler


1   /**
2    * Redistribution and use of this software and associated documentation
3    * ("Software"), with or without modification, are permitted provided
4    * that the following conditions are met:
5    *
6    * 1. Redistributions of source code must retain copyright
7    *    statements and notices.  Redistributions must also contain a
8    *    copy of this document.
9    *
10   * 2. Redistributions in binary form must reproduce the
11   *    above copyright notice, this list of conditions and the
12   *    following disclaimer in the documentation and/or other
13   *    materials provided with the distribution.
14   *
15   * 3. The name "OpenEJB" must not be used to endorse or promote
16   *    products derived from this Software without prior written
17   *    permission of The OpenEJB Group.  For written permission,
18   *    please contact dev@openejb.org.
19   *
20   * 4. Products derived from this Software may not be called "OpenEJB"
21   *    nor may "OpenEJB" appear in their names without prior written
22   *    permission of The OpenEJB Group. OpenEJB is a registered
23   *    trademark of The OpenEJB Group.
24   *
25   * 5. Due credit should be given to the OpenEJB Project
26   *    (http://www.openejb.org/).
27   *
28   * THIS SOFTWARE IS PROVIDED BY THE OPENEJB GROUP AND CONTRIBUTORS
29   * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
30   * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
31   * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL
32   * THE OPENEJB GROUP OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
33   * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
34   * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
35   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36   * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
37   * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
38   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
39   * OF THE POSSIBILITY OF SUCH DAMAGE.
40   *
41   * Copyright 2001 (C) The OpenEJB Group. All Rights Reserved.
42   *
43   * $Id: StatefulEJBHomeHandler.java 1912 2005-06-16 22:29:56Z jlaskowski $
44   */
45  package org.openejb.client;
46  
47  import java.lang.reflect.Method  ;
48  import java.rmi.RemoteException  ;
49  
50  /**
51   * This InvocationHandler and its proxy are serializable and can be used by
52   * HomeHandle, Handle, and MetaData to persist and revive handles. It maintains
53   * its original client identity which allows the container to be more discerning about
54   * allowing the revieed proxy to be used. See StatefulContaer manager for more details.
55   * 
56   * @author <a HREF="mailto:david.blevins@visi.com">David Blevins</a>
57   * @author <a HREF="mailto:Richard@Monson-Haefel.com">Richard Monson-Haefel</a>
58   */
59  public class StatefulEJBHomeHandler extends EJBHomeHandler {
60      
61      public StatefulEJBHomeHandler(){
62      }
63      
64      public StatefulEJBHomeHandler(EJBMetaDataImpl ejb, ServerMetaData server, ClientMetaData client){
65          super(ejb, server, client);
66      }
67      
68      /**
69       *
70       * EJB 1.1 Specification, Section 5.5 Session object identity
71       * Since all session objects hide their identity, there is no need to provide a finder for them. The home
72       * interface of a session bean must not define any finder methods.
73       *
74       * @param method
75       * @param args
76       * @param proxy
77       * @return Returns an new EJBObject proxy and handler
78       * @exception Throwable
79       */
80      protected Object   findX(Method   method, Object  [] args, Object   proxy) throws Throwable   {
81          throw new UnsupportedOperationException  ("Stateful beans may not have find methods");
82      }
83      
84      /**
85       * ------------------------------------
86       * 5.3.2 Removing a session object
87       * A client may remove a session object using the remove() method on the javax.ejb.EJBObject
88       * interface, or the remove(Handle handle) method of the javax.ejb.EJBHome interface.
89       * 
90       * Because session objects do not have primary keys that are accessible to clients, invoking the
91       * javax.ejb.EJBHome.remove(Object primaryKey) method on a session results in the
92       * javax.ejb.RemoveException.
93       * 
94       * ------------------------------------
95       * 5.5 Session object identity
96       * 
97       * Session objects are intended to be private resources used only by the
98       * client that created them. For this reason, session objects, from the
99       * client�s perspective, appear anonymous. In contrast to entity objects,
100      * which expose their identity as a primary key, session objects hide their
101      * identity. As a result, the EJBObject.getPrimaryKey() and
102      * EJBHome.remove(Object primaryKey) methods result in a java.rmi.RemoteException
103      * if called on a session bean. If the EJBMetaData.getPrimaryKeyClass()
104      * method is invoked on a EJBMetaData object for a Session bean, the method throws
105      * the java.lang.RuntimeException.
106      * ------------------------------------
107      * 
108      * Sections 5.3.2 and 5.5 conflict.  5.3.2 says to throw javax.ejb.RemoveException, 5.5 says to
109      * throw java.rmi.RemoteException.
110      * 
111      * For now, we are going with java.rmi.RemoteException.
112      */
113     protected Object   removeByPrimaryKey(Method   method, Object  [] args, Object   proxy) throws Throwable   {
114         throw new RemoteException  ("Session objects are private resources and do not have primary keys");        
115     }
116     /**
117      * <P>
118      * Attempts to remove an EJBObject from the
119      * container system.  The EJBObject to be removed
120      * is represented by the javax.ejb.Handle object passed
121      * into the remove method in the EJBHome.
122      * </P>
123      * <P>
124      * This method propogates to the container system.
125      * </P>
126      * <P>
127      * remove(Handle handle) is a method of javax.ejb.EJBHome
128      * </P>
129      * <P>
130      * Checks if the caller is authorized to invoke the
131      * javax.ejb.EJBHome.remove on the EJBHome of the
132      * deployment.
133      * </P>
134      * 
135      * @param method
136      * @param args
137      * @return Returns null
138      * @exception Throwable
139      * @see javax.ejb.EJBHome
140      * @see javax.ejb.EJBHome#remove
141      */
142     protected Object   removeWithHandle(Method   method, Object  [] args, Object   proxy) throws Throwable  {
143         // Extract the primary key from the handle
144         EJBObjectHandle handle = (EJBObjectHandle)args[0];
145         
146         // TODO:1: Check that this is exactly spec compliant
147         if ( handle == null ) throw new NullPointerException  ("The handle is null");
148         
149         EJBObjectHandler handler = handle.handler;
150         Object   primKey = handler.primaryKey;
151 
152         // TODO:1: Check that this is exactly spec compliant
153         if ( !handler.ejb.deploymentID.equals(this.ejb.deploymentID) ){
154             throw new IllegalArgumentException  ("The handle is not from the same deployment");
155         }
156 
157         EJBRequest req = new EJBRequest( EJB_HOME_REMOVE_BY_HANDLE ); 
158         req.setClientIdentity( client.getClientIdentity() );
159         req.setDeploymentCode( handler.ejb.deploymentCode );
160         req.setDeploymentId(   handler.ejb.deploymentID );
161         req.setMethodInstance( method );
162         req.setMethodParameters( args );
163         req.setPrimaryKey( primKey );
164         
165         EJBResponse res = request( req );
166   
167         if ( res.getResponseCode() == res.EJB_ERROR ) {
168             throw (Throwable  )res.getResult();
169         }
170         
171         invalidateAllHandlers(handler.getRegistryId());
172         handler.invalidateReference();
173         return null;
174     }
175 }
176
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags