1686 * {@link javax.rmi.CORBA.Stub javax.rmi.CORBA.Stub}, then the |
1686 * {@link javax.rmi.CORBA.Stub javax.rmi.CORBA.Stub}, then the |
1687 * method do nothing and simply returns that stub. Otherwise, |
1687 * method do nothing and simply returns that stub. Otherwise, |
1688 * this method will attempt to connect the stub to an ORB as |
1688 * this method will attempt to connect the stub to an ORB as |
1689 * follows: |
1689 * follows: |
1690 * <ul> |
1690 * <ul> |
1691 * <p>This method looks in the provided <var>environment</var> for |
1691 * <li>This method looks in the provided <var>environment</var> for |
1692 * the "java.naming.corba.orb" property. If it is found, the |
1692 * the "java.naming.corba.orb" property. If it is found, the |
1693 * referenced object (an {@link org.omg.CORBA.ORB ORB}) is used to |
1693 * referenced object (an {@link org.omg.CORBA.ORB ORB}) is used to |
1694 * connect the stub. Otherwise, a new org.omg.CORBA.ORB is created |
1694 * connect the stub. Otherwise, a new org.omg.CORBA.ORB is created |
1695 * by calling {@link |
1695 * by calling {@link |
1696 * org.omg.CORBA.ORB#init(String[], Properties) |
1696 * org.omg.CORBA.ORB#init(String[], Properties) |
1697 * org.omg.CORBA.ORB.init((String[])null,(Properties)null)} |
1697 * org.omg.CORBA.ORB.init((String[])null,(Properties)null)}</li> |
1698 * <p>The new created ORB is kept in a static |
1698 * <li>The new created ORB is kept in a static |
1699 * {@link WeakReference} and can be reused for connecting other |
1699 * {@link WeakReference} and can be reused for connecting other |
1700 * stubs. However, no reference is ever kept on the ORB provided |
1700 * stubs. However, no reference is ever kept on the ORB provided |
1701 * in the <var>environment</var> map, if any. |
1701 * in the <var>environment</var> map, if any.</li> |
1702 * </ul> |
1702 * </ul> |
1703 * @param rmiServer A RMI Server Stub. |
1703 * @param rmiServer A RMI Server Stub. |
1704 * @param environment An environment map, possibly containing an ORB. |
1704 * @param environment An environment map, possibly containing an ORB. |
1705 * @return the given stub. |
1705 * @return the given stub. |
1706 * @exception IllegalArgumentException if the |
1706 * @exception IllegalArgumentException if the |