KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > jonas > jtests > beans > relation > pkcomp > BRemote


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: BRemote.java,v 1.2 2003/01/24 08:31:40 chassand Exp $
23  * --------------------------------------------------------------------------
24  */

25
26 package org.objectweb.jonas.jtests.beans.relation.pkcomp;
27
28 import java.util.Collection JavaDoc;
29 import java.rmi.RemoteException JavaDoc;
30 import javax.ejb.EJBObject JavaDoc;
31 import javax.ejb.FinderException JavaDoc;
32
33 /**
34  * @author J.Camilleri
35  */

36 public interface BRemote extends EJBObject JavaDoc {
37
38     BPK getId() throws RemoteException JavaDoc;
39     void m1() throws RemoteException JavaDoc;
40
41     /**
42      * It replaces the referenced elements of the relation by the element of the
43      * collection specified.
44      * This method has the transactional attribut TX_SUPPORTS.
45      * @param c is a collection of the primary key of the bean 'A'. Then the
46      * elements are java.lang.String objects.
47      * @throw a FinderException if among the collection a primary key does not
48      * match to a bean.
49      */

50     void assignA(Collection JavaDoc c) throws FinderException JavaDoc, RemoteException JavaDoc;
51
52     /**
53      * It replaces the referenced elements of the relation by the element of the
54      * collection specified.
55      * This method has the transactional attribut TX_REQUIRES_NEW.
56      * @param c is a collection of the primary key of the bean 'A'. Then the
57      * elements are java.lang.String objects.
58      * @throw a FinderException if among the collection a primary key does not
59      * match to a bean.
60      */

61     void assignAInNewTx(Collection JavaDoc c) throws FinderException JavaDoc, RemoteException JavaDoc;
62
63
64     /**
65      * It returns the primary key of the referenced elements.
66      * This method has the transactional attribut TX_SUPPORTS.
67      * @return a collection of the primary key of the bean 'A'. Then the
68      * elements are java.lang.String objects.
69      */

70     Collection JavaDoc retrieveA() throws RemoteException JavaDoc;
71
72     /**
73      * It returns the primary key of the referenced elements.
74      * This method has the transactional attribut TX_REQUIRES_NEW.
75      * @return a collection of the primary key of the bean 'A'. Then the
76      * elements are java.lang.String objects.
77      */

78     Collection JavaDoc retrieveAInNewTx() throws RemoteException JavaDoc;
79
80
81     /**
82      * It adds in the multivalued relation the bean A defined by the primary
83      * keys specified by the parameter.
84      * This method has the transactional attribut TX_SUPPORTS.
85      * @throw a FinderException if the primary key does not match to a bean.
86      */

87     void addAllInA(Collection JavaDoc pkbs) throws FinderException JavaDoc, RemoteException JavaDoc;
88
89     /**
90      * It adds in the multivalued relation the beans A defined by the primary
91      * keys specified by the parameter.
92      * This method has the transactional attribut TX_REQUIRES_NEW.
93      * @throw a FinderException if the primary key does not match to a bean.
94      */

95     void addAllInAInNewTx(Collection JavaDoc pkbs) throws FinderException JavaDoc, RemoteException JavaDoc;
96
97
98     /**
99      * It adds in the multivalued relation the bean A defined by its primary
100      * key specified by the parameter.
101      * This method has the transactional attribut TX_SUPPORTS.
102      * @throw a FinderException if the primary key does not match to a bean.
103      */

104     void addInA(APK pka) throws FinderException JavaDoc, RemoteException JavaDoc;
105
106     /**
107      * It adds in the multivalued relation the bean A defined by its primary
108      * key specified by the parameter.
109      * This method has the transactional attribut TX_REQUIRES_NEW.
110      * @throw a FinderException if the primary key does not match to a bean.
111      */

112     void addInAInNewTx(APK pka) throws FinderException JavaDoc, RemoteException JavaDoc;
113
114
115     /**
116      * It removes from the multivalued relation the bean A defined by its primary
117      * key specified by the parameter.
118      * This method has the transactional attribut TX_SUPPORTS.
119      * @throw a FinderException if the primary key does not match to a bean.
120      */

121     void removeFromA(APK pka) throws FinderException JavaDoc, RemoteException JavaDoc;
122
123     /**
124      * It removes from the multivalued relation the bean A defined by its primary
125      * key specified by the parameter.
126      * This method has the transactional attribut TX_REQUIRES_NEW.
127      * @throw a FinderException if the primary key does not match to a bean.
128      */

129     void removeFromAInNewTx(APK pka) throws FinderException JavaDoc, RemoteException JavaDoc;
130
131
132     /**
133      * It clear the multivalued relation
134      * This method has the transactional attribut TX_SUPPORTS.
135      */

136     void clearA() throws RemoteException JavaDoc;
137
138     /**
139      * It clear the multivalued relation
140      * This method has the transactional attribut TX_REQUIRES_NEW.
141      */

142     void clearAInNewTx() throws RemoteException JavaDoc;
143
144     /**
145      * It returns true the multivalued relation contains all the bean A defined
146      * by the primary keys specified by the parameter.
147      * This method has the transactional attribut TX_SUPPORTS.
148      * @throw a FinderException if a primary key does not match to a bean.
149      */

150     boolean containAllInA(Collection JavaDoc pkbs) throws FinderException JavaDoc, RemoteException JavaDoc;
151
152
153     /**
154      * It returns true the multivalued relation contains the bean A defined
155      * by the primary key specified by the parameter.
156      * This method has the transactional attribut TX_SUPPORTS.
157      * @throw a FinderException if the primary key does not match to a bean.
158      */

159     boolean containInA(APK pka) throws FinderException JavaDoc, RemoteException JavaDoc;
160
161 }
162
Popular Tags