javax.xml.bind.annotation.package-info Maven / Gradle / Ivy
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 2004-2017 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* https://oss.oracle.com/licenses/CDDL+GPL-1.1
* or LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
/**
* Defines annotations for customizing Java program elements to XML Schema mapping.
*
*
Package Specification
* The following table shows the JAXB mapping annotations
* that can be associated with each program element.
*
*
*
*
* Program Element
* JAXB annotation
*
*
*
*
* Package
*
*
*
*
*
* Class
*
*
*
*
*
* Enum type
*
*
*
*
*
* JavaBean Property/field
*
*
* - XmlElement
* - XmlElements
* - XmlElementRef
* - XmlElementRefs
* - XmlElementWrapper
* - XmlAnyElement
* - XmlAttribute
* - XmlAnyAttribute
* - XmlTransient
* - XmlValue
* - XmlID
* - XmlIDREF
* - XmlList
* - XmlMixed
* - XmlMimeType
* - XmlAttachmentRef
* - XmlInlineBinaryData
* - XmlElementDecl (only on method)
* - XmlJavaTypeAdapter
*
*
*
*
* Parameter
*
*
* - XmlList
* - XmlAttachmentRef
* - XmlMimeType
* - XmlJavaTypeAdapter
*
*
*
*
*
* Terminology
*
* JavaBean property and field: For the purposes of
* mapping, there is no semantic difference between a field and
* a JavaBean property. Thus, an annotation that can be applied
* to a JavaBean property can always be applied to a
* field. Hence in the Javadoc documentation, for brevity, the
* term JavaBean property or property is used to mean either JavaBean
* property or a field. Where required, both are explicitly
* mentioned.
*
* top level class: For the purpose of mapping, there is
* no semantic difference between a top level class and a
* static nested class. Thus, an annotation that can be applied
* to a top level class, can always be applied to a nested
* static class. Hence in the Javadoc documentation, for
* brevity, the term "top level class" or just class is used to
* mean either a top level class or a nested static
* class.
*
* mapping annotation:A JAXB 2.0 defined program
* annotation based on the JSR 175 programming annotation
* facility.
*
Common Usage Constraints
* The following usage constraints are defined here since
* they apply to more than annotation:
*
* - For a property, a given annotation can be applied to
* either read or write property but not both.
* - A property name must be different from any other
* property name in any of the super classes of the
* class being mapped.
* - A mapped field name or the decapitalized name of a
* mapped property must be unique within a class.
*
* Notations
* Namespace prefixes
* The following namespace prefixes are used in the XML Schema
* fragments in this package.
*
*
*
*
* Prefix
* Namespace
* Notes
*
*
*
*
* xs
* http://www.w3.org/2001/XMLSchema
* Namespace of XML Schema namespace
*
*
* ref
* http://ws-i.org/profiles/basic/1.1/xsd
* Namespace for swaref schema component
*
*
* xsi
* http://www.w3.org/2001/XMLSchema-instance
* XML Schema namespace for instances
*
*
*
*
* @since 1.6, JAXB 2.0
*/
package javax.xml.bind.annotation;