com.goldencode.p2j.directory

Class IdUtils

java.lang.Object

com.goldencode.p2j.directory.IdUtils

public class IdUtils
extends java.lang.Object

A set of useful static routines to handle node and other IDs.

Author:

SIY

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static java.lang.String	valid Characters allowed in the node name.

Constructor Summary

Constructors

Constructor and Description
IdUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.String[]	listPaths(java.lang.String nodeId) Generate a list of partial paths starting from root to specified node ID.
static java.lang.String	normalize(java.lang.String nodeId) This method check nodeId validness and returns it in normalized form /elem0/elem2/.../elemN.
(package private) static java.lang.String[]	splitId(java.lang.String id) Split path into parent id and node name.
static java.lang.String	upcaseFirst(java.lang.String str) Uppercase first letter in the given string.
private static boolean	verifyChars(java.lang.String string) Validate string content.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

valid

static final java.lang.String valid

Characters allowed in the node name.

See Also:

Constant Field Values

Constructor Detail

IdUtils

public IdUtils()

Method Detail

listPaths

public static java.lang.String[] listPaths(java.lang.String nodeId)

Generate a list of partial paths starting from root to specified node ID. For example, nodeId /security/users/siy will produce following set:
/security
/security/users
/security/users/siy

Parameters:

nodeId - Node ID to normalize.

Returns:

An array of normalized node IDs or null if node ID is invalid.

normalize

public static java.lang.String normalize(java.lang.String nodeId)

This method check nodeId validness and returns it in normalized form /elem0/elem2/.../elemN. All redundant forward slashes are removed. If leading slash is omitted then path is assumed invalid.

Parameters:

nodeId - Node ID to normalize.

Returns:

Normalized node ID or null if node ID is invalid.

upcaseFirst

public static java.lang.String upcaseFirst(java.lang.String str)

Uppercase first letter in the given string. If string contains dashes, they are removed and each new part after dash is changed to upper case.

For example:
xml will be converted to Xml
xml-ldap will be converted to XmlLdap
xml-ldap-sql will be converted to XmlLdapSql

Parameters:

str - Source string.

Returns:

Source string with first character converted to the upper case.

splitId

static java.lang.String[] splitId(java.lang.String id)

Split path into parent id and node name. Note that for root node it returns null since there is no parent for the root node.

Parameters:

id - Node id.

Returns:

Array with two elements, first contains id of root node, second contains node id. If something is wrong with path then null is returned.

verifyChars

private static boolean verifyChars(java.lang.String string)

Validate string content.

Parameters:

string - Source string.

Returns:

true if string contains only allowed characters and false otherwise.