aoqi@0: /* aoqi@0: * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved. aoqi@0: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. aoqi@0: * aoqi@0: * This code is free software; you can redistribute it and/or modify it aoqi@0: * under the terms of the GNU General Public License version 2 only, as aoqi@0: * published by the Free Software Foundation. Oracle designates this aoqi@0: * particular file as subject to the "Classpath" exception as provided aoqi@0: * by Oracle in the LICENSE file that accompanied this code. aoqi@0: * aoqi@0: * This code is distributed in the hope that it will be useful, but WITHOUT aoqi@0: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or aoqi@0: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License aoqi@0: * version 2 for more details (a copy is included in the LICENSE file that aoqi@0: * accompanied this code). aoqi@0: * aoqi@0: * You should have received a copy of the GNU General Public License version aoqi@0: * 2 along with this work; if not, write to the Free Software Foundation, aoqi@0: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. aoqi@0: * aoqi@0: * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA aoqi@0: * or visit www.oracle.com if you need additional information or have any aoqi@0: * questions. aoqi@0: */ aoqi@0: /* aoqi@0: * Copyright (C) 2004-2011 aoqi@0: * aoqi@0: * Permission is hereby granted, free of charge, to any person obtaining a copy aoqi@0: * of this software and associated documentation files (the "Software"), to deal aoqi@0: * in the Software without restriction, including without limitation the rights aoqi@0: * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell aoqi@0: * copies of the Software, and to permit persons to whom the Software is aoqi@0: * furnished to do so, subject to the following conditions: aoqi@0: * aoqi@0: * The above copyright notice and this permission notice shall be included in aoqi@0: * all copies or substantial portions of the Software. aoqi@0: * aoqi@0: * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR aoqi@0: * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, aoqi@0: * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE aoqi@0: * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER aoqi@0: * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, aoqi@0: * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN aoqi@0: * THE SOFTWARE. aoqi@0: */ aoqi@0: package com.sun.xml.internal.rngom.digested; aoqi@0: aoqi@0: import org.xml.sax.Locator; aoqi@0: import org.w3c.dom.Element; aoqi@0: aoqi@0: import javax.xml.namespace.QName; aoqi@0: import java.util.Map; aoqi@0: import java.util.HashMap; aoqi@0: import java.util.List; aoqi@0: import java.util.ArrayList; aoqi@0: import java.util.Collections; aoqi@0: aoqi@0: /** aoqi@0: * Annotation. aoqi@0: * aoqi@0: * @author Kohsuke Kawaguchi (kk@kohsuke.org) aoqi@0: */ aoqi@0: public class DAnnotation { aoqi@0: aoqi@0: /** aoqi@0: * Instance reserved to be empty. aoqi@0: */ aoqi@0: static final DAnnotation EMPTY = new DAnnotation(); aoqi@0: aoqi@0: /** aoqi@0: * Keyed by QName. aoqi@0: */ aoqi@0: final Map attributes = new HashMap(); aoqi@0: aoqi@0: /** aoqi@0: * List of nested elements. aoqi@0: */ aoqi@0: final List contents = new ArrayList(); aoqi@0: aoqi@0: /** aoqi@0: * Attribute. aoqi@0: */ aoqi@0: public static class Attribute { aoqi@0: private final String ns; aoqi@0: private final String localName; aoqi@0: private final String prefix; aoqi@0: aoqi@0: private String value; aoqi@0: private Locator loc; aoqi@0: aoqi@0: public Attribute(String ns, String localName, String prefix) { aoqi@0: this.ns = ns; aoqi@0: this.localName = localName; aoqi@0: this.prefix = prefix; aoqi@0: } aoqi@0: aoqi@0: public Attribute(String ns, String localName, String prefix, String value, Locator loc) { aoqi@0: this.ns = ns; aoqi@0: this.localName = localName; aoqi@0: this.prefix = prefix; aoqi@0: this.value = value; aoqi@0: this.loc = loc; aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the namespace URI of this attribute. aoqi@0: * aoqi@0: * @return aoqi@0: * can be empty (to represent the default namespace), but never null. aoqi@0: */ aoqi@0: public String getNs() { aoqi@0: return ns; aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the local name of this attribute. aoqi@0: * aoqi@0: * @return aoqi@0: * always non-null. aoqi@0: */ aoqi@0: public String getLocalName() { aoqi@0: return localName; aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the prefix of thie attribute. aoqi@0: * aoqi@0: * @return aoqi@0: * null if this attribute didn't have a prefix. aoqi@0: */ aoqi@0: public String getPrefix() { aoqi@0: return prefix; aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the attribute value. aoqi@0: * aoqi@0: * @return aoqi@0: * never null. aoqi@0: */ aoqi@0: public String getValue() { aoqi@0: return value; aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the location in the source schema file where this annotation was present. aoqi@0: * aoqi@0: * @return aoqi@0: * never null. aoqi@0: */ aoqi@0: public Locator getLoc() { aoqi@0: return loc; aoqi@0: } aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the attribute of a given name. aoqi@0: * aoqi@0: * @param nsUri aoqi@0: * can be empty but must not be null. aoqi@0: * @return aoqi@0: * null if no such attribute is found. aoqi@0: */ aoqi@0: public Attribute getAttribute( String nsUri, String localName ) { aoqi@0: return getAttribute(new QName(nsUri,localName)); aoqi@0: } aoqi@0: aoqi@0: public Attribute getAttribute( QName n ) { aoqi@0: return attributes.get(n); aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the read-only view of all the attributes. aoqi@0: * aoqi@0: * @return aoqi@0: * can be empty but never null. aoqi@0: * the returned map is read-only. aoqi@0: */ aoqi@0: public Map getAttributes() { aoqi@0: return Collections.unmodifiableMap(attributes); aoqi@0: } aoqi@0: aoqi@0: /** aoqi@0: * Gets the read-only view of all the child elements of this annotation. aoqi@0: * aoqi@0: * @return aoqi@0: * can be empty but never null. aoqi@0: * the returned list is read-only. aoqi@0: */ aoqi@0: public List getChildren() { aoqi@0: return Collections.unmodifiableList(contents); aoqi@0: } aoqi@0: }