KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > jonas > jtests > beans > relation > s1pkcomp > ARemote


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: ARemote.java,v 1.1 2003/02/14 13:33:06 joaninh Exp $
23  * --------------------------------------------------------------------------
24  */

25
26 package org.objectweb.jonas.jtests.beans.relation.s1pkcomp;
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 ARemote extends EJBObject JavaDoc {
37
38     PK getId() throws RemoteException JavaDoc;
39
40     /**
41      * It replaces the referenced elements of the relation by the element of the
42      * collection specified.
43      * This method has the transactional attribut TX_SUPPORTS.
44      * @param c is a collection of the primary key of the bean 'B'. Then the
45      * elements are java.lang.String objects.
46      * @throw a FinderException if among the collection a primary key does not
47      * match to a bean.
48      */

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

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

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

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

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

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

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

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

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

128     void removeFromBInNewTx(PK pkb) throws FinderException JavaDoc, RemoteException JavaDoc;
129
130
131     /**
132      * It clear the multivalued relation
133      * This method has the transactional attribut TX_SUPPORTS.
134      */

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

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

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

158     boolean containInB(PK pkb) throws FinderException JavaDoc, RemoteException JavaDoc;
159 }
160
Popular Tags