QName.java

Go to the documentation of this file.

/*
 * Javolution - Java(TM) Solution for Real-Time and Embedded Systems
 * Copyright (C) 2007 - Javolution (http://javolution.org/)
 * All rights reserved.
 * 
 * Permission to use, copy, modify, and distribute this software is
 * freely granted, provided that this notice is preserved.
 */
package javolution.xml;
 
import java.io.ObjectStreamException;
import java.lang.CharSequence;
 
import javolution.lang.Immutable;
import javolution.text.CharArray;
import javolution.text.TextBuilder;
import javolution.util.FastMap;
import javolution.util.function.Equalities;
 
public final class QName implements XMLSerializable, Immutable<QName>, CharSequence {
 
    private transient final CharArray _localName;
 
    private transient final CharArray _namespaceURI;
 
    private final String _toString;
 
    private static final FastMap<CharSequence, QName> FULL_NAME_TO_QNAME = new FastMap<CharSequence, QName>(
            Equalities.LEXICAL);
 
    private QName(String namespaceURI, String localName, String toString) {
        _namespaceURI = (namespaceURI == null) ? null : new CharArray(
                namespaceURI);
        _localName = new CharArray(localName);
        _toString = toString;
    }
 
    public static QName valueOf(CharSequence name) {
        QName qName = (QName) FULL_NAME_TO_QNAME.get(name);
        return (qName != null) ? qName : QName.createNoNamespace(name
                .toString());
    }
 
    private static QName createNoNamespace(String name) {
        String localName = name;
        String namespaceURI = null;
        if (name.length() > 0 && name.charAt(0) == '{') { // Namespace URI.
            int index = name.lastIndexOf('}');
            localName = name.substring(index + 1);
            namespaceURI = name.substring(1, index);
        }
        QName qName = new QName(namespaceURI, localName, name);
        synchronized (FULL_NAME_TO_QNAME) {
            QName tmp = (QName) FULL_NAME_TO_QNAME.putIfAbsent(name, qName);
            return tmp == null ? qName : tmp;
        }
    }
 
    public static QName valueOf(String name) {
        QName qName = (QName) FULL_NAME_TO_QNAME.get(name);
        return (qName != null) ? qName : QName.createNoNamespace(name);
    }
 
    public static QName valueOf(CharSequence namespaceURI,
            CharSequence localName) {
        if (namespaceURI == null)
            return QName.valueOf(localName);
        TextBuilder tmp = new TextBuilder();
        tmp.append('{');
        tmp.append(namespaceURI);
        tmp.append('}');
        tmp.append(localName);
        return QName.valueOf(tmp);
    }
 
    public CharSequence getLocalName() {
        return _localName;
    }
 
    public CharSequence getNamespaceURI() {
        return _namespaceURI;
    }
 
    public boolean equals(Object obj) {
        return this == obj;
    }
 
    public String toString() {
        return _toString;
    }
 
    public int hashCode() {
        return _toString.hashCode();
    }
 
    public char charAt(int index) {
        return _toString.charAt(index);
    }
 
    public int length() {
        return _toString.length();
    }
 
    public CharSequence subSequence(int start, int end) {
        return _toString.substring(start, end);
    }
 
    //Maintains unicity.
    private Object readResolve() throws ObjectStreamException {
        return QName.valueOf(_toString);
    }
 
    private static final long serialVersionUID = -6126031630693748647L;
 
    @Override
    public QName value() {
        return this;
    }
 
}