CodeModelでClassOutline/JClass/CClassの役割は何ですか？

Question

私の質問はJAXBプラグイン、特にJAXBのコードモデルを書くことです。

ClassOutline（と、それはcompanionsだ）とJClass（およびcompanions）とCClass（およびcompanions）の役割は何ですか？対応するパッケージ内のクラスのリストを見ると、何が鶏で、何が卵であるのかは不明です。

私の解釈は、CClass（CPropertyInfo、CEnumConstant、...）は、XSDの最初の草稿解析時にXJCによって作成されています。その後、いくつかの魔法が発生し、このモデルはJClass（JFieldVar、JEnumConstant、...）に変換され、この変換の間にカスタマイズが適用されます。その後、プラグインが呼び出されます。 ClassOutlineは、これらの2つのモデルの間のブリッジとして使用されます。全体が非常に複雑に見えます。

これらの並列モデルでは、同じ情報がいくつかの方法で導出できると私は信じています。たとえば、クラスのフィールドタイプ：

• JClass#fields()→JFieldVar#type→JType
• CClassInfo#getProperties()→CPropertyInfo#baseType→JType

私は、上記のモデルのライフサイクルの詳細な説明を探しています。ありがとう。

Answer 1

ああ、誰かがXJC内部に興味があります。他の誰よりもJAXBプラグインを開発している可能性があるので、助けてもらえます（JAXB2 Basicsなど）

さて、始めましょう。 XJCスキーマコンパイラは約

• 次んするスキーマ
• スキーマ（CClass、CPropertyInfo等）のモデルを作成し解析し
• 輪郭（ClassOutline、FieldOutline等）を作成
• レンダリングコードモデル（JCLASS、JDefinedClass、JMethodなど）
• は、（ディスク上のex.Javaファイル）の物理的なコードを書き込み

最後の2つから始めましょう。

Javaファイルは説明を必要としません。

コードモデルも親しみやすいものです。プログラムでJavaコードを構築するために使用できるAPIです。代わりに文字列連結を使用することもできますが、エラーが発生しやすくなります。 CodeModelでは、少なくとも文法的に正しいJavaコードを取得することがほぼ保証されています。だから私はこの部分も明確であることを願っています。 （ちなみに、私はCodeModelが大好きです。私は最近、CodeModelのアイデアに基づいてJavaScript Code Modelを書いています。） "モデル"と "アウトライン"を見てみましょう。 モデルは、受信したスキーマを解析した結果です。それは、複雑な型に対応する "クラス"と、要素、属性、値に対応する "プロパティ"の観点から、着信スキーマの構造をモデル化します。単純なコンテンツを持つ複雑なタイプの場合）。

モデルは、XMLとスキーマに近い論理モデリング構築物として理解されなければなりません。そのようなものとして、それは彼らが持っているタイプとプロパティを記述するだけです。私がどのように記述しているかははっきりとはっきりと分かりますが、wilcardのタイプ（xsd：any）、置換グループ、列挙型、組込み型など、あらゆる例外と警告があります。

非常に興味深いことに、Modelの兄弟は、実行時にJAXBによって使用されるRuntimeTypeInfoSetImplです。つまり、XMLスキーマから解析されるのではなく、クラスのJAXBアノテーションから解析されるモデルの一種です。概念は同じです。 ModelとRuntimeTypeInfoSetImplの両方は、スーパーコンストラクトであるTypeInfoSetインターフェイスを実装しています。 ClassInfoとPropertyInfoなどのインターフェースをチェック - 彼らは、コンパイル時（XJCでCClassInfoとCPropertyInfo）のためにと実行時（JAXB RIのためのRuntimeClassInfoImplなど）の両方の実装を持っています。

XJCスキーマを解析され、分析されたときに[OK]を、ので、あなたがModelを持っています。このModelはまだコードを生成できません。実際には、コードを作成するさまざまな戦略があります。アノテートされたクラスだけを生成することもできますし、JAXB 1のようにインターフェイス/インプリメンテーションクラスのペアを生成することもできます。コード生成の全体は実際にはモデルのタスクではありません。さらに、Javaコードの物理的性質に関連する多くの側面がありますが、実際にはモデルには関係ありません。たとえば、クラスをパッケージにグループ化する必要があります。これは、Java自体のプロパティではなく、Javaのパッキングシステムによって駆動されます。

そして、輪郭が遊びに来る場所です。スキーマモデルとコードモデルの間のステップとしてアウトラインを見ることができます。コードの構成を担当するコード・モデル要素のファクトリとしてアウトラインを表示し、の生成をCClassInfoから行うことができます。

だから、あなたは正しい、それは確かに非常に複雑です。私はサン/オラクルの従業員ではなく、私はそれをデザインしませんでした（私はそれをした人を知っていますが、彼を大いに尊敬しています）。 私は、例えば、特定の設計上の決定の理由のカップルを推測することができます。

• は、コンパイル時に同じインタフェースを使用して実行時のモデルは
• コード生成の異なる戦略
• はにプラグインを許可を許可します作成したモデルを操作する

このデザインは非常に複雑ですが、その理由はわかります。そのための1つの証拠は、基本的に同じモデル上で、XMLとJavaScriptのマッピング用のマッピングジェネレータを実際に構築することが実際に可能であったことです。私はちょうどスキーマ分析をそのまま残してコード生成を置き換えなければなりませんでした。 （そのためJsonixを参照してください。）

[OK]を、うまくいけば私はXJCで物事は、彼らがどのようにしている理由についていくつかの光を当てます。これらのAPIで幸いですが、それほど厳しいものではありません。既存のオープンソースコードを自由にチェックしてください。多くの例があります。

ps。本当にいつもこれを書こうと思っていました。 :)

Answer 2

（これは、一層のご質問にお答えすることです。）

はい、カスタマイズを確認することが可能です。 Here is私はカスタマイズにアクセスするために使用しているクラスです。

トリックは、参照プロパティが独自のカスタマイズを持たないということです。カスタマイズは、参照された要素プロパティに配置されます。

public static CCustomizations getCustomizations(
     final CPropertyInfo propertyInfo) { 

    final CCustomizations main = new CCustomizations(
      propertyInfo.getCustomizations()); 

    final Collection<CCustomizations> elementCustomizations = propertyInfo 
      .accept(new CPropertyVisitor<Collection<CCustomizations>>() { 
       public Collection<CCustomizations> onAttribute(
         CAttributePropertyInfo info) { 
        return Collections.emptyList(); 
       } 

       public Collection<CCustomizations> onElement(
         CElementPropertyInfo arg0) { 
        return Collections.emptyList(); 
       } 

       public Collection<CCustomizations> onReference(
         CReferencePropertyInfo info) { 

        final List<CCustomizations> elementCustomizations = new ArrayList<CCustomizations>(
          info.getElements().size()); 

        for (CElement element : info.getElements()) { 
         if (!(element instanceof CElementInfo && ((CElementInfo) element) 
           .hasClass())) { 
          elementCustomizations.add(element 
            .getCustomizations()); 
         } 
        } 

        return elementCustomizations; 
       } 

       public Collection<CCustomizations> onValue(
         CValuePropertyInfo arg0) { 
        return Collections.emptyList(); 
       }; 

      }); 

    CCustomizations customizations = main; 

    for (CCustomizations e : elementCustomizations) { 
     main.addAll(e); 
    } 

    return customizations; 
} 

私はusers@jaxb.java.netがそのような議論のための良い場所だと思います。