JavaTM Platform
Standard Ed. 6

javax.xml.bind.annotation
注釈型 XmlTransient


@Retention(value=RUNTIME)
@Target(value={FIELD,METHOD})
public @interface XmlTransient

JavaBean プロパティーの XML 表現へのマッピングを禁止します。

@XmlTransient 注釈は、JavaBean プロパティー名とフィールド名の間の名前の衝突を解決したり、フィールドまたはプロパティーのマッピングを禁止するときに便利です。小文字に変換された JavaBean プロパティー名とフィールド名が同じ場合、名前の衝突が発生する可能性があります。JavaBean プロパティーがフィールドを参照している場合、@XmlTransient 注釈を使用してフィールドまたは JavaBean プロパティーのマッピングを禁止することによって、名前の衝突を解決できます。

使用法

@XmlTransient 注釈は、次のプログラム要素で使用できます。

@XmlTransient は、その他のすべての定義済みの JAXB 注釈と相互に排他的です。

追加の一般的な情報については、javax.xml.bind.package javadoc の「パッケージの仕様」を参照してください。

例: JavaBean プロパティーとフィールド名の間の名前の衝突を解決します。

   //Example:Code fragment
   public class USAddress {

       // The field name "name" collides with the property name 
       // obtained by bean decapitalization of getName() below
       @XmlTransient public String name;

       String getName() {..};
       String setName() {..};
   }

    
   <!-- Example:XML Schema fragment -->
   <xs:complexType name="USAddress">
     <xs:sequence>
       <xs:element name="name" type="xs:string"/>
     </xs:sequence>
   </xs:complexType>
 

導入されたバージョン:
JAXB2.0


JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。