패키지 javax.xml.bind.annotation

Java 프로그램 요소로부터 XML Schema 에의 매핑을 커스터마이즈하기 위한 주석을 정의합니다.

참조처:
설명

인터페이스의 개요

DomHandler<ElementT, ResultT extends Result>

요소 (와 그 자손)를 DOM (또는 유사) 표현에, 또는 그 역방향으로 변환합니다.

클래스의 개요

W3CDomHandler	W3C DOM (org.w3c.dom 패키지) 용 DomHandler 구현
XmlElement.DEFAULT	형태가 프로퍼티의 시그니챠로부터 추정되는 것을 통지하기 위해서 XmlElement.type() 로 사용됩니다.
XmlElementDecl.GLOBAL	선언이 글로벌 스코프에 있는 것을 통지하기 위해서 XmlElementDecl.scope() 로 사용됩니다.
XmlElementRef.DEFAULT	형태가 프로퍼티의 시그니챠로부터 추정되는 것을 통지하기 위해서 XmlElementRef.type() 로 사용됩니다.
XmlSchemaType.DEFAULT	형태가 프로퍼티의 시그니챠로부터 추정되는 것을 통지하기 위해서 XmlSchemaType.type() 로 사용됩니다.
XmlType.DEFAULT	팩토리 메소드가 사용되어 있지 않은지, 또는, 그것이 이 XmlType 자신을 동반하는 클래스내에 있는 것을 통지하기 위해(때문에), XmlType.factoryClass() 로 사용됩니다.

열거형의 개요

XmlAccessOrder	바인드 된 JAXB 클래스의 프로퍼티과 필드의 순서를 제어하기 위해서 XmlAccessorOrder 에 의해 사용됩니다.
XmlAccessType	필드 또는 프로퍼티의 직렬화를 제어하기 위해서 XmlAccessorType 에 의해 사용됩니다.
XmlNsForm	XML Schema 이름 공간 수식의 열거입니다.

주석형의 개요

XmlAccessorOrder	클래스내의 필드와 프로퍼티의 순서를 제어합니다.
XmlAccessorType	필드 또는 JavaBean 프로퍼티이 디폴트로 직렬화 될지 어떨지를 제어합니다.
XmlAnyAttribute	JavaBean 프로퍼티을 와일드 카드 속성 맵에 맵 합니다.
XmlAnyElement	JavaBean 프로퍼티을, XML 정보 세트 표현 또는 JAXB 요소, 혹은 그 양쪽 모두에 맵 합니다.
XmlAttachmentRef	XML 형식이 MIME 컨텐츠에의 URI 참조인 필드/프로퍼티을 마크 합니다.
XmlAttribute	JavaBean 프로퍼티을 XML 속성에 맵 합니다.
XmlElement	JavaBean 프로퍼티을, 프로퍼티명으로부터 파생한 XML 요소에 맵 합니다.
XmlElementDecl	팩토리 메소드를 XML 요소에 맵 합니다.
XmlElementRef	JavaBean 프로퍼티을, 프로퍼티의 형태로부터 파생한 XML 요소에 맵 합니다.
XmlElementRefs	XmlElement 또는 JAXBElement 첨부의 클래스를 참조하는 프로퍼티을 마크 합니다.
XmlElements	복수 @XmlElement 주석의 컨테이너입니다.
XmlElementWrapper	XML 표현에 관련되는 래퍼 요소를 생성합니다.
XmlEnum	열거형 Enum 를 XML 표현에 맵 합니다.
XmlEnumValue	Enum 형의 enum 정수를 XML 표현에 맵 합니다.
XmlID	JavaBean 프로퍼티을 XML ID 에 맵 합니다.
XmlIDREF	JavaBean 프로퍼티을 XML IDREF 에 맵 합니다.
XmlInlineBinaryData	XML 내의 base64 encode 바이너리 데이터에 바인드 되는 데이터형에 대한 XOP 인코딩의 고려를 무효로 합니다.
XmlList	프로퍼티을 리스트 단순형에 맵 하기 위해서 사용됩니다.
XmlMimeType	프로퍼티의 XML 표현을 제어하는 MIME 형을 관련짓습니다.
XmlMixed	혼합 컨텐츠를 지원하는 복수치의 JavaBean 프로퍼티을 주석 합니다.
XmlNs	이름 공간 접두사에 XML 이름 공간 URI 를 관련짓습니다.
XmlRegistry	XmlElementDecl 를 가지는 클래스를 마크 합니다.
XmlRootElement	클래스 또는 열거형을 XML 요소에 맵 합니다.
XmlSchema	패키지명을 XML 이름 공간에 맵 합니다.
XmlSchemaType	Java 형을 단순 schema 편입형에 맵 합니다.
XmlSchemaTypes	복수 @XmlSchemaType 주석의 컨테이너입니다.
XmlTransient	JavaBean 프로퍼티의 XML 표현에의 매핑을 금지합니다.
XmlType	클래스 또는 열거형을 XML Schema 형에 맵 합니다.
XmlValue	simpleContent 를 포함한 XML Schema 복합형, 또는 XML Schema 단순형에의 클래스의 매핑을 가능하게 합니다.

