乐荤辽２ XML/C++ 铅轰２

铅轰２ˉリファレンス

チュ〖ニング

akaxiso2.0-beta2

铅轰２リファレンス

铅轰２は、肋年ファイル、もしくは、XMLスキ〖マ矢今面に肋年灌誊を纳裁することにより、ソ〖スの栏喇箕の拒嘿なオプションを肋年することが材墙です。

XMLスキ〖マ矢今面における回年

XMLスキ〖マ矢今面の<xs:appinfo>妥燎笆布に、叹涟鄂粗 http://akaxiso.sourceforge.jp/osixaka2/beta2 ∈呵姜リリ〖スで恃构あり∷に掳する妥燎を今くことで

叹涟鄂粗プレフィックス
インクル〖ドファイルの回年
C++クラス叹
缄悸刘により年盗された帽姐房の猛クラス、leafクラスの蝗脱

の肋年が材墙です。

ˇ叹涟鄂粗に滦する叹涟鄂粗プレフィックスの回年(osx:namespace)

笆布の妨及にて回年を乖います。

<osx:namespace prefix="叹涟鄂粗プレフィックス" uri="叹涟鄂粗URI">

uri掳拉は臼维することができます。その眷圭、xs:schema妥燎の掳拉である@targetNamespace掳拉の猛が脱いられます。ここで回年される叹涟鄂粗プレフィックスがC++ソ〖スの叹涟鄂粗叹になります。

<osx:namespace>は、<xs:appinfo>の灰妥燎として今いてください。また、<xs:annotation>は、呵介の<xs:complexType>、もしくは、<xs:simpleType>の涟に今いてください。

毋¨

my_uriで回年される叹涟鄂粗に滦して、叹涟鄂粗プレフィックス、my_prefixを滦炳烧ける。

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:appinfo xmlns:osx="http://akaxiso.sourceforge.jp/osixaka2/beta2">
      <osx:namespace prefix="my_prefix" uri="my_uri"/>
    <xs:appinfo>
  </xs:annotation>

 <!-- xs:complexType、xs:simpleTypeの年盗 などなど-->

</xs:schema>

ˇインクル〖ドファイルの回年(osx:include、osx:xiso_include、osx:ximpl_include)

猛クラスファイル(osx:include)、leafクラスの离咐ファイル(osx:xiso_include)、leafクラスの悸刘ファイル(osx:ximpl_include)ファイル面でファイルをインクル〖ドするための回年を乖います。
笆布に妨及を绩します。

<!-- 猛クラスヘッダへのインクル〖ド -->
<osx:include system="true|false">インクル〖ドファイル叹</osx:include>

<!-- leafクラスヘッダへのインクル〖ド -->
<osx:xiso_include system="true|false">インクル〖ドファイル叹</osx:xiso_include>

<!-- leafクラス悸刘ファイルへのインクル〖ド -->
<osx:ximpl_include system="true|false">インクル〖ドファイル叹</osx:ximpl_include>

それぞれ、@system掳拉(xs:boolean房)を积ち、この回年により、#includeの妨及を笆布に绩すように联买することができます。

/* @system="true"が回年された箕、 */
#include <ファイル叹>

/* @system="false"が回年された箕、*/
#include "ファイル叹"

xs:include、xs:xiso_include、xs:ximpl_includeは、XMLスキ〖マ矢今の<xs:appinfo>の灰妥燎として今いてください、また、<xs:annotation>は、呵介の<xs:complexType>、もしくは、<xs:simpleType>の涟に今いてください。

<xs:schema xmlns:osx="http://akaxiso.sourceforge.jp/osixaka2/beta2"
  xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:appinfo>
      <osx:include name="filename.h" system="true"/>
    </xs:appinfo>
  </xs:annotation>

<!-- xs:complexType、xs:simpleTypeの年盗などなど。 -->

</xs:schema>

ˇ栏喇されるクラス叹の回年(osx:classname)

xs:complexType、xs:simpleType、xs:sequence、xs:choice、xs:allの掳拉として蝗脱材墙です。

奶撅、铅轰２は、XMLスキ〖マの@name掳拉で涂えられる叹涟、もしくは、痰叹パ〖ティクルに涂えられる极瓢栏喇された叹涟を、C++のクラス叹として脱います。この叹涟を、osx:classname掳拉で惧今きすることができます。

毋１¨

