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 |
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. |
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); |