< prev index next >

src/java.corba/share/classes/com/sun/jndi/cosnaming/CorbanameUrl.java

Print this page

        

*** 33,68 **** /** * Extract components of a "corbaname" URL. * * The format of an corbaname URL is defined in INS 99-12-03 as follows. ! *<p> * corbaname url = "corbaname:" <corbaloc_obj> ["#" <string_name>] * corbaloc_obj = <obj_addr_list> ["/" <key_string>] * obj_addr_list = as defined in a corbaloc URL * key_string = as defined in a corbaloc URL * string_name = stringified COS name | empty_string ! *<p> ! * Characters in <string_name> are escaped as follows. * US-ASCII alphanumeric characters are not escaped. Any characters outside * of this range are escaped except for the following: * ; / : ? @ & = + $ , - _ . ! ~ * ; ( ) * Escaped characters is escaped by using a % followed by its 2 hexadecimal * numbers representing the octet. ! *<p> * The corbaname URL is parsed into two parts: a corbaloc URL and a COS name. ! * The corbaloc URL is constructed by concatenation "corbaloc:" with ! * <corbaloc_obj>. ! * The COS name is <string_name> with the escaped characters resolved. ! *<p> * A corbaname URL is resolved by: ! *<ol> ! *<li>Construct a corbaloc URL by concatenating "corbaloc:" and <corbaloc_obj>. ! *<li>Resolve the corbaloc URL to a NamingContext by using * nctx = ORB.string_to_object(corbalocUrl); ! *<li>Resolve <string_name> in the NamingContext. ! *</ol> * * @author Rosanna Lee */ public final class CorbanameUrl { --- 33,72 ---- /** * Extract components of a "corbaname" URL. * * The format of an corbaname URL is defined in INS 99-12-03 as follows. ! * <pre>{@code * corbaname url = "corbaname:" <corbaloc_obj> ["#" <string_name>] * corbaloc_obj = <obj_addr_list> ["/" <key_string>] * obj_addr_list = as defined in a corbaloc URL * key_string = as defined in a corbaloc URL * string_name = stringified COS name | empty_string ! * }</pre> ! * Characters in {@code <string_name>} are escaped as follows. * US-ASCII alphanumeric characters are not escaped. Any characters outside * of this range are escaped except for the following: + * <pre>{@code * ; / : ? @ & = + $ , - _ . ! ~ * ; ( ) + * }</pre> * Escaped characters is escaped by using a % followed by its 2 hexadecimal * numbers representing the octet. ! * <p> * The corbaname URL is parsed into two parts: a corbaloc URL and a COS name. ! * The corbaloc URL is constructed by concatenation {@code "corbaloc:"} with ! * {@code <corbaloc_obj>}. ! * The COS name is {@code <string_name>} with the escaped characters resolved. ! * <p> * A corbaname URL is resolved by: ! * <ol> ! * <li>Construct a corbaloc URL by concatenating {@code "corbaloc:"} and {@code <corbaloc_obj>}. ! * <li>Resolve the corbaloc URL to a NamingContext by using ! * <pre>{@code * nctx = ORB.string_to_object(corbalocUrl); ! * }</pre> ! * <li>Resolve {@code <string_name>} in the NamingContext. ! * </ol> * * @author Rosanna Lee */ public final class CorbanameUrl {
< prev index next >