xs:complexTypeにosx:classnameを努脱する。XMLスキ〖マ房の叹涟を"schema_type"、C++のクラス叹を"cpp_type"とする。

<xs:complexType name="schema_type" osx:classname="cpp_type" 
  xmlns:osx="http://akaxiso.sourceforge.jp/osixaka2/beta2"/>

毋２¨

ネストした痰叹のxs:sequenceに、C++のクラス叹(cpp_sequence)を回年する。

<xs:complexType name="schema_type" xmlns:osx="http://akaxiso.sourceforge.jp/osixaka2/beta2">
  <xs:choice>
    <xs:sequence osx:classname="cpp_sequence"/>
  </xs:choice>
</xs:complexType>

ˇ缄悸刘によるleafクラスの蝗脱(osx:leaf)

帽姐房のクラス、leafクラスを侍ファイルにて、离咐、悸刘しており、この年盗を苞脱する狠に脱います。<xs:simpleType>の掳拉として蝗脱材墙です。

<xs:simpleType osx:leaf="leafクラス叹"/>

osx:leafを蝗脱する狠には、帽姐房のC++猛クラス叹は、帽姐房の猛クラスに滦して铅轰２が涂える叹涟と办米している涩妥があります。(毋を徊救)

毋¨

スキ〖マ面に帽姐房(my_simpleType)があり、この房に滦して、屡碰拉浮沮、もしくは、泼检な纳裁借妄を悸刘した猛クラス(struct my_simpleType、struct my_simpleType_leaf"が、すでに悸刘されているものとする。XMLスキ〖マ矢今面で、これらのクラスを苞脱し、ソ〖ス栏喇を乖います。戮のファイルに悸刘されている帽姐房のクラス、leafクラスを#includeにより粕み哈むため、<osx:include>、<osx:xiso_include>と驶せて脱います。

ˇC++娄の悸刘

ファイル¨my_simpleType.h----------------------------------------------

typedef long  my_simpleType; // my_simpleTypeは、long房の恃眶で山される。

------------------------------------------------------------------

ファイル¨my_simpleType_xiso.h -------------------------------------------
#include "my_simpleType.h"
struct my_simpleType_leaf : aka::simpleType<my_simpleType, my_simpleType_leaf> {
  static void read_text(void *e, const std::string &entity, aka::entity_complements &ecomp);
  static void _write_text(const void *e, std::ostream &ostm, aka::entity_complements &ecomps);
};

-------------------------------------------------------------------

ファイル¨my_simpleType_xiso.cpp------------------------------------------

// my_simpleType_leaf::read_text(), my_simpleType_leaf::write_text()の悸刘

-------------------------------------------------------------------


ˇスキ〖マファイル-------------------------------------------------------
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" 
  xmlns:osx="http://akaxiso.sourceforge.jp/osixaka2/beta2">
  <xs:annotation>
    <xs:appinfo>
      <osx:include>my_simpleType.h</osx:include>
      <osx:xiso_include>my_simpleType_leaf.h</osx:xiso_include>
    </xs:appinfo>
  </xs:annotation>

  <!--毋１ トップレベル妥燎としてのxs:simpleType -->
  <!-- トップレベル妥燎の叹涟がそのままC++猛クラス叹として蝗われる。 -->
  <xs:simpleType name="my_simpleType" osx:leaf="my_simpleType_leaf">
    <!-- xs:simpleTypeの悸狠の年盗。铅轰２では痰浑される。
  </xs:simpleType>


  <!--毋２ ロ〖カル妥燎としてのxs:simpleType>
  <xs:complexType>
    <xs:sequence>
      <xs:attribute name="sample_attr">
        <!-- ロ〖カルなxs:simpleTypeは、痰叹であるため、osx:cleassnameにて叹涟を涂える。 -->
        <xs:simpleType osx:classname="my_simpleType" osx:leaf="my_simpleType_leaf"/>
      <xs:attribute>
     </xs:sequence>
  </xs:complexType>

</xs:schema>

肋年ファイルによる回年

肋年ファイルを脱いて、デフォルトの肋年を今き垂えることができます。-Tオプションを脱いて、肋年ファイルのテンプレ〖トを栏喇することができます。


$ osixaka2 -T template.xml

栏喇されるファイル(template.xml)の柒推を笆布にしめします。

<?xml version="1.0" encoding="Shift_JIS" standalone="yes"?>
<preference xmlns="http://akaxiso.sourceforge.jp/osixaka2/beta2">
  <format>
    <member prefix="" suffix="_"/>
    <array container="std::list" prefix="" suffix="_array"/>
    <choice container="std::list"/>
    <simplecontent valuename="value"/>
    <particle_item prefix="" suffix="_item"/>
  </format>
  <substitutions>
    <substitution original="token_to_substitute" substituted="substituted_token"/>
  </substitutions>
  <escapes>
    <escape to_escape="character_to_escape" escaped="escaped_character"/>
  </escapes>
  <directives/>
</preference>

ˇメンバ、クラス叹のフォ〖マット(preference/format笆布)

肋年灌誊	妥燎	猛の毋
クラスメンバの今及	member_format	@prefixで、メンバ叹の儡片胳を@postfixでメンバ叹の儡萨稿を回年 <member_format prefix="m_"、postfix=""/> とすると、m_member;のようなメンバ叹が回年される。
芹误のコンテナ	array_container	std::vector、std::listなど
aka:choiceのコンテナ	choice_container	std::vector、std::listなど
aka:simplecontent(xs:simpleContent)の猛メンバ叹	simplecontent	@valuenameで回年された叹涟が、aka:simplecontentの猛メンバ叹として蝗脱される。
minOccurs, maxOccursが回年されたxs:complexTypeの栏喇に蝗われる芹误妥燎房の叹涟	particle_item	@prefixで、メンバ叹の儡片胳を@postfixでメンバ叹の儡萨稿を回年 <member_format prefix="m_"、postfix=""/> とすると、m_member;のようなメンバ叹が回年される。

ˇ弥垂(preference/substitutions、preference/escapes笆布)

肋年灌誊	妥燎	猛の毋
ト〖クン弥垂	preference/substitutions/ substitution	帽胳の弥垂。XML Schema柒で回年される叹涟が、C++の徒腆胳と脚なるような眷圭に脱いる。 <substitution original="class" substituted="_class"/> とすると、classが、_classに弥垂される。惧淡肋年テンプレ〖トで栏喇されるのは、ダミ〖の妥燎。
矢机の弥垂(エスケ〖プ)	preference/escapes/escape	'-'(ハイフン)など、XML Schemaで叹涟として蝗脱材墙な矢机をエスケ〖プする。 <escape to_escape="-" escaped="_"/> と回年すると、"XML-Schema-Name"が、"XML_Schema_Name"と恃垂される。

ˇディレクティブ(preference/directives)

肋年灌誊	妥燎	猛の毋
叹涟鄂粗回年	namespace	叹涟鄂粗のプレフィックスとURIの滦炳烧けを乖う。 XMLスキ〖マ面に今かれるosx:namespaceと票今及
インクル〖ドファイル回年	include、 xiso_include、 ximpl_include	栏喇されるファイルに#includeを赁掐。 XMLスキ〖マ面に今かれるosx:include、osx:xiso_include、osx:ximpl_includeと票今及

ˇ柒婶回年(internal)

悸刘拒嘿のチェック面

肋年ファイルの蝗脱

-Lオプションを脱いて、侯喇された肋年ファイルを蝗脱します。


肋年ファイルの蝗脱
$ osixaka2 -L preference.xml <XML Schemaドキュメントファイル叹>

慌屯、扩嘎、踏悸刘婶など

XMLスキ〖マ面の寥哈み房は、铅轰２により、C++クラスにマッピングされます。
乐荤辽２リファレンス 5.寥み哈み房を徊救ください。。
xs:simpleTypeによる帽姐房の年盗を脱いた眷圭、栏喇される房は、std::stringのtypedef叹となります。
また、帽姐房の扩嘎、橙磨の年盗について、屡碰拉浮沮ロジックはサポ〖トされません。
笆布のタグ、掳拉は、サポ〖トされません。
- xs:keybase、xs:keyref、xs:substitutionGroup、mixed掳拉、xs:redefine、abstract掳拉、final掳拉、block掳拉、blockDefault掳拉
complexContent笆布におけるrestrictionの年盗に簇して、扩腆チェックは、サポ〖トされていません。サポ〖ト徒年も踏年です。
xs:include、xs:importの借妄箕に回年されるschemaLocation掳拉は、借妄滦据のスキ〖マファイルからの陵滦パスで淡揭されるものとします。

リファレンストップへ　乐荤辽２トップペ〖ジへ sourceforgeプロジェクトペ〖ジへ