@XMLAccessorType, @XMLRootElement

@XMLAccessorType, @XMLRootElement에 대해서 알아보자!^-^good~

아래를 읽기전에  JAXB?? 이거 모르시는 분은 아래 링크 꾹~~^-^good~!

JAXB(Java Architecture for XML Binding)는 자바 클래스를 XML로 표현하는 자바 API이다. JAXB는 주로 2가지 기능이 있다. 자바 객체를 XML로 직렬화하는 것이고 반대로 XML에서 자바 객체로 역직렬화하는 것이다. 즉, JAXB는 메모리의 데이터를 XML 형식으로 변환하여 저장할 수 있고, 이 과정을 위해 프로그램의 각 클래스에서 XML을 읽고 저장하는 일을 구현해야 한다.

위키백과 : http://ko.wikipedia.org/wiki/JAXB

@XMLAccessorType                    

javax.xml.bind.annotation.XmlAccessorType

@Target(value={PACKAGE, TYPE})
@Retention(value=RUNTIME)
@Inherited

Controls whether fields or Javabean properties are serialized by default.
위의 문구가 가장 중요한 문구이다! serialized는 해석을 직렬화라고 해보면.. 
JAXB쪽 위키백과에 나왔듯이 직렬화는 자바 객체를 XML로~!! 이다.

요정도를 베이스로 알고 보면 한결 이해가 높아질 것이다.^-^goood~
사용 할 때 @XmlAccessorType(XmlAccessType까지 쓰고 .(dot)을 누르면
이클립스에서 자동완성 기능이 발동 한다.

그중에 FIELD를 보면 아래와 같다.

[#M_더보기|접기|1) Every non static, non transient field(정적이지 않고 일시적인 필드가 없을 때) in a JAXB-bound class
will be automatically bound to XML, unless annotated by XmlTransient.
2) Getter/setter pairs are bound to XML
only when they are explicitly annotated by some of the JAXB annotations.
파란색 부분이 엄청~~~중요하다!
getter/setter 쌍이 xml로 bound된다는 거다!

1) 윗부분을 대~~충 해석해보면 JAXB-bound class인데 정적이지않거나 일시적이지 않는 field가 자동적으로 xml로 bound 된다는 것이다. XmlTransient에 의해 어노테이션 되지 않는 한!!

2) GETTER/SETTER 요 한쌍은 xml로 bound되어지는데..!!
오직 JAXB 어노테이션의 일부분에 의해 명쾌하게 어노테이션이 될 때!!

getter setter 내용들이 나오는 것을 보아...VO에서 처리하는 것임을 알 수 있다!^^;

또한 PROPERTIES는 아래와 같다.

Every getter/setter pair in a JAXB-bound class
will be automatically bound to XML, unless annotated by XmlTransient.
Fields are bound to XML
only when they are explicitly annotated by some of the JAXB annotations.

위에서 많이 정리가 되었다면 이것은 껌이다.
따로 예외가 없다. 즉 범위가 모든~~~getter/setter 쌍이다.
Fields가 xml로 bound된다는 거다.(직렬화이므로 object -> xml)

이처럼 그 종류는 아래의 그림과 같다. 조건에 맞게 잘~~쓰면 될 것 같다^-^
나머지는 .(dot) 눌러서 살펴보시면 됩니다~^-^good!

Usage

@XmlAccessorType annotation can be used with the following program elements:

• package
• a top level class

See "Package Specification" in javax.xml.bind.package javadoc for additional common information.

This annotation provides control over the default serialization of properties and fields in a class.

The annotation @XmlAccessorType on a package applies to all classes in the package. The following inheritance semantics apply:

• If there is a @XmlAccessorType on a class, then it is used.
• Otherwise, if a @XmlAccessorType exists on one of its super classes, then it is inherited.
• Otherwise, the @XmlAccessorType on a package is inherited.

Defaulting Rules:

By default, if @XmlAccessorType on a package is absent, then the following package level annotation is assumed.

   @XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
 

By default, if @XmlAccessorType on a class is absent, and none of its super classes is annotated with @XmlAccessorType, then the following default on the class is assumed:

   @XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
 

This annotation can be used with the following annotations: XmlType, XmlRootElement, XmlAccessorOrder, XmlSchema, XmlSchemaType, XmlSchemaTypes, , XmlJavaTypeAdapter. It can also be used with the following annotations at the package level: XmlJavaTypeAdapter.

Since:

JAXB2.0

Version:

$Revision: 1.9 $

Author:

Sekhar Vajjhala, Sun Microsystems, Inc.

See Also:

XmlAccessType

_M#]

또 다른 녀석~!!
@XMLRootElement

javax.xml.bind.annotation.XmlRootElement

