jdk-sandbox: comparison jdk/src/java.management/share/classes/javax/management/remote/rmi/RMIConnector.java

equal deleted inserted replaced

-:bf24e33c7919
+:05676cfd40b5
 this.env = Collections.unmodifiableMap(environment);
 }
 }
 /**
-* <p>Constructs an <code>RMIConnector</code> that will connect
+* <p>Constructs an {@code RMIConnector} that will connect
 * the RMI connector server with the given address.</p>
 *
 * <p>The address can refer directly to the connector server,
 * using one of the following syntaxes:</p>
 *
 * <pre>
 * service:jmx:rmi://<em>[host[:port]]</em>/stub/<em>encoded-stub</em>
 * service:jmx:iiop://<em>[host[:port]]</em>/ior/<em>encoded-IOR</em>
 * </pre>
 *
-* <p>(Here, the square brackets <code>[]</code> are not part of the
+* <p>(Here, the square brackets {@code []} are not part of the
 * address but indicate that the host and port are optional.)</p>
 *
 * <p>The address can instead indicate where to find an RMI stub
 * through JNDI, using one of the following syntaxes:</p>
 *
 * the connection.  For JNDI-based addresses, these attributes can
 * usefully include JNDI attributes recognized by {@link
 * InitialContext#InitialContext(Hashtable) InitialContext}.  This
 * parameter can be null, which is equivalent to an empty Map.
 *
-* @exception IllegalArgumentException if <code>url</code>
+* @exception IllegalArgumentException if {@code url}
 * is null.
 */
 public RMIConnector(JMXServiceURL url, Map<String,?> environment) {
 this(null, url, environment);
 }
 /**
-* <p>Constructs an <code>RMIConnector</code> using the given RMI stub.
+* <p>Constructs an {@code RMIConnector} using the given RMI stub.
 *
 * @param rmiServer an RMI stub representing the RMI connector server.
 * @param environment additional attributes specifying how to make
 * the connection.  This parameter can be null, which is
 * equivalent to an empty Map.
 *
-* @exception IllegalArgumentException if <code>rmiServer</code>
+* @exception IllegalArgumentException if {@code rmiServer}
 * is null.
 */
 public RMIConnector(RMIServer rmiServer, Map<String,?> environment) {
 this(rmiServer, null, environment);
 }
 /**
 * <p>Returns a string representation of this object.  In general,
-* the <code>toString</code> method returns a string that
+* the {@code toString} method returns a string that
 * "textually represents" this object. The result should be a
 * concise but informative representation that is easy for a
 * person to read.</p>
 *
 * @return a String representation of this object.
 * </ul>
 * @param rmiServer A RMI Server Stub.
 * @param environment An environment map, possibly containing an ORB.
 * @return the given stub.
 * @exception IllegalArgumentException if the
-*      <tt>java.naming.corba.orb</tt> property is specified and
+*      {@code java.naming.corba.orb} property is specified and
 *      does not point to an {@link org.omg.CORBA.ORB ORB}.
 * @exception IOException if the connection to the ORB failed.
 **/
 static RMIServer connectStub(RMIServer rmiServer,
 Map<String, ?> environment)
 * stubs. However, no reference is ever kept on the ORB provided
 * in the <var>environment</var> map, if any.
 * @param environment An environment map, possibly containing an ORB.
 * @return An ORB.
 * @exception IllegalArgumentException if the
-*      <tt>java.naming.corba.orb</tt> property is specified and
+*      {@code java.naming.corba.orb} property is specified and
 *      does not point to an {@link org.omg.CORBA.ORB ORB}.
 * @exception IOException if the ORB initialization failed.
 **/
 static Object resolveOrb(Map<String, ?> environment)
 throws IOException {
 }
 /**
 * Read RMIConnector fields from an {@link java.io.ObjectInputStream
 * ObjectInputStream}.
-* Calls <code>s.defaultReadObject()</code> and then initializes
+* Calls {@code s.defaultReadObject()} and then initializes
 * all transient variables that need initializing.
 * @param s The ObjectInputStream to read from.
 * @exception InvalidObjectException if none of <var>rmiServer</var> stub
 *    or <var>jmxServiceURL</var> are set.
 * @see #RMIConnector(JMXServiceURL,Map)
 * ObjectOutputStream}.
 * <p>Connects the underlying RMIServer stub to an ORB, if needed,
 * before serializing it. This is done using the environment
 * map that was provided to the constructor, if any, and as documented
 * in {@link javax.management.remote.rmi}.</p>
-* <p>This method then calls <code>s.defaultWriteObject()</code>.
+* <p>This method then calls {@code s.defaultWriteObject()}.
 * Usually, <var>rmiServer</var> is null if this object
 * was constructed with a JMXServiceURL, and <var>jmxServiceURL</var>
 * is null if this object is constructed with a RMIServer stub.
 * <p>Note that the environment Map is not serialized, since the objects
 * it contains are assumed to be contextual and relevant only
 /**
 * Lookup the RMIServer stub in a directory.
 * @param jndiURL A JNDI URL indicating the location of the Stub
 *                (see {@link javax.management.remote.rmi}), e.g.:
-*   <ul><li><tt>rmi://registry-host:port/rmi-stub-name</tt></li>
+*   <ul><li>{@code rmi://registry-host:port/rmi-stub-name}</li>
-*       <li>or <tt>iiop://cosnaming-host:port/iiop-stub-name</tt></li>
+*       <li>or {@code iiop://cosnaming-host:port/iiop-stub-name}</li>
-*       <li>or <tt>ldap://ldap-host:port/java-container-dn</tt></li>
+*       <li>or {@code ldap://ldap-host:port/java-container-dn}</li>
 *   </ul>
 * @param env the environment Map passed to the connector.
 * @param isIiop true if the stub is expected to be an IIOP stub.
 * @return The retrieved RMIServer stub.
 * @exception NamingException if the stub couldn't be found.

changeset 32034	05676cfd40b5
parent 26594	b561a19107c7
child 32639	339de1317e84