org.apache.directory.api.ldap.model.name

Enum FastDnParser

java.lang.Object

java.lang.Enum<FastDnParser>

org.apache.directory.api.ldap.model.name.FastDnParser

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<FastDnParser>

 enum FastDnParser
extends java.lang.Enum<FastDnParser>

A fast LDAP Dn parser that handles only simple DNs. If the Dn contains any special character an TooComplexException is thrown.

Enum Constant Summary

Enum Constants

Enum Constant and Description
INSTANCE

Method Summary

Modifier and Type	Method and Description
private static boolean	hasMoreChars(Position pos) Checks if there are more characters.
private static java.lang.String	matchAttributeType(char[] name, Position pos) Matches attribute type.
private static java.lang.String	matchAttributeTypeDescr(char[] name, Position pos) Matches attribute type descr.
private static java.lang.String	matchAttributeTypeNumericOid(char[] name, Position pos) Matches attribute type numeric OID.
private static void	matchEquals(char[] name, Position pos) Matches the equals character.
private static void	matchSpaces(char[] name, Position pos) Matches and forgets optional spaces.
private static java.lang.String	matchValue(char[] name, Position pos) Matches the assertion value.
private static char	nextChar(char[] name, Position pos, boolean increment) Gets the next character.
(package private) static Dn	parse(java.lang.String name) Parses a Dn from a String
(package private) static void	parseDn(java.lang.String name, Dn dn) Parses the given name string and fills the given Dn object.
(package private) static void	parseDn(java.lang.String name, java.util.List<Rdn> rdns)
(package private) static void	parseRdn(java.lang.String name, Rdn rdn) Parses the given name string and fills the given Rdn object.
private static void	parseRdnInternal(java.lang.String name, Position pos, Rdn rdn)
static FastDnParser	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static FastDnParser[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

INSTANCE

public static final FastDnParser INSTANCE

Method Detail

values

public static FastDnParser[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (FastDnParser c : FastDnParser.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static FastDnParser valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

parse

static Dn parse(java.lang.String name)
         throws LdapException

Parses a Dn from a String

Parameters:

name - The Dn to parse

Returns:

A valid Dn

Throws:

LdapException - If the Dn was invalid

parseDn

static void parseDn(java.lang.String name,
                    Dn dn)
             throws LdapInvalidDnException

Parses the given name string and fills the given Dn object.

Parameters:

name - the name to parse

dn - the Dn to fill

Throws:

LdapInvalidDnException - the invalid name exception

parseDn

static void parseDn(java.lang.String name,
                    java.util.List<Rdn> rdns)
             throws LdapInvalidDnException

Throws:

LdapInvalidDnException

parseRdn

static void parseRdn(java.lang.String name,
                     Rdn rdn)
              throws LdapInvalidDnException

Parses the given name string and fills the given Rdn object.

Parameters:

name - the name to parse

rdn - the Rdn to fill

Throws:

LdapInvalidDnException - the invalid name exception

parseRdnInternal

private static void parseRdnInternal(java.lang.String name,
                                     Position pos,
                                     Rdn rdn)
                              throws LdapInvalidDnException

Throws:

LdapInvalidDnException

matchSpaces

private static void matchSpaces(char[] name,
                                Position pos)
                         throws LdapInvalidDnException

Matches and forgets optional spaces.

Parameters:

name - the name

pos - the pos

Throws:

LdapInvalidDnException

matchAttributeType

private static java.lang.String matchAttributeType(char[] name,
                                                   Position pos)
                                            throws LdapInvalidDnException

Matches attribute type.

Parameters:

name - the name

pos - the pos

Returns:

the matched attribute type

Throws:

LdapInvalidDnException - the invalid name exception

matchAttributeTypeDescr

private static java.lang.String matchAttributeTypeDescr(char[] name,
                                                        Position pos)
                                                 throws LdapInvalidDnException

Matches attribute type descr.

Parameters:

name - the name

pos - the pos

Returns:

the attribute type descr

Throws:

LdapInvalidDnException - the invalid name exception

matchAttributeTypeNumericOid

private static java.lang.String matchAttributeTypeNumericOid(char[] name,
                                                             Position pos)
                                                      throws LdapInvalidDnException

Matches attribute type numeric OID.

Parameters:

name - the name

pos - the pos

Returns:

the attribute type OID

Throws:

LdapInvalidDnException - the invalid name exception

matchEquals

private static void matchEquals(char[] name,
                                Position pos)
                         throws LdapInvalidDnException

Matches the equals character.

Parameters:

name - the name

pos - the pos

Throws:

LdapInvalidDnException - the invalid name exception

matchValue

private static java.lang.String matchValue(char[] name,
                                           Position pos)
                                    throws LdapInvalidDnException

Matches the assertion value. This method only handles simple values. If we find any special character (BACKSLASH, PLUS, SHARP or DQUOTE), a TooComplexException will be thrown.

Parameters:

name - the name

pos - the pos

Returns:

the string

Throws:

LdapInvalidDnException - the invalid name exception

nextChar

private static char nextChar(char[] name,
                             Position pos,
                             boolean increment)
                      throws LdapInvalidDnException

Gets the next character.

Parameters:

name - the name

pos - the pos

increment - true to increment the position

Returns:

the character

Throws:

LdapInvalidDnException - If no more characters are available

hasMoreChars

private static boolean hasMoreChars(Position pos)

Checks if there are more characters.

Parameters:

pos - the pos

Returns:

true, if more characters are available