KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > util > browser > core > api > ExtendedEntry


1 /*===========================================================================
2
3 ObjectWeb Naming Context Framework
4 Copyright (C) 2002 USTL - LIFL - GOAL
5 Contact: architecture@objectweb.org
6
7 This library is free software; you can redistribute it and/or
8 modify it under the terms of the GNU Lesser General Public
9 License as published by the Free Software Foundation; either
10 version 2.1 of the License, or any later version.
11
12 This library is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 Lesser General Public License for more details.
16
17 You should have received a copy of the GNU Lesser General Public
18 License along with this library; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
20 USA
21
22 Initial developer(s): Philippe Merle, Jerome Moroy
23 Contributor(s): ______________________________________.
24
25 ===========================================================================*/
26
27 package org.objectweb.util.browser.core.api;
28
29 import org.objectweb.util.browser.api.Entry;
30
31 /**
32  * Entries are non-mutable structures representing entries in contexts.
33  *
34  * An Entry is composed of a <value,name,context>,
35  * where value is an Object, name is a Name, and
36  * context is the owner Context.
37  *
38  * Extended entry allows to fix this value after instanciation.
39  *
40  * @author <a HREF="mailto:Jerome.Moroy@lifl.fr">Jerome Moroy</a>
41  * @version 0.1
42  *
43  */
44 public interface ExtendedEntry
45     extends Entry {
46
47     /**
48      * The standard name of this interface to use
49      * in the context of the Fractal framework.
50      */
51     static final String JavaDoc EXTENDED_ENTRY = ExtendedEntry.class.getName();
52
53     /**
54      * Changes the value of the Entry.
55      *
56      * @param value The value to set.
57      */
58     public void setOWValue(Object JavaDoc value);
59
60     /**
61      * Returns the wrapped object. The returned value is the same as the getOWObject method if no Context is defined for this object.
62      *
63      * @return The wrapped object
64      */
65     public Object JavaDoc getWrappedObject();
66
67     // Example :
68 // NameService -> Corba Object -> Decodage IOR -> New interface -> New search into wrapper table -> create new context.
69 /**
70      * Sets the wrapped object. It's necessary when the object crosses more than one factory, as every CORBA Object does.
71      */
72     public void setWrappedObject(Object JavaDoc wrapped);
73
74 }
75
Popular Tags