javax.naming

public Interface NameParser

Known Direct Implementers: com.sun.jndi.ldap.LdapNameParser, com.sun.jndi.toolkit.dir.HierarchicalNameParser

This interface is used for parsing names from a hierarchical namespace. The NameParser contains knowledge of the syntactic information (like left-to-right orientation, name separator, etc.) needed to parse names. The equals() method, when used to compare two NameParsers, returns true if and only if they serve the same namespace.

Authors: Rosanna Lee, Scott Seligman
Since: 1.3
See Also: CompoundName, Name

Method Summary

Modifier and Type	Method and Description
public Name	Returns: A non-null parsed form of the name using the naming convention of this parser. parse(String The non-null string name to parse. name) Parses a name into its components.

Method Detail

parse	back to summary
public Name parse(String name) throws NamingException Parses a name into its components. Parameters name:String The non-null string name to parse. Returns:Name A non-null parsed form of the name using the naming convention of this parser. Exceptions NamingException: If a naming exception was encountered. InvalidNameException: If name does not conform to syntax defined for the namespace.

parse

back to summary

public Name parse(String name) throws NamingException

Parses a name into its components.

Parameters

name:String: The non-null string name to parse.

Returns:Name

A non-null parsed form of the name using the naming convention of this parser.

Exceptions

NamingException:: If a naming exception was encountered.
InvalidNameException:: If name does not conform to syntax defined for the namespace.