com.sun.xml.xsom.XSComponent Maven / Gradle / Ivy
/*
* Copyright (c) 1997, 2021 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
package com.sun.xml.xsom;
import com.sun.xml.xsom.parser.SchemaDocument;
import com.sun.xml.xsom.visitor.XSFunction;
import com.sun.xml.xsom.visitor.XSVisitor;
import org.xml.sax.Locator;
import javax.xml.namespace.NamespaceContext;
import java.util.List;
import java.util.Collection;
/**
* Base interface for all the schema components.
*
* @author
* Kohsuke Kawaguchi ([email protected])
*/
public interface XSComponent
{
/** Gets the annotation associated to this component, if any. */
XSAnnotation getAnnotation();
/**
* Works like {@link #getAnnotation()}, but allow a new empty {@link XSAnnotation} to be created
* if not exist.
*
* @param createIfNotExist
* true to create a new {@link XSAnnotation} if it doesn't exist already.
* false to make this method behavel like {@link #getAnnotation()}.
*
* @return
* null if {@code createIfNotExist==false} and annotation didn't exist.
* Otherwise non-null.
*/
XSAnnotation getAnnotation(boolean createIfNotExist);
/**
* Gets the foreign attributes on this schema component.
*
*
* In general, a schema component may match multiple elements
* in a schema document, and those elements can individually
* carry foreign attributes.
*
*
* This method returns a list of {@link ForeignAttributes}, where
* each {@link ForeignAttributes} object represent foreign attributes
* on one element.
*
* @return
* can be an empty list but never be null.
*/
List getForeignAttributes();
/**
* Gets the foreign attribute of the given name, or null if not found.
*
*
* If multiple occurences of the same attribute is found,
* this method returns the first one.
*
* @see #getForeignAttributes()
*/
String getForeignAttribute(String nsUri, String localName);
/**
* Gets the locator that indicates the source location where
* this component is created from, or null if no information is
* available.
*/
Locator getLocator();
/**
* Gets a reference to the {@link XSSchema} object to which this component
* belongs.
*
* In case of XSEmpty component, this method
* returns null since there is no owner component.
*/
XSSchema getOwnerSchema();
/**
* Gets the root schema set that includes this component.
*
*
* In case of XSEmpty component, this method
* returns null since there is no owner component.
*/
XSSchemaSet getRoot();
/**
* Gets the {@link SchemaDocument} that indicates which document this component
* was defined in.
*
* @return
* null for components that are built-in to XML Schema, such
* as anyType, or "empty" {@link XSContentType}. This method also
* returns null for {@link XSSchema}.
* For all other user-defined
* components this method returns non-null, even if they are local.
*/
SchemaDocument getSourceDocument();
/**
* Evaluates a schema component designator against this schema component
* and returns the resulting schema components.
*
* @throws IllegalArgumentException
* if SCD is syntactically incorrect.
*
* @param scd
* Schema component designator. See {@link SCD} for more details.
* @param nsContext
* The namespace context in which SCD is evaluated. Cannot be null.
* @return
* Can be empty but never null.
*/
Collection select(String scd, NamespaceContext nsContext);
/**
* Evaluates a schema component designator against this schema component
* and returns the first resulting schema component.
*
* @throws IllegalArgumentException
* if SCD is syntactically incorrect.
*
* @param scd
* Schema component designator. See {@link SCD} for more details.
* @param nsContext
* The namespace context in which SCD is evaluated. Cannot be null.
* @return
* null if the SCD didn't match anything. If the SCD matched more than one node,
* the first one will be returned.
*/
XSComponent selectSingle(String scd, NamespaceContext nsContext);
/**
* Accepts a visitor.
*/
void visit( XSVisitor visitor );
/**
* Accepts a functor.
*/
T apply( XSFunction function );
}