--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/TypeInfoSet.java 2018-01-30 20:31:58.000000000 -0500 +++ /dev/null 2018-01-30 20:31:58.000000000 -0500 @@ -1,192 +0,0 @@ -/* - * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * This code is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License version 2 only, as - * published by the Free Software Foundation. Oracle designates this - * particular file as subject to the "Classpath" exception as provided - * by Oracle in the LICENSE file that accompanied this code. - * - * This code is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License - * version 2 for more details (a copy is included in the LICENSE file that - * accompanied this code). - * - * You should have received a copy of the GNU General Public License version - * 2 along with this work; if not, write to the Free Software Foundation, - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. - * - * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA - * or visit www.oracle.com if you need additional information or have any - * questions. - */ - -package com.sun.xml.internal.bind.v2.model.core; - -import java.util.Map; - -import javax.xml.bind.JAXBException; -import javax.xml.bind.annotation.XmlSchema; -import javax.xml.bind.annotation.XmlNsForm; -import javax.xml.namespace.QName; -import javax.xml.transform.Result; - -import com.sun.xml.internal.bind.v2.model.nav.Navigator; - -/** - * Root of models. Set of {@link TypeInfo}s. - * - * @author Kohsuke Kawaguchi - */ -public interface TypeInfoSet { - - /** - * {@link Navigator} for this model. - */ - Navigator getNavigator(); - -// turns out we can't have AnnotationReader in XJC, so it's impossible to have this here. -// perhaps we should revisit this in the future. -// /** -// * {@link AnnotationReader} for this model. -// */ -// AnnotationReader getReader(); - - /** - * Returns a {@link TypeInfo} for the given type. - * - * @return - * null if the specified type cannot be bound by JAXB, or - * not known to this set. - */ - NonElement getTypeInfo( T type ); - - /** - * Gets the {@link TypeInfo} for the any type. - */ - NonElement getAnyTypeInfo(); - - /** - * Returns a {@link ClassInfo}, {@link ArrayInfo}, or {@link LeafInfo} - * for the given bean. - * - *

- * This method is almost like refinement of {@link #getTypeInfo(Object)} except - * our C cannot derive from T. - * - * @return - * null if the specified type is not bound by JAXB or otherwise - * unknown to this set. - */ - NonElement getClassInfo( C type ); - - /** - * Returns all the {@link ArrayInfo}s known to this set. - */ - Map> arrays(); - - /** - * Returns all the {@link ClassInfo}s known to this set. - */ - Map> beans(); - - /** - * Returns all the {@link BuiltinLeafInfo}s known to this set. - */ - Map> builtins(); - - /** - * Returns all the {@link EnumLeafInfo}s known to this set. - */ - Map> enums(); - - /** - * Returns a {@link ElementInfo} for the given element. - * - * @param scope - * if null, return the info about a global element. - * Otherwise return a local element in the given scope if available, - * then look for a global element next. - */ - ElementInfo getElementInfo( C scope, QName name ); - - /** - * Returns a type information for the given reference. - */ - NonElement getTypeInfo(Ref ref); - - /** - * Returns all {@link ElementInfo}s in the given scope. - * - * @param scope - * if non-null, this method only returns the local element mapping. - */ - Map> getElementMappings( C scope ); - - /** - * Returns all the {@link ElementInfo} known to this set. - */ - Iterable> getAllElements(); - - - /** - * Gets all {@link XmlSchema#xmlns()} found in this context for the given namespace URI. - * - *

- * This operation is expected to be only used in schema generator, so it can be slow. - * - * @return - * A map from prefixes to namespace URIs, which should be declared when generating a schema. - * Could be empty but never null. - */ - Map getXmlNs(String namespaceUri); - - /** - * Gets {@link XmlSchema#location()} found in this context. - * - *

- * This operation is expected to be only used in schema generator, so it can be slow. - * - * @return - * A map from namespace URI to the value of the location. - * If the entry is missing, that means a schema should be generated for that namespace. - * If the value is "", that means the schema location is implied - * ({@code } w/o schemaLocation.) - */ - Map getSchemaLocations(); - - /** - * Gets the reasonable {@link XmlNsForm} for the given namespace URI. - * - *

- * The spec doesn't define very precisely what the {@link XmlNsForm} value - * for the given namespace would be, so this method is implemented in rather - * ad-hoc way. It should work as what most people expect for simple cases. - * - * @return never null. - */ - XmlNsForm getElementFormDefault(String nsUri); - - /** - * Gets the reasonable {@link XmlNsForm} for the given namespace URI. - * - *

- * The spec doesn't define very precisely what the {@link XmlNsForm} value - * for the given namespace would be, so this method is implemented in rather - * ad-hoc way. It should work as what most people expect for simple cases. - * - * @return never null. - */ - XmlNsForm getAttributeFormDefault(String nsUri); - - /** - * Dumps this model into XML. - * - * For debug only. - * - * TODO: not sure if this actually works. We don't really know what are T,C. - */ - public void dump( Result out ) throws JAXBException; -}