1. /*

  2.  * @(#)NameParser.java	1.4 00/02/02

  3.  *

  4.  * Copyright 1999, 2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package javax.naming;

  12. 

  13. /**

  14.   * This interface is used for parsing names from a hierarchical

  15.   * namespace.  The NameParser contains knowledge of the syntactic

  16.   * information (like left-to-right orientation, name separator, etc.)

  17.   * needed to parse names.

  18.   *

  19.   * The equals() method, when used to compare two NameParsers, returns

  20.   * true if and only if they serve the same namespace.

  21.   *

  22.   * @author Rosanna Lee

  23.   * @author Scott Seligman

  24.   * @version 1.4 00/02/02

  25.   *

  26.   * @see CompoundName

  27.   * @see Name

  28.   * @since 1.3

  29.   */

  30. 

  31. public interface NameParser {

  32. 	/**

  33. 	  * Parses a name into its components.

  34. 	  *

  35. 	  * @param name The non-null string name to parse.

  36. 	  * @return A non-null parsed form of the name using the naming convention

  37. 	  * of this parser.

  38.           * @exception InvalidNameException If name does not conform to

  39.           * 	syntax defined for the namespace.

  40.           * @exception NamingException If a naming exception was encountered.

  41. 	  */

  42. 	Name parse(String name)	throws NamingException;

  43. }