001: /*
002: License $Id: I_JoRemoteSession.java,v 1.5 2005/03/15 20:09:44 hendriks73 Exp $
003:
004: Copyright (c) 2001-2005 tagtraum industries.
005:
006: LGPL
007: ====
008:
009: jo! is free software; you can redistribute it and/or
010: modify it under the terms of the GNU Lesser General Public
011: License as published by the Free Software Foundation; either
012: version 2.1 of the License, or (at your option) any later version.
013:
014: jo! is distributed in the hope that it will be useful,
015: but WITHOUT ANY WARRANTY; without even the implied warranty of
016: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
017: Lesser General Public License for more details.
018:
019: You should have received a copy of the GNU Lesser General Public
020: License along with this library; if not, write to the Free Software
021: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
022:
023: For LGPL see <http://www.fsf.org/copyleft/lesser.txt>
024:
025:
026: Sun license
027: ===========
028:
029: This release contains software by Sun Microsystems. Therefore
030: the following conditions have to be met, too. They apply to the
031: files
032:
033: - lib/mail.jar
034: - lib/activation.jar
035: - lib/jsse.jar
036: - lib/jcert.jar
037: - lib/jaxp.jar
038: - lib/crimson.jar
039: - lib/servlet.jar
040: - lib/jnet.jar
041: - lib/jaas.jar
042: - lib/jaasmod.jar
043:
044: contained in this release.
045:
046: a. Licensee may not modify the Java Platform
047: Interface (JPI, identified as classes contained within the javax
048: package or any subpackages of the javax package), by creating additional
049: classes within the JPI or otherwise causing the addition to or modification
050: of the classes in the JPI. In the event that Licensee creates any
051: Java-related API and distribute such API to others for applet or
052: application development, you must promptly publish broadly, an accurate
053: specification for such API for free use by all developers of Java-based
054: software.
055:
056: b. Software is confidential copyrighted information of Sun and
057: title to all copies is retained by Sun and/or its licensors. Licensee
058: shall not modify, decompile, disassemble, decrypt, extract, or otherwise
059: reverse engineer Software. Software may not be leased, assigned, or
060: sublicensed, in whole or in part. Software is not designed or intended
061: for use in on-line control of aircraft, air traffic, aircraft navigation
062: or aircraft communications; or in the design, construction, operation or
063: maintenance of any nuclear facility. Licensee warrants that it will not
064: use or redistribute the Software for such purposes.
065:
066: c. Software is provided "AS IS," without a warranty
067: of any kind. ALL EXPRESS OR IMPLIED REPRESENTATIONS AND WARRANTIES,
068: INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
069: PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED.
070:
071: d. This License is effective until terminated. Licensee may
072: terminate this License at any time by destroying all copies of Software.
073: This License will terminate immediately without notice from Sun if Licensee
074: fails to comply with any provision of this License. Upon such termination,
075: Licensee must destroy all copies of Software.
076:
077: e. Software, including technical data, is subject to U.S.
078: export control laws, including the U.S. Export Administration Act and its
079: associated regulations, and may be subject to export or import regulations
080: in other countries. Licensee agrees to comply strictly with all such
081: regulations and acknowledges that it has the responsibility to obtain
082: licenses to export, re-export, or import Software. Software may not be
083: downloaded, or otherwise exported or re-exported (i) into, or to a national
084: or resident of, Cuba, Iraq, Iran, North Korea, Libya, Sudan, Syria or any
085: country to which the U.S. has embargoed goods; or (ii) to anyone on the
086: U.S. Treasury Department's list of Specially Designated Nations or the U.S.
087: Commerce Department's Table of Denial Orders.
088:
089:
090: Feedback
091: ========
092:
093: We encourage your feedback and suggestions and want to use your feedback to
094: improve the Software. Send all such feedback to:
095: <feedback@tagtraum.com>
096:
097: For more information on tagtraum industries and jo!
098: please see <http://www.tagtraum.com/>.
099:
100:
101: */
102: package com.tagtraum.jobalancer;
103:
104: import java.rmi.Remote;
105: import java.rmi.RemoteException;
106: import java.util.Enumeration;
107:
108: /**
109: * Realizes a remote session object that can be wrapped by a {@link JoRemoteSessionWrapper}.
110: *
111: * TODO: Translate comments to Enlgish!
112: *
113: * @author Hendrik Schreiber
114: * @version 1.1beta1 $Id: I_JoRemoteSession.java,v 1.5 2005/03/15 20:09:44 hendriks73 Exp $
115: */
116: public interface I_JoRemoteSession extends Remote {
117:
118: /**
119: * Source-Version
120: */
121: public static String vcid = "$Id: I_JoRemoteSession.java,v 1.5 2005/03/15 20:09:44 hendriks73 Exp $";
122:
123: /**
124: * Setzt den Indentifikationsstring dieser Session.
125: *
126: * @exception IllegalStateException falls die SessionID bereits gesetzt worden ist.
127: */
128: public void setId(String anID) throws RemoteException;
129:
130: /**
131: * Sets the sessioncontext of this session.
132: *
133: * @param aContext zugehöriger SessionContext
134: * @exception IllegalStateException falls der SessionContext bereits gesetzt worden ist.
135: */
136: public void setSessionContext(I_JoRemoteSessionContext aContext)
137: throws RemoteException;
138:
139: /**
140: * Gibt den Indentifikationsstring dieser Session zurück.
141: *
142: * @exception IllegalStateException falls die Session bereits ungültig ist.
143: * @return SessionID
144: */
145: public String getId() throws RemoteException;
146:
147: /**
148: * Gibt die Zeit zurück, zu der diese Session erzeugt wurde.
149: *
150: * @exception IllegalStateException falls die Session bereits ungültig ist.
151: * @return Zeit in ms seit 1.1.1970 UTC
152: */
153: public long getCreationTime() throws RemoteException;
154:
155: /**
156: * Gibt die Zeit zurück, zu der diese Session das letzte mal
157: * benutzt wurde.
158: *
159: * @exception IllegalStateException falls die Session bereits ungültig ist.
160: * @return Zeit in ms seit 1.1.1970 UTC
161: */
162: public long getLastAccessedTime() throws RemoteException;
163:
164: /**
165: * Markiert den Zeitpunkt der letzten Nutzung.
166: */
167: public void markAccessed() throws RemoteException;
168:
169: /**
170: * Erkl�rt diese Session für ungültig.
171: *
172: * @exception IllegalStateException falls die Session bereits ungültig ist.
173: */
174: public void invalidate() throws RemoteException;
175:
176: /**
177: * Hinterlegt ein Objekt unter einem Schlüssel in dieser Session.
178: *
179: * @exception IllegalStateException falls die Session bereits ungültig ist.
180: * @param name Schlüssel
181: * @param name Objekt
182: */
183: public void setAttribute(String name, Object value)
184: throws RemoteException;
185:
186: /**
187: * Gibt ein in dieser Session hinterlegtes Objekt zurück.
188: *
189: * @exception IllegalStateException falls die Session bereits ungültig ist.
190: * @param name Schlüssel
191: * @return Objekt
192: */
193: public Object getAttribute(String name) throws RemoteException;
194:
195: /**
196: * Entfernt ein in dieser Session hinterlegtes Objekt zurück.
197: *
198: * @exception IllegalStateException falls die Session bereits ungültig ist.
199: * @param name Schlüssel
200: */
201: public void removeAttribute(String name) throws RemoteException;
202:
203: /**
204: * Gibt einen Array mit allen Schlüsseln zurück, unter
205: * denen ein Objekt an diese Session gebunden wurde.
206: *
207: * @return Array mit allen Schlüsseln.
208: */
209: public String[] getValueNames() throws RemoteException;
210:
211: /**
212: * Gibt eine Enumeration mit allen Schlüsseln zurück, unter
213: * denen ein Objekt an diese Session gebunden wurde.
214: *
215: * @return Enumeration mit allen Schlüsseln.
216: */
217: public Enumeration getAttributeNames() throws RemoteException;
218:
219: /**
220: * Gibt an, ob eine Session <i>neu</i> ist. Die genaue Definition
221: * von <i>neu</i> ist der Servlet-API-Spezifikation zu entnehmen.
222: *
223: * @return <code>true</code> oder <code>false</code>
224: */
225: public boolean isNew() throws RemoteException;
226:
227: /**
228: * Gibt die maximale Zeit, die eine Session inaktiv existieren kann,
229: * in Sekunden zurück.
230: *
231: * @return Zeit in Sekunden.
232: */
233: public int getMaxInactiveInterval() throws RemoteException;
234:
235: /**
236: * Setzt die maximale Zeit, die eine Session inaktiv existieren kann.
237: *
238: * @param interval Zeit in Sekunden.
239: */
240: public void setMaxInactiveInterval(int interval)
241: throws RemoteException;
242:
243: /**
244: * Indicates whether this session is still valid.
245: */
246: public boolean isValid() throws RemoteException;
247:
248: }
|