org.hippoecm.repository.api

Class StringCodecFactory.NameEncoding

java.lang.Object

org.hippoecm.repository.api.StringCodecFactory.NameEncoding

All Implemented Interfaces:

StringCodec

Enclosing class:

StringCodecFactory

public static class StringCodecFactory.NameEncoding
extends Object
implements StringCodec

Helper class for encoding and decoding node names

Implements the encode and decode routines based on ISO 9075-14:2003 for node names.It encodes and decode the minimal set to garanty the node names are jcr valid.
If a character c is not valid in the node name it is encoded in the form: '_x' + hexValueOf(c) + '_' (UTF-16). It only

If a node name string is encoded twice or decoded twice it should return the same string. If a node name string doesn't contain invalid characters the encode functions should return the string itself. If a string doesn't contain any encoded chars it should return the string itself. Eg:

• decode(encode(x)) = x
• encode(decode(x)) = x
• encode(encode(x)) = encode(x)
• decode(decode(x)) = decode(x)
• encode(valid_chars) = valid_chars

Qualified name: a qualified name is a combination of a namespace URI and a local part. Instances of this class are used to internally represent the names of JCR content items and other objects within a content repository.

The prefixed JCR name format of a qualified name is specified by section 4.6 of the the JCR 1.0 specification (JSR 170) as follows:

 name                ::= simplename | prefixedname
 simplename          ::= onecharsimplename |
                         twocharsimplename |
                         threeormorecharname
 prefixedname        ::= prefix ':' localname
 localname           ::= onecharlocalname |
                         twocharlocalname |
                         threeormorecharname
 onecharsimplename   ::= (* Any Unicode character except:
                            '.', '/', ':', '[', ']', '*',
                           ''', '"', '|' or any whitespace
                            character *)
 twocharsimplename   ::= '.' onecharsimplename |
                         onecharsimplename '.' |
                         onecharsimplename onecharsimplename
 onecharlocalname    ::= nonspace
 twocharlocalname    ::= nonspace nonspace
 threeormorecharname ::= nonspace string nonspace
 prefix              ::= (* Any valid non-empty XML NCName *)
 string              ::= char | string char
 char                ::= nonspace | ' '
 nonspace            ::= (* Any Unicode character except:
                            '/', ':', '[', ']', '*',
                            ''', '"', '|' or any whitespace
                            character *)
 

Constructor Summary

Constructors

Constructor and Description
NameEncoding()

Method Summary

Modifier and Type	Method and Description
String	decode(String name) Decode the name string with the ISO9075 coding standard.
String	encode(char c) Encode the char to a valid JCR string.
String	encode(String name) Encode the name to a valid JCR name, it is not possible to specify a namespace, any passed namespace prefix will be encoded as well

Methods inherited from class java.lang.Object

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

Constructor Detail

NameEncoding

public NameEncoding()

Method Detail

encode

public final String encode(char c)

Encode the char to a valid JCR string.

Calling encode multiple times on the same string will return the same result as encoding the string once.

Parameters:

c - the char to encode

Returns:

the encoded char as string

encode

public final String encode(String name)

Encode the name to a valid JCR name, it is not possible to specify a namespace, any passed namespace prefix will be encoded as well

Calling encode multiple times on the same string will return the same result as encoding the string once.

An IllegalArgumentException is thrown when the name is empty or null.

Specified by:

encode in interface StringCodec

Parameters:

name - the name to encode

Returns:

the encoded name

decode

public String decode(String name)

Decode the name string with the ISO9075 coding standard.

Calling decode multiple times on the same string will return the same result as decoding the string once.

Specified by:

decode in interface StringCodec

Parameters:

name - the name to decode

Returns:

the decoded name