패키지 javax.xml.bind.annotation 의 설명

Java 프로그램 요소로부터 XML Schema 에의 매핑을 커스터마이즈하기 위한 주석을 정의합니다.

패키지의 스펙

다음의 겉(표)는, 각 프로그램 요소에 관련지을 수 있는 JAXB 매핑 주석을 나타냅니다.

프로그램 요소	JAXB 주석
패키지	XmlAccessorOrder XmlAccessorType XmlSchema XmlSchemaType XmlSchemaTypes XmlJavaTypeAdapter XmlJavaTypeAdapters
클래스	XmlAccessorOrder XmlAccessorType XmlInlineBinaryData XmlRootElement XmlType XmlJavaTypeAdapter
enum 형	XmlEnum XmlEnumValue (enum constant only) XmlRootElement XmlType XmlJavaTypeAdapter
JavaBean 프로퍼티/필드	XmlElement XmlElements XmlElementRef XmlElementRefs XmlElementWrapper XmlAnyElement XmlAttribute XmlAnyAttribute XmlTransient XmlValue XmlID XmlIDREF XmlList XmlMixed XmlMimeType XmlAttachmentRef XmlInlineBinaryData XmlElementDecl (only on method) XmlJavaTypeAdapter
파라미터	XmlList XmlAttachmentRef XmlMimeType XmlJavaTypeAdapter

용어

JavaBean 프로퍼티 및 필드: 매핑을 목적으로 하는 경우, 필드와 JavaBean 프로퍼티의 사이에 의미상의 차이는 없습니다. 그 때문에, JavaBean 프로퍼티에 적용할 수 있는 주석은 항상, 필드에도 적용할 수가 있습니다. 따라서, Javadoc 문서에서는, 간결함 때문에, JavaBean 프로퍼티 또는 프로퍼티이라고 하는 용어를 사용할 때, JavaBean 프로퍼티이나 필드의 모두 의미합니다. 필요한 개소에서는, 이 2 개(살)을 명시적으로 구별합니다.

톱 레벨 클래스: 매핑을 목적으로 하는 경우, 톱 레벨 클래스와 static 상자 클래스의 사이에 의미상의 차이는 없습니다. 그 때문에, 톱 레벨 클래스에 적용할 수 있는 주석은 항상, 상자의 static 클래스에도 적용할 수 있습니다. 따라서, Javadoc 문서에서는, 간결함 때문에, 「톱 레벨 클래스」또는 단지 「클래스」라고 하는 용어를 사용할 때는 톱 레벨 클래스나 상자 static 클래스의 어느쪽이든을 의미합니다.

매핑 주석: JSR 175 프로그래밍 주석 기능을 기본으로 한 정의 끝난 JAXB 2.0 프로그램 주석.

일반적인 사용상의 제약

다음에 정의하는 사용상의 제약은, 주석에 한정하지 않고 적용됩니다.

• 프로퍼티의 경우, 특정의 주석을 적용할 수 있는 것은 프로퍼티의 읽기나 기입의 언젠가여, 그 양쪽 모두에는 적용할 수 없습니다.
• 프로퍼티명은, 맵 되는 클래스의 모든 슈퍼 클래스의 다른 어느 프로퍼티명과도 다를 필요가 있습니다.
• 맵 되는 필드명, 또는 맵 되는 프로퍼티의 소문자 변환명은, 클래스내에서 일의가 아니면 안됩니다.

표기법

이름 공간 접두사

이 패키지내의 XML schema fragment에서는, 다음의 이름 공간 접두사가 사용됩니다.

접두사	이름 공간	설명
xs	http://www.w3.org/2001/XMLSchema	XML Schema 이름 공간의 이름 공간
ref	http://ws-i.org/profiles/basic/1. 1/xsd	swaref schema 컴퍼넌트의 이름 공간
xsi	http://www.w3.org/2001/XMLSchema-instance	인스턴스의 XML Schema 이름 공간

도입된 버젼:

JAXB 2.0