KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > sun > corba > se > spi > ior > IOR


1 /*
2  * @(#)IOR.java 1.15 03/12/19
3  *
4  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
5  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
6  */
7
8 package com.sun.corba.se.spi.ior;
9
10 import java.util.List JavaDoc ;
11 import java.util.Iterator JavaDoc ;
12
13 import com.sun.corba.se.spi.orb.ORBVersion ;
14
15 import com.sun.corba.se.spi.ior.iiop.GIOPVersion ;
16 import com.sun.corba.se.spi.ior.iiop.IIOPProfile ;
17
18 import com.sun.corba.se.spi.orb.ORB ;
19
20 /** An IOR is represented as a list of profiles.
21 * Only instances of TaggedProfile are contained in the list.
22 */
23 public interface IOR extends List JavaDoc, Writeable, MakeImmutable
24 {
25     ORB getORB() ;
26
27     /** Return the type id string from the IOR.
28     */
29     String JavaDoc getTypeId() ;
30    
31     /** Return an iterator that iterates over tagged profiles with
32     * identifier id. It is not possible to modify the list through this
33     * iterator.
34     */
35     Iterator JavaDoc iteratorById( int id ) ;
36
37     /** Return a representation of this IOR in the standard GIOP stringified
38      * format that begins with "IOR:".
39      */
40     String JavaDoc stringify() ;
41
42     /** Return a representation of this IOR in the standard GIOP marshalled
43      * form.
44      */
45     org.omg.IOP.IOR JavaDoc getIOPIOR() ;
46
47     /** Return true if this IOR has no profiles.
48      */
49     boolean isNil() ;
50
51     /** Return true if this IOR is equivalent to ior. Here equivalent means
52      * that the typeids are the same, they have the same number of profiles,
53      * and each profile is equivalent to the corresponding profile.
54      */
55     boolean isEquivalent(IOR ior) ;
56
57     /** Return the IORTemplate for this IOR. This is simply a list
58      * of all TaggedProfileTemplates derived from the TaggedProfiles
59      * of the IOR.
60      */
61     IORTemplateList getIORTemplates() ;
62
63     /** Return the first IIOPProfile in this IOR.
64      * XXX THIS IS TEMPORARY FOR BACKWARDS COMPATIBILITY AND WILL BE REMOVED
65      * SOON!
66      */
67     IIOPProfile getProfile() ;
68 }
69
Popular Tags