KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > openejb > core > stateful > StatefulContext


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 "Exolab" must not be used to endorse or promote
16  * products derived from this Software without prior written
17  * permission of Exoffice Technologies. For written permission,
18  * please contact info@exolab.org.
19  *
20  * 4. Products derived from this Software may not be called "Exolab"
21  * nor may "Exolab" appear in their names without prior written
22  * permission of Exoffice Technologies. Exolab is a registered
23  * trademark of Exoffice Technologies.
24  *
25  * 5. Due credit should be given to the Exolab Project
26  * (http://www.exolab.org/).
27  *
28  * THIS SOFTWARE IS PROVIDED BY EXOFFICE TECHNOLOGIES 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  * EXOFFICE TECHNOLOGIES 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 1999 (C) Exoffice Technologies Inc. All Rights Reserved.
42  *
43  * $Id: StatefulContext.java 1096 2004-03-26 21:41:16Z dblevins $
44  */

45 package org.openejb.core.stateful;
46
47 import javax.xml.rpc.handler.MessageContext JavaDoc;
48
49 import org.openejb.RpcContainer;
50 import org.openejb.core.Operations;
51 import org.openejb.core.ThreadContext;
52 import org.openejb.core.ivm.EjbObjectProxyHandler;
53
54 /**
55  * This class imposes restrictions on what stateful SessionBean methods can access which SessionContext
56  * methods. While the CoreContext handles restrictions related to container- vs. bean-managed
57  * transaction beans, this class manages restrictions related to the position of the bean
58  * in its life-cycle to the SessionContext operation being performed. Restrictions are specified
59  * in the EJB specification. The CoreContext actually fulfills the request, this class just
60  * applies restrictions on access.
61  */

62 public class StatefulContext
63 extends org.openejb.core.CoreContext implements javax.ejb.SessionContext JavaDoc{
64     public void checkBeanState(byte methodCategory) throws IllegalStateException JavaDoc{
65         /*
66         The methodCategory will be one of the following constants.
67         
68         SECURITY_METHOD:
69         ROLLBACK_METHOD:
70         EJBOBJECT_METHOD:
71         EJBHOME_METHOD
72         USER_TRANSACTION_METHOD:
73         
74         The super class, CoreContext determines if Context.getUserTransaction( ) method
75         maybe called before invoking this.checkBeanState( ). Only "bean managed" transaction
76         beans may access this method.
77         
78         
79         The USER_TRANSACTION_METHOD will never be passed as a methodCategory in the SessionSynchronization
80         interface methods. The CoreContext won't allow it.
81         
82         */

83         ThreadContext callContext = ThreadContext.getThreadContext();
84         
85         switch(callContext.getCurrentOperation()){
86             case Operations.OP_SET_CONTEXT:
87                 /*
88                 Allowed Operations:
89                     getEJBHome
90                 Prohibited Operations:
91                     getCallerPrincipal
92                     getRollbackOnly,
93                     isCallerInRole
94                     setRollbackOnly
95                     getEJBObject
96                     getPrimaryKey
97                     getUserTransaction
98                 */

99                 if(methodCategory != EJBHOME_METHOD)
100                     throw new IllegalStateException JavaDoc("Invalid operation attempted");
101                 break;
102             case Operations.OP_CREATE:
103             case Operations.OP_REMOVE:
104             case Operations.OP_ACTIVATE:
105             case Operations.OP_PASSIVATE:
106             case Operations.OP_AFTER_COMPLETION:
107                 /*
108                 Allowed Operations:
109                     getEJBHome
110                     getCallerPrincipal
111                     isCallerInRole
112                     getEJBObject
113                     getPrimaryKey
114                     getUserTransaction (not allowed in OP_AFTER_COMPLETION)
115                 Prohibited Operations:
116                     getRollbackOnly,
117                     setRollbackOnly
118                 */

119                 if(methodCategory == ROLLBACK_METHOD)
120                     throw new IllegalStateException JavaDoc("Invalid operation attempted");
121                 else
122                     break;
123             case Operations.OP_BUSINESS:
124             case Operations.OP_AFTER_BEGIN:
125             case Operations.OP_BEFORE_COMPLETION:
126                 /*
127                 Allowed Operations:
128                     getEJBHome
129                     getCallerPrincipal
130                     isCallerInRole
131                     getEJBObject
132                     getPrimaryKey
133                     getRollbackOnly,
134                     setRollbackOnly
135                     getUserTransaction (business methods only)
136                 Prohibited Operations:
137                 */

138                 break;
139         }
140         
141     }
142     
143     protected EjbObjectProxyHandler newEjbObjectHandler(RpcContainer container, Object JavaDoc pk, Object JavaDoc depID){
144         return new StatefulEjbObjectHandler(container, pk, depID);
145     }
146     
147     public MessageContext JavaDoc getMessageContext() {
148         return null; //TODO: implement this
149
}
150     
151 }
Popular Tags