@Target(value={TYPE})
@Retention(value=RUNTIME)

Maps a class or an enum type to an XML element.

Usage

The @XmlRootElement annotation can be used with the following program elements:

• a top level class
• an enum type

See "Package Specification" in javax.xml.bind.package javadoc for additional common information.

When a top level class or an enum type is annotated with the @XmlRootElement annotation, then its value is represented as XML element in an XML document.

This annotation can be used with the following annotations: XmlType, XmlEnum, XmlAccessorType, XmlAccessorOrder.

Example 1: Associate an element with XML Schema type

     // Example: Code fragment
     @XmlRootElement
     class Point {
        int x;
        int y;
        Point(int _x,int _y) {x=_x;y=_y;}
     }
 

     //Example: Code fragment corresponding to XML output
     marshal( new Point(3,5), System.out);
 

<SPAN style="FONT-SIZE: 11pt"><SPAN style="FONT-SIZE: 12pt"><SPAN style="FONT-SIZE: 11pt">     <!-- Example: XML output -->
     <FONT color=#c8056a><</FONT><FONT color=#ff8b16><FONT color=#c8056a>point</FONT></FONT><FONT color=#c8056a>></FONT>
       <FONT color=#f9b4cb><FONT color=#000000><</FONT>x<FONT color=#000000>></FONT></FONT> 3 </x>
       <<FONT color=#f9b4cb>y</FONT>> 5 </y>
    <FONT color=#c8056a> </point>
</FONT></SPAN></SPAN></SPAN> 

The annotation causes an global element declaration to be produced in the schema. The global element declaration is associated with the XML schema type to which the class is mapped.

<SPAN style="FONT-SIZE: 11pt"><SPAN style="FONT-SIZE: 10pt">     <!-- Example: XML schema definition -->
     <xs:<FONT color=#c8056a>element name="point"</FONT> type="point"/>
     <xs:<FONT color=#c8056a>complexType </FONT>name="point">
       <xs:<FONT color=#c8056a>sequence</FONT>>
         <xs:element name="x" type="xs:int"/>
         <xs:element name="y" type="xs:int"/>
       </xs:sequence>
     </xs:complexType>
</SPAN></SPAN> 

Example 2: Orthogonality(직교성(?)) to type inheritance(상속)

An element declaration annotated on a type is not inherited by its derived types. The following example shows this.

     // Example: Code fragment
     @XmlRootElement
     class Point3D extends Point {
         int z;
         Point3D(int _x,int _y,int _z) {super(_x,_y);z=_z;}
     }

     //Example: Code fragment corresponding to XML output * 
     marshal( new Point3D(3,5,0), System.out );

     <!-- Example: XML output -->
     <!-- The element name is point3D not point -->
     <point3D>
       <x>3</x>
       <y>5</y>
       <z>0</z>
     </point3D>

     <!-- Example: XML schema definition -->
     <xs:element name="point3D" type="point3D"/>
     <xs:complexType name="point3D">
       <xs:complexContent>
         <xs:extension base="point">
           <xs:sequence>
             <xs:element name="z" type="xs:int"/>
           </xs:sequence>
         </xs:extension>
       </xs:complexContent>
     </xs:complexType>
 

Example 3: Associate a global element with XML Schema type to which the class is mapped.

     //Example: Code fragment
     @XmlRootElement(name="PriceElement")
     public class USPrice {
         @XmlElement
         public java.math.BigDecimal price;
     }

     <!-- Example: XML schema definition -->
     <xs:element name="PriceElement" type="USPrice"/>
     <xs:complexType name="USPrice">
       <xs:sequence>
         <xs:element name="price" type="xs:decimal"/>
       </sequence>
     </xs:complexType>
 

Since:

JAXB2.0

Author:

Sekhar Vajjhala, Sun Microsystems, Inc.

정리 해보면
@XMLAccessorType는 bound to xml(JAXB기반 직렬화 object->xml)을 하는데 있어서 범위? 방식을 정하는 것이다. Field면 정적이지 않거나 임시적이지 않는 필드여야만 한다. 이러한 방식!

@XMLRootElement는 정보라고 보면 된다. object가 xml로 bound가 되어 질 때
아래와 같은 2가지 정보를 준다고 보면 된다.

• a top level class
• an enum type

정보를 주는 방식은 위에 보면 예제를 들어서 설명을 하고 있다.
특히 3번째 예제를 많이들 쓴다.
※ Example 3: Associate a global element with XML Schema type to which the class is mapped. 

추신..: 

xml 스키마 타입(클래스가 mapped된)을 가진 글로벌요소를 결부짓다???? 연합시키다??--;;

  Associate 는 뭐라고 해석해야하지..난감하다 ㅎㅎ느낌은 알꺼 같은데...;;

  -끝-