KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > openejb > client > EJBObjectHandle


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: EJBObjectHandle.java 1912 2005-06-16 22:29:56Z jlaskowski $
44  */
45 package org.openejb.client;
46
47 import java.io.IOException JavaDoc;
48 import java.io.ObjectInput JavaDoc;
49 import java.io.ObjectOutput JavaDoc;
50 import java.rmi.RemoteException JavaDoc;
51
52 import javax.ejb.EJBObject JavaDoc;
53
54 /**
55  * -------------------------------------
56  * EJB 1.1
57  *
58  * 9.3.4 Handle class
59  *
60  * The deployment tools are responsible for implementing the handle class for
61  * the entity bean. The handle class must be serializable by the Java
62  * programming language Serialization protocol.
63  *
64  * As the handle class is not entity bean specific, the container may, but is
65  * not required to, use a single class for all deployed entity beans.
66  * -------------------------------------
67  *
68  * The handle class for all deployed beans, not just entity beans.
69  *
70  * @author <a HREF="mailto:david.blevins@visi.com">David Blevins</a>
71  * @since 11/25/2001
72  */
73 public class EJBObjectHandle implements java.io.Externalizable JavaDoc , javax.ejb.Handle JavaDoc {
74
75     protected transient EJBObjectProxy ejbObjectProxy;
76     protected transient EJBObjectHandler handler;
77
78     /** Public no-arg constructor required by Externalizable API */
79     public EJBObjectHandle() {}
80
81     public EJBObjectHandle(EJBObjectProxy proxy) {
82         this.ejbObjectProxy = proxy;
83         this.handler = ejbObjectProxy.getEJBObjectHandler();
84     }
85
86     protected void setEJBObjectProxy(EJBObjectProxy ejbObjectProxy) {
87         this.ejbObjectProxy = ejbObjectProxy;
88         this.handler = ejbObjectProxy.getEJBObjectHandler();
89     }
90
91     /**
92      * Obtain the EJB object reference represented by this handle.
93      *
94      * @exception RemoteException The EJB object could not be obtained
95      * because of a system-level failure.
96      */
97     public EJBObject JavaDoc getEJBObject() throws RemoteException JavaDoc {
98         return ejbObjectProxy;
99     }
100
101     //========================================
102 // Externalizable object implementation
103 //
104 public void writeExternal(ObjectOutput JavaDoc out) throws IOException JavaDoc{
105
106         // Write the full proxy data
107 handler.client.writeExternal( out );
108         
109         EJBMetaDataImpl ejb = handler.ejb;
110         out.writeObject( ejb.homeClass );
111         out.writeObject( ejb.remoteClass );
112         out.writeObject( ejb.keyClass );
113         out.writeByte( ejb.type );
114         out.writeUTF( ejb.deploymentID );
115         out.writeShort( ejb.deploymentCode );
116         handler.server.writeExternal( out );
117         out.writeObject( handler.primaryKey );
118     }
119
120     /**
121      * Reads the instanceHandle from the stream
122      *
123      * @param in
124      * @exception IOException
125      */
126     public void readExternal(ObjectInput JavaDoc in) throws IOException JavaDoc, ClassNotFoundException JavaDoc{
127         ClientMetaData client = new ClientMetaData();
128         EJBMetaDataImpl ejb = new EJBMetaDataImpl();
129         ServerMetaData server = new ServerMetaData();
130
131         client.readExternal( in );
132
133         ejb.homeClass = (Class JavaDoc) in.readObject();
134         ejb.remoteClass = (Class JavaDoc) in.readObject();
135         ejb.keyClass = (Class JavaDoc) in.readObject();
136         ejb.type = in.readByte();
137         ejb.deploymentID = in.readUTF();
138         ejb.deploymentCode = in.readShort();
139
140         server.readExternal( in );
141         Object JavaDoc primaryKey = in.readObject();
142
143         handler = EJBObjectHandler.createEJBObjectHandler(ejb, server, client, primaryKey);
144         ejbObjectProxy = handler.createEJBObjectProxy();
145     }
146
147 }
Popular Tags