KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > jonas > jtests > beans > relation > remon > AttributeEC2


1 /*
2  * JOnAS: Java(TM) Open Application Server
3  * Copyright (C) 1999 Bull S.A.
4  * Contact: jonas-team@objectweb.org
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19  * USA
20  *
21  * --------------------------------------------------------------------------
22  * $Id: AttributeEC2.java,v 1.1 2004/06/29 08:34:27 durieuxp Exp $
23  * --------------------------------------------------------------------------
24  */
25
26 package org.objectweb.jonas.jtests.beans.relation.remon;
27
28 import javax.ejb.CreateException JavaDoc;
29 import javax.ejb.DuplicateKeyException JavaDoc;
30 import javax.ejb.EJBException JavaDoc;
31 import javax.ejb.EntityContext JavaDoc;
32 import javax.ejb.FinderException JavaDoc;
33 import javax.ejb.RemoveException JavaDoc;
34 import javax.naming.Context JavaDoc;
35 import javax.naming.InitialContext JavaDoc;
36 import javax.naming.NamingException JavaDoc;
37
38 import org.objectweb.jonas.common.Log;
39 import org.objectweb.util.monolog.api.BasicLevel;
40 import org.objectweb.util.monolog.api.Logger;
41
42 /**
43  * @author Ph Durieux
44  */
45 public abstract class AttributeEC2 implements javax.ejb.EntityBean JavaDoc {
46
47
48     // ------------------------------------------------------------------
49 // Get and Set accessor methods of the bean's abstract schema
50 // ------------------------------------------------------------------
51 public abstract String JavaDoc getId();
52     public abstract void setId(String JavaDoc id);
53
54     // ------------------------------------------------------------------
55 // EntityBean implementation
56 // ------------------------------------------------------------------
57
58     static protected Logger logger = null;
59     EntityContext JavaDoc ejbContext;
60
61     /**
62      * The Entity bean can define 0 or more ejbCreate methods.
63      *
64      * @throws CreateException Failure to create an entity EJB object.
65      * @throws DuplicateKeyException An object with the same key already exists.
66      */
67     public String JavaDoc ejbCreate(String JavaDoc id) throws CreateException JavaDoc, DuplicateKeyException JavaDoc {
68         logger.log(BasicLevel.DEBUG, "");
69
70         // Init here the bean fields
71 setId(id);
72
73         // In CMP, should return null.
74 return null;
75     }
76
77     /**
78      * There must be an ejbPostCreate par ejbCreate method
79      * @throws CreateException Failure to create an entity EJB object.
80      */
81     public void ejbPostCreate(String JavaDoc id) throws CreateException JavaDoc {
82         logger.log(BasicLevel.DEBUG, "id=" + id);
83     }
84
85     /**
86      * Set the associated entity context. The container invokes this method
87      * on an instance after the instance has been created.
88      * This method is called in an unspecified transaction context.
89      *
90      * @param ctx - An EntityContext interface for the instance. The instance
91      * should store the reference to the context in an instance variable.
92      * @throws EJBException Thrown by the method to indicate a failure caused by a
93      * system-level error.
94      */
95     public void setEntityContext(EntityContext JavaDoc ctx) {
96         if (logger == null)
97             logger = Log.getLogger(Log.JONAS_TESTS_PREFIX);
98         logger.log(BasicLevel.DEBUG, "");
99         ejbContext = ctx;
100     }
101
102     /**
103      * Unset the associated entity context. The container calls this method
104      * before removing the instance.
105      * This is the last method that the container invokes on the instance.
106      * The Java garbage collector will eventually invoke the finalize() method
107      * on the instance.
108      * This method is called in an unspecified transaction context.
109      *
110      * @throws EJBException Thrown by the method to indicate a failure caused by a
111      * system-level error.
112      */
113     public void unsetEntityContext() {
114         logger.log(BasicLevel.DEBUG, "");
115         ejbContext = null;
116     }
117
118     /**
119      * A container invokes this method before it removes the EJB object
120      * that is currently associated with the instance. This method is
121      * invoked when a client invokes a remove operation on the enterprise Bean's
122      * home interface or the EJB object's remote interface. This method
123      * transitions the instance from the ready state to the pool of available
124      * instances.
125      *
126      * This method is called in the transaction context of the remove operation.
127      * @throws RemoveException The enterprise Bean does not allow destruction of the object.
128      * @throws EJBException - Thrown by the method to indicate a failure caused by a system-level
129      * error.
130      */
131     public void ejbRemove() throws RemoveException JavaDoc {
132         logger.log(BasicLevel.DEBUG, "");
133     }
134
135     /**
136      * A container invokes this method to instruct the instance to synchronize
137      * its state by loading it state from the underlying database.
138      * This method always executes in the proper transaction context.
139      *
140      * @throws EJBException Thrown by the method to indicate a failure caused by
141      * a system-level error.
142      */
143     public void ejbLoad() {
144         logger.log(BasicLevel.DEBUG, "");
145     }
146
147     /**
148      * A container invokes this method to instruct the instance to synchronize
149      * its state by storing it to the underlying database.
150      * This method always executes in the proper transaction context.
151      *
152      * @throws EJBException Thrown by the method to indicate a failure caused by
153      * a system-level error.
154      */
155     public void ejbStore() {
156         logger.log(BasicLevel.DEBUG, "");
157     }
158
159     /**
160      * A container invokes this method on an instance before the instance
161      * becomes disassociated with a specific EJB object.
162      */
163     public void ejbPassivate() {
164         logger.log(BasicLevel.DEBUG, "");
165     }
166
167     /**
168      * A container invokes this method when the instance is taken out of
169      * the pool of available instances to become associated with a specific
170      * EJB object.
171      */
172     public void ejbActivate() {
173         logger.log(BasicLevel.DEBUG, "");
174     }
175
176 }
177
Popular Tags