org.apache.jackrabbit.spi.commons.conversion

Class PathParser

java.lang.Object

org.apache.jackrabbit.spi.commons.conversion.PathParser

public class PathParser
extends Object

PathParser formats a Path using a NameResolver and a PathFactory.

Constructor Summary

Constructors

Constructor and Description
PathParser()

Method Summary

Modifier and Type	Method and Description
static void	checkFormat(String jcrPath) Check the format of the given jcr path.
static Path	parse(Path parent, String jcrPath, NameResolver nameResolver, IdentifierResolver identifierResolver, PathFactory factory) Parses the given jcrPath and returns a Path.
static Path	parse(Path parent, String jcrPath, NameResolver resolver, PathFactory factory) Parses the given jcrPath and returns a Path.
static Path	parse(String jcrPath, NameResolver nameResolver, IdentifierResolver identifierResolver, PathFactory factory) Parses jcrPath into a Path object using resolver to convert prefixes into namespace URIs.
static Path	parse(String jcrPath, NameResolver nameResolver, IdentifierResolver identifierResolver, PathFactory factory, boolean normalizeIdentifier) Parses jcrPath into a Path object using resolver to convert prefixes into namespace URIs.
static Path	parse(String jcrPath, NameResolver resolver, PathFactory factory) Parses jcrPath into a Path object using resolver to convert prefixes into namespace URIs.

Methods inherited from class java.lang.Object

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

Constructor Detail

PathParser

public PathParser()

Method Detail

parse

public static Path parse(String jcrPath,
                         NameResolver resolver,
                         PathFactory factory)
                  throws MalformedPathException,
                         IllegalNameException,
                         NamespaceException

Parses jcrPath into a Path object using resolver to convert prefixes into namespace URIs. If resolver is null this method only checks the format of the passed String and returns null.

Parameters:

jcrPath - the jcr path.

resolver - the namespace resolver.

factory - PathFactory to be used.

Returns:

A path object.

Throws:

MalformedPathException - If the jcrPath is malformed.

IllegalNameException - if any of the jcrNames is malformed.

NamespaceException - If an unresolvable prefix is encountered.

parse

public static Path parse(String jcrPath,
                         NameResolver nameResolver,
                         IdentifierResolver identifierResolver,
                         PathFactory factory)
                  throws MalformedPathException,
                         IllegalNameException,
                         NamespaceException

Parses jcrPath into a Path object using resolver to convert prefixes into namespace URIs. If the specified jcrPath is an identifier based absolute path beginning with an identifier segment the specified IdentifierResolver will be used to resolve it to an absolute path.

If namResolver is null or if identifierResolver is null and the path starts with an identifier segment, this method only checks the format of the string and returns null.

Parameters:

jcrPath - the jcr path.

nameResolver - the namespace resolver.

identifierResolver - the resolver to validate any trailing identifier segment and resolve to an absolute path.

factory -

Returns:

A path object.

Throws:

MalformedPathException - If the jcrPath is malformed.

IllegalNameException - if any of the jcrNames is malformed.

NamespaceException - If an unresolvable prefix is encountered.

Since:

JCR 2.0

parse

public static Path parse(String jcrPath,
                         NameResolver nameResolver,
                         IdentifierResolver identifierResolver,
                         PathFactory factory,
                         boolean normalizeIdentifier)
                  throws MalformedPathException,
                         IllegalNameException,
                         NamespaceException

Parses jcrPath into a Path object using resolver to convert prefixes into namespace URIs. If the specified jcrPath is an identifier based absolute path beginning with an identifier segment the specified IdentifierResolver will be used to resolve it to an absolute path.

If namResolver is null or if identifierResolver is null and the path starts with an identifier segment, this method only checks the format of the string and returns null.

Parameters:

jcrPath - the jcr path.

nameResolver - the namespace resolver.

identifierResolver - the resolver to validate any trailing identifier segment and resolve to an absolute path.

factory -

normalizeIdentifier -

Returns:

A path object.

Throws:

MalformedPathException - If the jcrPath is malformed.

IllegalNameException - if any of the jcrNames is malformed.

NamespaceException - If an unresolvable prefix is encountered.

Since:

JCR 2.0

parse

public static Path parse(Path parent,
                         String jcrPath,
                         NameResolver resolver,
                         PathFactory factory)
                  throws MalformedPathException,
                         IllegalNameException,
                         NamespaceException

Parses the given jcrPath and returns a Path. If parent is not null, it is prepended to the built path before it is returned. If resolver is null, this method only checks the format of the string and returns null.

Parameters:

parent - the parent path

jcrPath - the JCR path

resolver - the namespace resolver to get prefixes for namespace URIs.

factory -

Returns:

the Path object.

Throws:

MalformedPathException - If the jcrPath is malformed.

IllegalNameException - if any of the jcrNames is malformed.

NamespaceException - If an unresolvable prefix is encountered.

parse

public static Path parse(Path parent,
                         String jcrPath,
                         NameResolver nameResolver,
                         IdentifierResolver identifierResolver,
                         PathFactory factory)
                  throws MalformedPathException,
                         IllegalNameException,
                         NamespaceException

Parses the given jcrPath and returns a Path. If parent is not null, it is prepended to the built path before it is returned. If the specified jcrPath is an identifier based absolute path beginning with an identifier segment the given identifierResolver will be used to resolve it to an absolute path.

If nameResolver is null or if identifierResolver is null and the path starts with an identifier segment, this method only checks the format of the string and returns null.

Parameters:

parent - the parent path.

jcrPath - the jcr path.

nameResolver - the namespace resolver.

identifierResolver - the resolver to validate any trailing identifier segment and resolve it to an absolute path.

factory - The path factory.

Returns:

the Path object.

Throws:

MalformedPathException

IllegalNameException

NamespaceException

checkFormat

public static void checkFormat(String jcrPath)
                        throws MalformedPathException

Check the format of the given jcr path. Note, the neither name nor namespace validation (resolution of prefix to URI) is performed and therefore will not be detected.

Parameters:

jcrPath -

Throws:

MalformedPathException - If the jcrPath is malformed.