/[classpath]/classpath/org/omg/CORBA/ORB.java
ViewVC logotype

Diff of /classpath/org/omg/CORBA/ORB.java

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.2.2.6 by gnu_andrew, Tue Aug 16 16:22:39 2005 UTC revision 1.2.2.7 by gnu_andrew, Sat Sep 10 15:32:04 2005 UTC
# Line 517  public abstract class ORB Line 517  public abstract class ORB
517    }    }
518    
519    /**    /**
520     * This should create the new policy with the specified type and initial     * <p>Creates the new policy of the specified type, having the given value.
521     * state. The policies and methods for getting them are not implemented till     * This method looks for the policy factory that was previously registered
522     * v1.4 inclusive.     * during ORB initialization by
523     *     * {@link org.omg.PortableInterceptor.ORBInitialiser}.
524       *
525       * If the suitable factory is found, this factory creates the requested policy,
526       * otherwise the PolicyError is thrown.
527       * </p><p>
528       * The POA policies should be created by POA, not by this method.
529       * </p>
530     * @param type the policy type.     * @param type the policy type.
531     * @param value the policy value.     * @param value the policy value, wrapped into Any.
532     *     *
533     * @return never     * @throws PolicyError if the ORB fails to instantiate the policy object.
534       *
535       * @throws NO_IMPLEMENT always (in this class). Overridden in derived classes
536       * returned by ORB.init(..).
537     *     *
538     * @throws NO_IMPLEMENT, always.     * @see org.omg.PortableInterceptor.ORBInitInfoOperations#register_policy_factory
539       * @see org.omg.PortableInterceptor.PolicyFactoryOperations
540     */     */
541    public Policy create_policy(int type, Any value)    public Policy create_policy(int type, Any value)
542                         throws PolicyError                         throws PolicyError
# Line 886  public abstract class ORB Line 896  public abstract class ORB
896     * <td>Creates DynAny's.</td>     * <td>Creates DynAny's.</td>
897     * </tr>     * </tr>
898     *     *
899       * <tr><td>PICurrent</td><td>{@link org.omg.PortableInterceptor.Current}</td>
900       * <td>Contains multiple slots where an interceptor can rememeber the
901       * request - specific values between subsequent
902       * calls of the interceptor methods.</td>
903       * </tr>
904       *
905     * </table>     * </table>
906     *     *
907     * @param name the object name.     * @param name the object name.
# Line 947  public abstract class ORB Line 963  public abstract class ORB
963    }    }
964    
965    /**    /**
966     * Find and return the CORBA object, addressed by the given     * <p>Find and return the CORBA object, addressed by the given
967     * IOR string representation. The object can (an usually is)     * string representation. The object can be (an usually is)
968     * located on a remote computer, possibly running a different     * located on a remote computer, possibly running a different
969     * (not necessary java) CORBA implementation. The returned     * (not necessary java) CORBA implementation. The returned
970     * object is typically casted to the more specific reference     * object is typically casted to the more specific reference
971     * using the <code>narrow(Object)</code> method of its helper.     * using the <code>narrow(Object)</code> method of its helper.
972       * </p><p>
973       * This function supports the following input formats:<br>
974       * 1. IOR reference (<b>ior:</b>nnnnn ..), usually computer generated.<br>
975       * 2. <b>corbaloc:</b>[<b>iiop</b>][version.subversion<b>@</b>]<b>:</b>host[<b>:</b>port]<b>/</b><i>key</i>
976       * defines similar information as IOR reference, but is more human readable.
977       * This type of reference may also contain multiple addresses (see
978       * OMG documentation for complete format).<br>
979       * 3. <b>corbaloc:rir:/</b><i>name</i> defines internal reference on this
980       * ORB that is resolved using {@link #resolve_initial_references}, passing
981       * the given <i>name</i> as parameter.<br>
982       * 4. <b>corbaname:rir:#</b><i>name</i> states that the given <i>name</i>
983       * must be resolved using the naming service, default for this ORB.<br>
984       * 5. <b>corbaname:</b>[<b>iiop</b>][version.subversion<b>@</b>]<b>:</b>host[<b>:</b>port]<b>#</b><i>name</i>
985       * states that the <i>name</i> must be resolved using the naming service
986       * that runs on the given host at the given port. The ORB expects to find
987       * there the {@link org.omg.CosNaming.NamingContext} under the key
988       * "NameService.<br>
989       *
990       * <p>The default port is always 2809. The default iiop version is 1.0
991       * that now may not always be supported, so we would recommend to specify
992       * the version explicitly.</p>
993       * <p>
994       * The examples of the corbaloc and corbaname addresses:<br>
995       * corbaname:rir:#xobj - ask local naming service for "xobj".<br>
996       * corbaname:rir:/NameService#xobj - same (long form).<br>
997       * corbaname:iiop:1.2@localhost:900#xobj - same, assuming that the naming
998       * service runs at port 900 on the local host and supports iiop 1.2.<br>
999       * corbaname:iiop:localhost#xobj - same, assuming that the naming
1000       * service runs at port 2809 on the local host and supports iiop 1.0.<br>
1001       * corbaloc::gnu.xxx.yy/Prod/TradingService - the object exists on the
1002       * host gnu.xxx.yy, port 2809 having the key "Prod/TradingService". Its ORB
1003       * supports iiop 1.0.<br>
1004       * corbaloc::gnu.xxx.yy/Prod/TradingService:801 - the object exists on the
1005       * host gnu.xxx.yy, port 801 having the key "Prod/TradingService". Its ORB
1006       * supports iiop 1.0 (iiop keyword ommitted).<br>
1007       * corbaloc:iiop:1.1@gnu.xxx.yy/Prod/TradingService - the object exists on the
1008       * host gnu.xxx.yy, port 801 having the key "Prod/TradingService". Its ORB
1009       * supports iiop 1.1.<br>
1010       * corbaloc:rir:/NameService - the default naming service.
1011     *     *
1012     * @param IOR the object IOR representation string.     * @param IOR the object IOR representation string.
1013     *     *
1014     * @return the found CORBA object.     * @return the found CORBA object.
1015       *
1016       * @throws BAD_PARAM if the string being parsed is invalid.
1017       * @throws DATA_CONVERSION if the string being parsed contains unsupported
1018       * prefix or protocol.
1019       *
1020     * @see object_to_string(org.omg.CORBA.Object)     * @see object_to_string(org.omg.CORBA.Object)
1021     */     */
1022    public abstract Object string_to_object(String IOR);    public abstract Object string_to_object(String IOR);

Legend:
Removed from v.1.2.2.6  
changed lines
  Added in v.1.2.2.7

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26