Posts on scalaxb

scalaxb 1.8.0

Fri, 04 Sep 2020 13:40:10 +0000

scalaxb 1.7.5

Sun, 28 Jun 2020 05:02:47 +0000

toXML(...) で xsi:type 属性を書き出すようにした #518 by @abestel
scalaxbUseLists セッティングを追加して Seq[A] の代わりに List[A] を生成できるようにした #526 by @pgrandjean
生成されたコードで複数の引数を取る中置記法を使わないようにする修正 #531 by @margussipria
enum が生成する fromString メソッドが大きすぎてコンパイルできない問題の回避として分けるようにした #517 by @LolHens

scalaxb 1.7.3

Sun, 22 Sep 2019 05:39:19 +0000

機能改善点

Scala 2.13 のサポート #514 by @jtjeferreira

バグフィックス

列として宣言された属性の処理の修正 #512 by @abestel

scalaxb 1.7.2

Mon, 26 Aug 2019 08:54:43 +0000

バグフィックス

toXML が呼ばれたときの Big decimal のフォーマットを XML Schema に準拠するよう修正した。#505 by @tOverney

scalaxb 1.7.1

Sat, 16 Mar 2019 18:07:50 +0000

バグフィックス

Big decimal のフォーマットを XML Schema に準拠するよう修正した。 #483 by @danslapman
String と Option[String] が比較されていたのを修正した。 #485 by @lespea
One-way SOAP 呼び出しを修正した。 #493 by @danslapman

scalaxb 1.5.2

Tue, 04 Jul 2017 05:03:14 +0000

機能改善点

Gigahorse 0.3 及び異なるバックエンド (OkHttp と AHC) へのサポートを追加した。 #428 by @alexdupre

バグフィックス

JVM のコードサイズの制限を回避するため、fromAnySchemaType を分割するようにした。 #429 by @fltt

scalaxb 1.5.1

Fri, 10 Mar 2017 02:50:55 +0000

バグフィックス

最後尾のアンダースコアが "u93" に置換されるようになった。 #415 by @varnerac
BigDecimal のフォーマットの修正。 #417 by @coutoPL

機能改善点

Gigahorse サポートの追加。 #413 by @alexdupre
Scala 2.12 クロスビルディング。 #413/#419 by @alexdupre and @dwijnand

scalaxb 1.5.0

Mon, 31 Oct 2016 04:54:46 +0000

互換性の無い変更点

型クラスのインスタンスの名前衝突をパケージ名をプレフィックスすることで修正した。 #385 by @anatoliykmetyuk
可変長引数 (varargs) をデフォルトで使わないように変更した。
sbt-scalaxb を auto plugin 化した。

バグフィックス

複数の implicit ヘッダを用いる SOAP operation の修正。 #380 by @joshlreese
SOAP ヘッダの値が合成された場合の修正。 #381 by @coutoPL
SOAP ヘッダパーツに関連したコード生成の修正。 #400 by @jankeesvanandel
enum の名前の衝突の修正。 #386 by @anatoliykmetyuk
enum のパーシングを修正して、例えば xsd:byte 型による 00 を取り扱えるようになった。 #388 by @anatoliykmetyuk

機能改善点

可変 (mutable) case class を生成するための --mutable オプションを追加した。詳細は後ほど。
type 属性を用いた xs:any の変換。 #389 by @anatoliykmetyuk
パッケージ名を自動で選択する --autopackages オプションの追加。 #391 by @anatoliykmetyuk
生成された case class を走査するための Visito を生成する --visitor オプションの追加。 #392 by @anatoliykmetyuk

sbt-scalaxb への変更

scalaxb 1.5.0 より sbt-scalaxb は auto plugin 化される。 scalaxbSettings 追加して、sourceGenerators in Compile する代わりに、ScalaxbPlugin を有効化するだけでよくなった。他の全てのセッティングやタスクは “scalaxb” とプレフィックスされる。例えば、以前の packageName というキーは scalaxbPackageName に変更された。

Before:

import ScalaxbKeys._
lazy val root = (project in file(".")).
  settings(
    name := "foo-project").
  settings(scalaxbSettings).
  settings(
    sourceGenerators in Compile += (scalaxb in Compile).taskValue,
    packageName in (Compile, scalaxb) := "generated"
    // packageNames in (Compile, scalaxb) := Map(uri("http://something/") -> "something"),
    // logLevel in (Compile, scalaxb) := Level.Debug
  )

After:

lazy val root = (project in file(".")).
  enablePlugins(ScalaxbPlugin).
  settings(
    name := "foo-project",
    scalaxbPackageName in (Compile, scalaxb) := "generated"
    // scalaxbAutoPackages in (Compile, scalaxb) := true
  )

#405 by @eed3si9n

可変 (mutable) case class

scalaxb 1.5.0 は可変な case class を生成するオプションを追加する。

case class Address(var name: String,
  var street: String,
  var city: String)

sbt-scalaxb では以下のように有効化できる:

lazy val root = (project in file(".")).
  enablePlugins(ScalaxbPlugin).
  settings(
    name := "foo-project",
    scalaxbPackageName in (Compile, scalaxb) := "generated",
    scalaxbGenerateMutable in (Compile, scalaxb) := true
  )

#390 by @AndreVanDelft

コントリビューター

バグ報告や pull request によって scalaxb の改善にお手伝いしていただいた皆さんにこの場を借りてお礼します。

git shortlog -sn --no-merges 1.4.1..release/1.5.0 によると今回のリリースでは以下の方々にコントリビュートしてもらった (敬称略): Anatoliy Kmetyuk (@anatoliykmetyuk), Eugene Yokota (@eed3si9n), Andre Van Delft (@AndreVanDelft), Jan-Kees van Andel (@jankeesvanandel), Joshua Reese (@joshlreese), and Mateusz Kołodziejczyk (@coutoPL).

scalaxb 1.4.1

Sun, 17 Jul 2016 22:40:50 +0000

互換性の無い変更点

Dispatch 0.11.3 サポートを追加して、defaultDispatchVersion も 0.11.3 へと変更した。 #352 by @DustinChaloupka

バグフィックス

implicit 及び explicit な SOAP ヘッダ処理の修正。#366 by @coutoPL

scalaxb 1.4.0

Mon, 20 Jul 2015 05:41:06 +0000

SOAP/REST 関連の変更点

DispatchHttpClients に requestTimeout と connectionTimeout を追加した。 #304 by @eed3si9n
--no-dispatch-client オプション (generateDispatchClient := false) を追加した。 #322 by @liff
Dispatch の Http(request > as.scalaxb[A]) をサポートするための --dispatch-as オプション (generateDispatchAs := true) を追加した。 #332 by @arkadius

その他の機能改善点

不明な XML 要素や順番違いを無視するための --ignore-unknown オプション (ignoreUnknown := true) を追加した。 #310 by @jet-black
可変長引数のかわりに Seq を使う --no-varargs オプションを追加した。 #292/#309 by @lbruand and @Erwan56
列挙の値が重複している場合の処理を改善した。 #308 by @donderom
設定値を case class の列にリファクタリングした。 #342 by @eed3si9n

バグフィックス

名前空間の重複を修正した。 #310/#291/#298 by @jet-black
CompilerMatcher の Windows でのファイル名やパス処理を修正した。 #307 by @joescii

コンパイラの警告

scalaxb 1.4.0 によって生成されるコードから警告が出ないように修正が加えられた。

生成されるコードに SIP-18 インポートを追加した。 #294 by @carl297r
生成されるコード内の “adapting argument list” およびその他のコンパイラ警告を除去した。 #321 by @liff
scalaxb　本体のコードからコンパイラ警告を除去した。 #335 by @justjoheinz
生成されるコード内の後置記法を除去した。
統合テスト時に -Xfatal-warnings オプションを追加した。 #343 by @eed3si9n

コントリビューター

バグ報告や pull request によって scalaxb の改善にお手伝いしていただいた皆さんにお礼を言いたい。

git shortlog -sn --no-merges 1.3.0..release/1.4.0 によると今回のリリースでは 10人にコントリビュートしてもらった (敬称略): Eugene Yokota (@eed3si9n), @jet-black, Olli Helenius (@liff), Lucas Bruand (@lbruand), Markus Klink (@justjoheinz), Carl Livermore (@carl297r), Arek Burdach (@arkadius), Joe Barnes (@joescii), @Erwan56, Roman Parykin (@donderom)

scalaxb 1.3.0

Fri, 07 Nov 2014 06:12:52 +0000

互換性の無い変更点

SOAP RPC/encoded のサポートの廃止。
SOAP の faultactor を String に変更。 #268 by @rubbish
22 case classes をデフォルトで生成するようにした。 #280
全ての属性を取り扱う単一の attributes フィールドでデフォルトで生成するようにした。 #286

SOAP 関連の変更点

ヘッダの message parts の取り扱いを修正した。 #285 by @plaflamme
nillable な fault の取り扱いを修正した。 #284
http のインスタンスを lazy に変更した。 #279 by @rubbish
fault の toString を実装した。 #278

case class >22 および属性に関する変更

scalaxb 1.3.0 より、デフォルトで >22 な case class が生成されるようになる。さらに、全ての属性は attribute フィールドにまとめられる。

従来の振る舞いに戻したい場合は以下の設定を行う:

contentsSizeLimit in (Compile, scalaxb) := 20

namedAttributes in (Compile, scalaxb) := true

これに関連して、1.3.0 は属性のデフォルト値の取り扱いを修正した。 #288

scalaxb と Scala 2.11

Thu, 14 Aug 2014 19:59:12 +0000

scalaxb 1.2.0 より Scala 2.11.x をサポートするようになった。Scala 2.11 は XML とパーサコンビネータをモジュール化するため、追加で設定が必要になった。以下は sbt 0.13 のマルチプロジェクト構文を使った例だ:

import ScalaxbKeys._

lazy val scalaXml = "org.scala-lang.modules" %% "scala-xml" % "1.0.2"
lazy val scalaParser = "org.scala-lang.modules" %% "scala-parser-combinators" % "1.0.1"
lazy val dispatchV = "0.11.2" // change this to appropriate dispatch version
lazy val dispatch = "net.databinder.dispatch" %% "dispatch-core" % dispatchV

lazy val root = (project in file(".")).
  settings(scalaxbSettings: _*).
  settings(
    name := "hello",
    organization := "com.example",
    scalaVersion := "2.11.1",
    libraryDependencies ++= Seq(scalaXml, scalaParser, dispatch),
    packageName in (Compile, scalaxb) := "com.paperstreet",
    packageNames in (Compile, scalaxb) := Map(uri("http://schemas.microsoft.com/2003/10/Serialization/") -> "microsoft.serialization"),
    dispatchVersion in (Compile, scalaxb) := dispatchV,
    async in (Compile, scalaxb) := true,
    sourceGenerators in Compile <+= scalaxb in Compile
    // logLevel in (Compile, scalaxb) := Level.Debug    
  )

scalaxb 1.2.1

Sun, 06 Jul 2014 01:55:23 +0000

これは SOAP コード生成に関連したバグ修正に的を絞ったリリースだ。詳細は SOAP を使うを参照。 .

SOAP 関連のバグフィクス

xs:AnyType の処理を修正した。 #265
asFaultのエラーを修正した。 #264 reported by @romainreuillon
マルチパート SOAP メッセージにより生成されるコードを修正した。 #267 reported by @tomhaigh
HttpClientsAsync にて concurrent.Future を使うように修正した。 #269 reported by @hedefalk
ブロッキング SOAP クライアントを生成する --blocking というコマンドラインオプションを追加した。

細かな機能改善点

コードの生成に内部で使っている scalaxb パッケージを別名にマスクした。

scalaxb 1.2.0

Sun, 15 Jun 2014 02:53:15 +0000

ノンブロッキング SOAP

scalaxb 1.2.0 よりデフォルトでノンブロッキングな SOAP コードを生成がされるようになった。これまでの Either[X, A] の代わりに SOAP 呼び出しは Future[A] を返し、もし Fault がある場合は Future の失敗として投げられる。

// default
def getQuote(symbol: Option[String]): Future[stockquote.GetQuoteResponse]

// async in (Compile, scalaxb) := false
def getQuote(symbol: Option[String]): Either[scalaxb.Fault[Any], stockquote.GetQuoteResponse]

この機能は @jlavallee と @hoff2 によって #213/#259 としてコントリビュートされた。詳細は soap を使うを参照。

SOAP 関連のバグフィクス

SOAP内のパラメータに現れる予約語をエスケープするようにした。 #252/#256 contributed by @romainreuillon
SOAP内のオペレーション名に現れる予約語をエスケープするようにした。 #241 reported by @rcgoodfellow
SOAP内での nillable な要素の扱いを修正した。 #229 reported by @barnesjd
SOAP を POST したときのエンコーディング問題を修正した。 #231 reported by @hedefalk
Dispatch 0.11.1 に対応した。
literal RPC スタイルのときのレスポンスのパースを修正した。 #260 reported by @romainreuillon

その他のバグフィクスおよび細かな機能改善点

Scala 2.9.0 のサポートから除外して、廃止勧告の出ている呼び出しを修正した。
DatatypeFactory を ThreadLocal にキャッシュするようにした。 #243 contributed by @malaporte
長さがゼロのプレフィックスの処理を修正した。 #253/#255 contributed by @romainreuillon
複合型の継承時に mix 属性が正しく継承されない問題を修正した。 #228 reported by @choffmeister
unbounded が入れ子になったときに、パーサが終了しない問題を修正した。 #230 reported by @FranklinChen
xs:element が default および minOccurs = 1 であるときの処理を修正した。 #245 reported by @alboko
xs:enumeration の値が非常に長い場合の処理を修正した。 #247 reported by @jcranky
xs:element の名前にシンボルが入っていて、かつ --class-prefix が渡されたときの処理を修正した。 #251 reported by @romangarcia
xs:group のパーサが複数回継承される問題を修正した。 #238 reported by @choeger

scalaxb 1.1.2

Mon, 26 Aug 2013 00:31:51 +0000

バグフィクスおよび細かな機能改善点

xs:enumeration の値が空白である場合に生成される case object を修正した。#220 reported by @FranklinChen and others.
属性の名前が value に xs:simpleContext により生成される value という名前のフィールドと衝突するのを修正した。 #221 reported by @lyle-janrain

scalaxb 1.1.1

Wed, 17 Jul 2013 03:28:42 +0000

コマンドラインの互換性の無い変更点

scalaxb cli はデフォルトパッケージ名と名前空間特定のパッケージ名の両方を指定するのに -p と --package を使っていた。scalaxb 1.1.1 はデフォルトパッケージ名には -p と --default-package を、名前空間特定のパッケージ名には --package を使うようにした。

バグフィクスおよび細かな機能改善点

大文字と小文字だけが違う型の名前を回避するようにした。#215 reported by @drdozer
minOccurs=0 かつ nillable である xs:all の処理の修正。#216 reported by @minettiandrea
xsi:nil="1" が nil としてパースされないことを修正した。#217 reported by @aoprisan
カメレオンスキーマの取り扱いを改善した。#102
デフォルトの dispatchVersion を 0.10.1 に設定した。
sbt 0.13 に向けて sbt-scalaxb を更新した。

scalaxb 1.1.0

Tue, 30 Apr 2013 06:04:59 +0000

1.0 と互換性の無い変更点

scalaxb は sys.error を生成するようになったため、Scala 2.8 ではコンパイルできなくなた。 #115 reported by @idot and others.

dispatchVersion

Dispatch 0.10.x 互換のコードを生成するための新しいキー dispatchVersion が追加された #210:

dispatchVersion in scalaxb in Compile := "0.10.0"

libraryDependencies <+=(dispatchVersion in scalaxb in Compile) { dv =>
  "net.databinder.dispatch" %% "dispatch-core" % dv
}

バグフィクスおよび細かな機能改善点

ParserFailure のメッセージに違反したデータを含めるようにした。 #206 requested by @caoilte
QName 型の列挙の処理を修正した。 #208
プラットホーム間のゆらぎを防ぐため sbt-scalaxb は *.xsd をソートするようにした。 #207 reported by @caoilte
xsd ファイルが変更されたときのみ sbt-scalaxb がコードを生成するように変更した。 #199 requested by @fommil

scalaxb 1.0.2

Mon, 25 Mar 2013 01:57:12 +0000

バグフィクス

大きなグループの取り扱いを修正した。 #188 reported by @workingDog
名前空間制約のある xs:any の取り扱いを修正した。 #189
名前の重複解決の上限を取り除いた。 #190
シンボルの列挙値の取り扱いを修正した。 #191
xs:group 参照の命名が衝突するのを修正した。 #192
外部パッケージからの型によって構成される xs:choice の取り扱いを修正した。 #193
分割された xs:sequence が nillable かつ unbounded である場合の取り扱いを修正した。 #194
代替グループを含む xs:choice の取り扱いを修正した。 #195
外部パッケージからの xs:sequence を含む複合型の取り扱いを修正した。 #196
代替グループを含む xs:group または混合複合型の取り扱いを修正した。 #197
xs:anySimpleType から直接または間接的に派生する複合型の取り扱いを修正した。 #200/#203 reported by @sagarcjoshi
単純型を拡張する混合複合型の取り扱いを修正した。 #205
DispatchHttpClients 非-200 な結果を取り扱わないのを修正した。 reported and fixed by @dportabella in #204

scalaxb 1.0.1

Thu, 24 Jan 2013 03:55:33 +0000

バグフィクスおよび細かな機能改善点

URI 前後の空白をトリムする。 #185 contributed by @colinrgodsey

scalaxb 1.0.0

Fri, 21 Dec 2012 05:39:25 +0000

これは scalaxb 最初の安定版だ。実際に使ってみて、バグを報告してくれたり、アイディアやコードを貢献してくれた多くの方々に感謝したい。

0.7 と互換性の無い変更点

Scala 2.10.0-RC1 に適応するためにいくつかの点が変更された。

implicit の衝突を回避するために、scalaxb パッケージオブジェクトは XMLStandardTypes を継承しなくなった。
明示的に implicit をインポートするため scalaxb.XMLStandardTypes オブジェクトが加えられた。
HexBinary クラスと Base64Binary クラスの toIndexedSeq メソッドは vector という名前に変更された。
SOAP バインディングのためのデフォルトの http クライアントは Dispatch 0.9.5 にアップグレードされた。

バグフィクスおよび細かな機能改善点

要素フォーム (“qualified”) のチェック時にあったタイポを修正した #168。 Fixed by @mprihoda
base64Binary エンコーディングのより寛容な処理 #173。 Requested by @nmccready
nillable な choice を含む名前付きモデルグループから生成されるコードを修正した #162。Reported by @rajish
複数の名前空間をまたいだ属性のマージを修正した #174。 Reporetd by @sbrownyarris
カメレオンスキーマの処理を修正した #176。 Reported by @Marza
生成された trait の XMLFormat から孫型が抜けていたのを修正した #178。 Reported by @kidasoft
xs:boolean のパースを修正した #179。Fixed by @rssh

scalaxb 1.0.0-RC3

Mon, 10 Dec 2012 05:44:04 +0000

バグフィクスおよび細かな機能改善点

nillable な choice を含む名前付きモデルグループから生成されるコードを修正した。 #162 reported by @rajish
複数の名前空間をまたいだ属性のマージを修正した。#174 reporetd by @sbrownyarris
カメレオンスキーマの処理を修正した。 #176 reported by @Marza
生成された trait の XMLFormat から孫型が抜けていたのを修正した。 #178 reported by @kidasoft

scalaxb 1.0.0-RC2

Sun, 11 Nov 2012 21:19:09 +0000

バグフィクスおよび細かな機能改善点

base64Binary エンコーディングのより寛容な処理 #173。 Requested by @nmccready

scalaxb 1.0.0-RC1

Tue, 23 Oct 2012 00:26:39 +0000

これは初の安定版の release candidate だ。

0.7 と互換性の無い変更点

Scala 2.10.0-RC1 に適応するためにいくつかの点が変更された。

implicit の衝突を回避するために、scalaxb パッケージオブジェクトは XMLStandardTypes を継承しなくなった。
明示的に implicit をインポートするため scalaxb.XMLStandardTypes オブジェクトが加えられた。
HexBinary クラスと Base64Binary クラスの toIndexedSeq メソッドは vector という名前に変更された。
SOAP バインディングのためのデフォルトの http クライアントは Dispatch 0.9.2 にアップグレードされた。

バグフィクスおよび細かな機能改善点

要素フォーム (“qualified”) のチェック時にあったタイポを修正した #168。 Fixed by @mprihoda

scalaxb 0.7.3

Wed, 15 Aug 2012 04:38:22 +0000

バグフィクス

ロガーのフォーマットを修正した。 #166. reported by @psnively

scalaxb 0.7.2

Thu, 26 Jul 2012 05:29:19 +0000

新しいロガー

@martiell により logula を置き換える log4j ラッパーがコントリビュートされた。 #161. 主な変更点はリゾルバーが Sonatype だけになることだ:

resolvers += "sonatype-public" at "https://oss.sonatype.org/content/groups/public"

バグフィクスおよび細かな機能改善点

SOAP エンコーディングの href の解決機能を追加した。 #160. reported by @greenrd
SI-5843 によって xsi:type 属性が他の属性を消してしまうバグの回避。 #159. reported by @psnively
名前が空白文字で終わる場合に予約語がエスケープされないバグの修正。 #163. reported by @dohzya

scalaxb 0.7.1

Fri, 18 May 2012 05:33:34 +0000

バグフィクスおよび細かな機能改善点

RPC style の soap 処理を修正した。#153
インポートされたグループにより生成されるコードを修正した。#156

scalaxb 0.7.0

Mon, 26 Mar 2012 01:30:48 +0000

resolver の追加

ロガーが logula に変更された。それにともない、sbt-scalaxb を利用している場合は resolver を追加する必要がある:

resolvers ++= Seq(
  "sonatype-public" at "https://oss.sonatype.org/content/groups/public",
  "repo.codahale.com" at "http://repo.codahale.com")

addSbtPlugin("org.scalaxb" % "sbt-scalaxb" % "0.7.0")

バグフィクスおよび細かな機能改善点

入れ子になった単純型が重複だと誤検知されていたのを修正した。#136 reported by @bampoosa
sbt-scalaxb に抜けていた設定をいくつか追加した。 #144 reported by @devinus
xs:any の名前空間制約が ##any にデフォルトでなるよう修正した。 #147 reported by @champloo
soap 1.2 アウトプットラッパーを修正した。 #143
wsdl における混合複合型の処理を修正した。 #149 reported by @jcranky
wsdl におけるヘッダアウトプットの処理を修正した。 #150 reported by @jcranky

mvn-scalaxb

mvn-scalaxb は @martiell により更新された。
デプロイメントを Sonatype open source repository に変更した。
M2E 1.1 互換性: m2eclipse 1.1 から pom.xml を使用する場合に m2e connector plugin も lifecycle mapping metadata もいらなくなった。
scalaxb からの例外があった場合にスタックトレースを隠さないようにした。

複数のコンフィギュレーション

Tue, 06 Mar 2012 05:33:00 +0000

scalaxb 0.6.8

Wed, 01 Feb 2012 06:48:57 +0000

バグフィクスおよび細かな機能改善点

名前空間をまたぐ拡張の処理を修正した。#135 reported by @psnively
余計な要素が最後に来た場合に拒否するようパーシングを修正した。#124
wsdl のパーシングを緩和し、トップ内の要素の順序が違っていても受け付けるようにした。 #87
wsdl が生成する baseAddress を def に変更した。#134 by @hedefalk

scalaxb 0.6.7

Thu, 22 Dec 2011 02:18:13 +0000

バグフィクスおよび細かな機能改善点

重複する単純型のマージを追加した。#116 reported by @OlegYch
代替グループのパーシングを修正した。#119 reported by @bmjsmith and #133 reported by @psnively
DataRecord の等価性を修正した。 #120 reported by @deanhiller
wsdl により生成されるパッケージ名を修正した。#117 reported by @hedefalk and @OlegYch
wsdl における空のインプットメッセージを処理を修正した。#122 reported by @hedefalk
wsdl により生成されるコードの可変長引数の処理を修正した。#125 reported by @hedefalk
soap 1.1 と soap 1.2 の同時使用を修正した。#130 reported by @ben-manes
wsdl により生成されるプロトコルのパッケージ名を修正した。

scalaxb 0.6.6

Sat, 12 Nov 2011 01:29:52 +0000

バグフィクスおよび細かな機能改善点

scalaxb の変更は @eed3si9n によって行われた
生成される defaultScope を、デフォルトの名前空間を加えることで修正した。 #91 reported by @martiell
toXML の xs:anyAttribute の扱いを修正した。#95 reported by @deanhiller
スキーマが unqualifed であるとき生成される defaultScope を修正した。#97 reported by @deanhiller
xs:any が、名前空間バインディングを繰り返すのをマージすることで修正した。#98 reported by @deanhiller
名前空間制約が namespace="##local" のときの xs:any の取り扱いを修正した。#101 reported by @deanhiller
xs:any の名前空間制約を無視する --lax-any オプションを追加した。#103 requested by @deanhiller
ヘルプメッセージを表示する --version オプションを追加した。#106 requested by @deanhiller
属性由来のパラメータにプリフィックスを追加する --attribute-prefix オプションを追加した。#92 reported by ido
targetNamespace 無しの xs:include の処理を追加した。#102 reported by @berntan
ローカル宣言の名前空間バインディングの処理を追加した。#105 reporetd by gerri
QName のラウンドトリップを修正した。#114
オプション、複数、そして nillable なパラメータへのデフォルト引数を追加した。#113 requested by @OlegYch

wsdl/soap 関係

soap バインディングが第一要素ではない場合の wsdl の処理を修正した。#104
属性を含む soap メッセージの処理を追加した。#99 reported by @berntan
soap ヘッダを含む soap メッセージの処理を追加した。#100 reported by @berntan
sbt-scalaxb と mvn-scalaxb が、wsdl を先に処理するように修正した。
空のメッセージを含む wsdl の取り扱いを修正した。#93 reported by @mbroue
soap 1.1 での rpc スタイルの戻り値メッセージの取り扱いを修正した。#94 reported by @dkhenry

mvn-scalaxb

mvn-scalaxb の変更は @martiell によって行われた
処理順を修正した。#110 reported by @hedefalk
パッケージ名のマッピングを修正した。#111 reporetd by @hedefalk

scalaxb 0.6.5

Sat, 08 Oct 2011 22:44:43 +0000

互換性の無い変更点

sbt プラグイン間の名前空間の衝突を避けたり、一貫性を高めるために sbt plugins best practices が作られた。以下の変更点はその勧告にならったものだ:

キーは `ScalaxbKeys` オブジェクト以下に移動した

sbt-scalaxb によって提供されるキーは ScalaxbKeys オブジェクト下に移動した。build.sbt の先頭に以下を書く:

import ScalaxbKeys._

(packageName など) キーの Scala 識別子は今まで同様だが、シェルからの呼び出しには scalaxb-と頭に付ける必要がある (例: scalaxb-package-name)。

設定値は `scalaxb` タスク下にスコーピングされる

scalaxb 専用の設定値は scalaxb タスクの下にスコーピングされる。デフォルトの設定値である scalaxbSettings はさらに、Compile コンフィギュレーション以下にスコーピングされる（Scalaxb コンフィギュレーションは廃止）。

seq(scalaxbSettings: _*)

packageName in scalaxb in Compile := "ipo"

sourceGenerators in Compile <+= scalaxb in Compile

これにより、プロジェクト内で scalaxb を複数回使いたい場合は、build.scala 内にカスタムのコンフィギュレーションを作ることで可能となった:

val Xsd = config("xsd") extend(Compile)
val Wsdl = config("wsdl") extend(Compile)
lazy val appSettings = buildSettings ++
  inConfig(Xsd)(baseScalaxbSettings ++ inTask(scalaxb)(customScalaxbSettings("xmlschema"))) ++
  inConfig(Wsdl)(baseScalaxbSettings ++ inTask(scalaxb)(customScalaxbSettings("wsdl11")))

def customScalaxbSettings(base: String): Seq[Project.Setting[_]] = Seq(
  sources <<= xsdSource map { xsd => Seq(xsd / (base + ".xsd")) },
  packageName := base,
)

バグフィクスおよび細かな機能改善点

名前空間バインディングの衝突を修正した。#84 reported and fixed by jxstanford
wsdl の anyType のサポートを修正した。#88 reported by radirk
wsdl の SOAPAction ヘッダを修正した。
wsdl の Fault の処理を修正した。
内部のログに Logback を使うようにした。

scalaxb 0.6.4

Mon, 12 Sep 2011 07:35:03 +0000

バグフィクスおよび細かな機能改善点

sbt-scalaxb を修正した。#83
QName のパースするときに URI を解決するように修正した。#82

scalaxb 0.6.3

Tue, 06 Sep 2011 02:52:55 +0000

バグフィクスおよび細かな機能改善点

xs:gMonthDay のサポートを修正した。#74
代替グループのパーシングを修正した。#79 reported by @jxstanford
SOAP 1.2 の Content-Type HTTP ヘッダを修正した。#80
RPCスタイルの SOAP メッセージのサポートを加えた。#77
デフォルトのプロトコルファイル名を xmlprotocol.scala に変更した。
--protocol-file と --protocol-package オプションを加えた。#76
重複した型を無視するように変更した。#78 requested by @timperrett

scalaxb 0.6.2

Thu, 28 Jul 2011 07:32:18 +0000

sbt-scalaxb for sbt 0.10.1

sbt 0.10.1 から scalaxb を呼び出すには、以下を project/plugins/build.sbt に加え:

libraryDependencies <+= (sbtVersion) { sv => "org.scalaxb" %% "sbt-scalaxb" % ("sbt" + sv + "_0.6.2") }

以下を build.sbt に加える:

seq(sbtscalaxb.Plugin.scalaxbSettings: _*)

sourceGenerators in Compile <+= scalaxb.identity

バグフィクスおよび細かな機能改善点

長いシーケンスを制限するための --contents-limit オプションを加えた。
子要素が生成するクラス名に親要素名を前置するための --prepend-family オプションを加えた。(#69 reported by @devinus)
soap 1.1 サポートを加えた。 (#66 reported by @s_m_stewart and @meglio)
全モジュールのビルドを sbt 0.10.1 に切り替えた。

scalaxb 0.6.1

Wed, 22 Jun 2011 06:20:24 +0000

sbaz から conscript へ

scalaxb をインストールするのに、sbaz には今までお世話になりましたが、scala のバージョンに依存してたり、REPL のクラスパスを汚染したりなど問題も多いものだった。 0.6.1 より scalaxb は sbaz のサポートを打ち切り、全ユーザに conscript に移行して scalaxb をインストールすることを推奨する。

$ sudo sbaz remove scalaxb
$ cs eed3si9n/scalaxb

無`Array`化

xs:base64Binary は Array[Byte] ではなく、scalaxb.Base64Binary にマッピングするようにした。
scalaxb.HexBinary と scalaxb.Base64Binary の両方とも内部では Vector[Byte] を使う。
他の組み込み型で以前に Array[String] にマッピングされていたものは Seq[String] マッピングするようにした。

mvn-scalaxb

@martiell氏により scalaxb plugin for Maven が提供された。

sbt-scalaxb for sbt 0.10

sbt 0.10 から scalaxb を呼び出すには、以下を project/plugins/build.sbt に加え:

libraryDependencies += "org.scalaxb" %% "sbt-scalaxb" % "0.6.1"

以下を build.sbt に加える:

sourceGenerators in Compile <+= scalaxb.identity

バグフィクスおよび細かな機能改善点

リストの派生型を修正した。 (#54 reported by @ikwzm)
空のシーケンスの処理を修正した。(#55)
名前と構造が一致するローカル要素の命名を修正した。(#56)
@implicitNotFound 属性を fromXML その他に加えた。
scalaxb.scala の生成を省くための --no-runtime オプションを加えた。(#45 requested by @martiell)
wdl オペレーション名のキャメルケース化を実装した。 (#52 requested by @timperrett)
wsdl より生成されるメッセージ case class に付けていた X プレフィックスを取り除いた。(#51 requested by @timperrett)
200+ パラメータを処理するために --chunk-size オプションを加えた。(#58 reported by @ecin)

wsdl 1.1 サポート

Thu, 16 Jun 2011 03:47:18 +0000

ドットコムブームのさなか猫も杓子も WSDL で記述されたSOAP サービスの一つや二つは書いていたのではないか。この WSDL ドキュメントを詳しくみてみると、実はメッセージのレイアウトを記述した XML Schema ドキュメントが埋めこまれており、それが結構な部分を占めいていることが分かる。残りは些細なものだ。scalaxb は XML Schema 部分は処理できるため、WSDL をサポートし始めるのは、時間の問題だったと言えるだろう。

使用例

wsdl ドキュメントをローカル環境にダウンロードする。
sbt-scalaxb を使っている場合はそれを src/main/wsdl に置く。

サンプルの設定例はこんな感じ:

import ScalaxbKeys._

val scalaXml = "org.scala-lang.modules" %% "scala-xml" % "1.0.2"
val scalaParser = "org.scala-lang.modules" %% "scala-parser-combinators" % "1.0.1"
val dispatchV = "0.11.1" // change this to appropriate dispatch version
val dispatch = "net.databinder.dispatch" %% "dispatch-core" % dispatchV

organization := "com.example"

name := "scalaxb-stockquote-sample"

scalaVersion := "2.11.1"

scalaxbSettings

packageName in (Compile, scalaxb) := "stockquote"

dispatchVersion in (Compile, scalaxb) := dispatchV

async in (Compile, scalaxb) := true

sourceGenerators in Compile <+= scalaxb in Compile

libraryDependencies ++= Seq(scalaXml, scalaParser, dispatch)

以下の9ファイルが生成される:

vmware は scalaxb と Salat を使っている

Sun, 12 Jun 2011 03:10:38 +0000

John Stanford 氏が Salat を使って scalaxb の case class を MongoDB に永続化してますという話:

Using Salat with scalaxb generated classes

新しく作った scalaxb Google Group でも氏が一番乗りでした。参加してアイディアを contribute して下さい。

scalaxb 0.6.0

Sun, 29 May 2011 16:14:32 +0000

新機能

実験的 wsdl 1.1 サポート。

バグフィクスおよび細かな機能改善点

XML バインディングを foo_xmlprotocol.scala に生成するようにした。
Scala 2.9.0-1。
Web API を Unfiltered 0.3.3 にアップグレードした。
xs:anyAttribute にデフォルトの引数を加えた。
xs:anySimpleType のサポートを加えた。(#34 reported by @psnively)
xs:any の命名を修正した。(#35 reported by @psnively)
DataRecord の型クラスインスタンスを追加した。(#40 reported by @psnively)
DataRecord のラウンドトリップを修正した。(#43)
xs:anyType を含む xs:choice のマッピングを変更した。(#44 reported by @psnively)

scalaxb 0.5.4

Fri, 15 Apr 2011 03:11:50 +0000

@max4f による sbt-scalaxb プラグインを追加した。
パッケージディレクトリ構造を生成する --package-dir 追加した。
conscript に対応した: cs eed3si9n/scalaxb.
パッケージをまたぐ choice が生成するコードを修正した (GH-33)。

sbt-scalaxb 登場

Wed, 02 Mar 2011 07:23:23 +0000

sbt のための scalaxb プラグインを書いてもらい、さらに快くそれをプロジェクトに取り込まさせてくれた Max 氏 (@max4f) に謝意を表したい。ところで、皆さんは sbt 使ってますね?

sbt から compile-xsd タスクを使うための手順を説明する。

step 1. `Plugins.scala`

以下を project/plugins/Plugins.scala に追加する。

import sbt._

class Plugins(info: ProjectInfo) extends PluginDefinition(info) {
  val scalaxb = "org.scalaxb" % "sbt-scalaxb" % "0.6.0"
  
  val scalaToolsNexusSnapshots = "Scala Tools Nexus Snapshots" at "http://nexus.scala-tools.org/content/repositories/snapshots/"
  val scalaToolsNexusReleases  = "Scala Tools Nexus Releases" at "http://nexus.scala-tools.org/content/repositories/releases/"
}

scalaxb 0.5.3

Tue, 22 Feb 2011 08:22:51 +0000

互換性の無い変更点 (no `import`)

補助関数を Scalaxb オブジェクトから scalaxb パッケージオブジェクトに移した。
デフォルトの型クラスインスタンスを DefaultXMLProtocol trait から生成されるクラスのパッケージオブジェクトに移した。(#nescala での @jsuereth参照)

以前の使用例:

import scalaxb._
import Scalaxb._
import ipo._
import DefaultXMLProtocol._
val shipTo = fromXML[Address](subject)

今後の使用例:

val shipTo = scalaxb.fromXML[ipo.Address](subject)

バグフィクスおよび細かな機能改善点

xs:integer その他を BigInt に対応させた。
代替グループのパーシングを修正した。(GH-25: 報告者 @dbolene)
attributeFormDefault、elementFormDefault、form のサポートを実装した。(GH-26: 報告者 @dbolene)
長いシーケンスのパーシングを修正した。(GH-29: 報告者 E-Fir)
UTF-8 と UTF-16 における BOM の取り扱いを実装した。(GH-31: 報告者 @fredferrao)
バージョン番号を表示する。 (GH-24: 報告者 @dbolene)
パーサーのエラーメッセージを改善した。(GH-27: 報告者 @dbolene)

scalaxb 0.5.2

Sat, 15 Jan 2011 19:27:25 +0000

<xs:sequence> の取り扱いを修正しました。(GH-19)
<xs:attributeGroup> の取り扱いを修正しました。 (GH-21)
参照されたスキーマやコンポーネントが見つからない場合のエラーメッセージを改善しました。
見つからないスキーマを現ディレクトリ内で検索するようにしました。(GH-23)

型クラスによる XML データバインディング

Tue, 07 Dec 2010 05:05:48 +0000

結局の所，scalaxb のユーザはエンティティ・オブジェクトが表現する現実の問題に興味があるのであって，それがどう XML に永続化されるかといったことではない．だから，いつかデータバインディングの実装をシングルトン/コンパニオン・オブジェクトから追い出さなければいけないことは分かっていた．つい最近までデータバインディングの実装は以下のように生成されていた:

object Address extends rt.ElemNameParser[Address] {
  val targetNamespace = "http://www.example.com/IPO"
 
  def parser(node: scala.xml.Node): Parser[Address] =
    ...
 
  def toXML(__obj: Address, __namespace: String, __elementLabel: String, __scope: scala.xml.NamespaceBinding): scala.xml.NodeSeq =
    ...
}

つまり，scalaxb は Address そのものとは関係の無い XML データバインディングのために一等地をハイジャックしてしまったのだ．

adapter

まず最初に以下のような adapter オブジェクトに追い出すことを考えた:

object DefaultXMLAdapter {
  object AddressAdapter extends rt.ElemNameParser[Address] {
    val targetNamespace = "http://www.example.com/IPO"
 
    def parser(node: scala.xml.Node): Parser[Address] =
      ...
 
    def toXML(__obj: Address, __namespace: String, __elementLabel: String, __scope: scala.xml.NamespaceBinding): scala.xml.NodeSeq =
      ...
  }
}

この方法にはいくつかの問題がある．まず，scalaxb のランタイムである DataRecord が，今まではコンパニオン・オブジェクトの暗黙性を使ってたどっていた toXML にたどり着けないということだ．コンパニオン・オブジェクトの興味深い一面として「コンパイラは，暗黙 (implicit) の定義を変換元の型と変換先の型のコンパニオン・オブジェクトにも探しにいく」(Programming in Scala, p. 441) というものがある．

第二の問題は，アイデンティティー問題だ．ユーザのコードの邪魔にならないようにしようとしているのに，Address オブジェクトのためには DefeaultXMLAdapter.AddressAdapter，Item のためには DefeaultXMLAdapter.ItemAdapterなどと，　かえって目に障るものを導入してしまった．ユーザが知っている必要があるのは Address が XML に変換できるという事実だけあって，それがどう行われているかというのは余計な詳細でしかない．

第三の問題として，拡張性の問題がある．例えば，Address を定義する ipo.xsd と，Address を使う purchaseReport要素を定義する report.xsd の二つのスキーマがあるとする．問題は，report.DefaultXMLAdapter.PurchaseReportAdapter は ipo.DefaultXMLAdapter.AddressAdapter を参照するため，ipo.DefaultXMLAdapter を拡張してカスタムのデータバインディングをすることができないということだ．

scalaxb 0.5.1

Tue, 07 Dec 2010 03:39:21 +0000

コマンドラインプログラムが Scala 2.8.1 を使うようになりました．
パラメタ名に型の名前を使うことでコンポジターのアクセス子を修正しました．(GH-18)
ニラブルな可変長引数の型を修正しました．(同じく，GH-18)

scalaxb 0.5.0

Mon, 29 Nov 2010 00:17:58 +0000

型クラスによって XML データバインディングを行うコードを xmlprotocol.scala という別のファイルに生成します．
ランタイムの package を org.scalaxb.rt から scalaxb という名前に変更して，また補助ファイルを scalaxb.scala という名前に変えました．
22 のアイテムを含む <xs:all> の取り扱いを修正しました (GH-10)．
22 の属性を含む <xs:complexType> の取り扱いを修正しました (GH-11)．
<xs:complexContent> を制限する <xs:simpleContent> を含んだ <xs:complexType> の取り扱いを修正しました (GH-12)．
生成されるコードの揺れを修正しました (GH-13)．
XML データバインディングを行うコードを一つの trait にまとめることで循環 <xs:import> の取り扱いを修正しました (GH-14)．
<xs:include> に指定されたスキーマがコンパイルに含まれていない場合に警告を出すようにしました (GH-15)．

ご意見，バグレポートなどをくださった方に感謝の意を表したいと思います．特に Debasish Ghoshさんの記事からはプログラミングに関する洞察をいただき，Andreas Sewe さんからは上記の全てのバグ報告をいただき，ありがとうございました．

今回特に重要な変更点は XML データバインディングのコードが case class のコンパニオンオブジェクトから別の XMLProcotol という trait に抽出されたことです．これにより，使用コードは以下のようになります:

import scalaxb._
import Scalaxb._
import ipo._
import DefaultXMLProtocol._

val shipTo = fromXML[Address](<shipTo>
    <name>foo</name>
    <street>1537 Paper Street</street>
    <city>Wilmington</city>
  </shipTo>)

shipTo は以下の値なります:

scalaxb 0.4.0

Sun, 17 Oct 2010 10:06:24 +0000

パーサ・コンビネータを使って混在内容のコード生成を改良しました．
XML Schema 組み込み型を値の場合の <any> のデータ・バインディングを改良しました．
選択肢が単一のクラスか trait に限定される場合の <choice> のコード生成を改良しました．
コード生成をカスタマイズする –class-prefix と –param-prefix のオプションを加えました．
デプロイ時の問題を回避するため scala-library を jar に含めました．

proguard

Sun, 17 Oct 2010 03:00:17 +0000

恐らく Scala バージョンが合わなかったことに起因する sbaz を使った scalaxb インストールの問題が前に何例か報告されたので scala-library を sbt-proguard-plugin を使って scalaxb.jar の中に入れてしまうことにしました．

--class-prefix と --param-prefix

Sat, 16 Oct 2010 23:24:27 +0000

生成されるコードにプリフィックスを加えるため，–class-prefix と –param-prefix の二つのオプションを追加しました．主要なスキーマのように要素名に小文字を使っていればこのオプションは必要になることはないと思います．scalaxb はクラス名の語頭を大文字にしますが，パラメータ名はいじらないため，以下のようなコードになるためです:

case class USAddress(name: String,
  street: String,
  city: String,
  usstate: USState,
  zip: Int) extends Addressable

要素名の語頭がスキーマの中でも大文字化されているとすると，以下のようなコードになってしまいます:

case class USAddress(Name: String,
  Street: String,
  City: String,
  USState: USState,
  Zip: Int) extends Addressable

これは合法なコードですが USState が二重の意味を持つことは混乱の原因となります．ここで --param-prefix を使ってパラメータにプリフィックスを付けることができます．例えば，m を付けるとすると，以下のコードを生成します:

case class USAddress(mName: String,
  mStreet: String,
  mCity: String,
  mUSState: USState,
  mZip: Int) extends Addressable

また，何らかの理由でクラス名にもプリフィックスを付けたい場合は --class-prefix を使います．X を選ぶとすると，以下のコードを生成します:

case class XUSAddress(mName: String,
  mStreet: String,
  mCity: String,
  mUSState: XUSState,
  mZip: Int) extends XAddressable

小文字を名前にプリフィックスを付けるのにちょっとした細工を実装してみました．scalaxb はプリフィックスを付ける前に元の名前の語頭を大文字化しますが，プリフィックスが _ で終わる場合は大文字化しないことにしました．最初の例に m をプリフィックスする場合は，以下のコードを生成します:

case class USAddress(mName: String,
  mStreet: String,
  mCity: String,
  mUsstate: USState,
  mZip: Int) extends Addressable

しかし，m_ を選んだ場合は，以下のようになります:

case class USAddress(m_name: String,
  m_street: String,
  m_city: String,
  m_usstate: USState,
  m_zip: Int) extends Addressable

の限定

Sat, 16 Oct 2010 04:54:32 +0000

XML ドキュメントを利用しやすいネイティブなオブジェクトに変換（データ・バインディング）する，そしてそのオブジェクトを XML ドキュメントに逆変換（ラウンド・トリップ）できる能力を保持するという二つの要請から rt.DataRecord は生まれました．しかし，この二つの要件は時として統一的な行動を取りません．例えば，逆変換のことだけを考えてしまうと，XML を書き出すために scala.xml.Node を保持すれば解決してしまいますが，データ・バインディングという立場から見ると便利なものではありません．

scalaxb の当初の目標は XML Schema の表現空間をカバーして，かつラウンド・トリップを実装することでした．この目標はほぼ達成されたので，最近の更新では逆変換性は保持しつつ，生成されたコードの利便性を高めることを目指してきました．ラウンド・トリップ側に傾き過ぎたものの一つに <choice> のコード生成があります．まずはこれまでの <choice> のコード生成の歴史を振り返り，最後に新しい案を提起したいと思います．

，再び

Sat, 09 Oct 2010 20:29:49 +0000

<any> のラウンド・トリップにおいて貨物を無くさないために，DataRecord中に scala.xml.Elem を保存してきましたが，DataRecord を利用する側に立つと，これは不便でもあります．問題は <any> はどの要素が来てもいいためパース不可能なことです．ただし，組み込み型はパース可能です．

混在内容のカタがある程度ついたので，XSD 組み込み型のパースに手をつけるいい機会だと思いました．使用例は以下のようになります:

def testAny {
  val subject = <foo xmlns="http://www.example.com/any"
      xmlns:xs="http://www.w3.org/2001/XMLSchema"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <int xsi:type="xs:int">1</int>
        <byte xsi:type="xs:byte">1</byte>
        <dateTime xsi:type="xs:dateTime">2002-10-10T12:00:00Z</dateTime>
      </foo>
  val obj = Element1.fromXML(subject)
  obj match {
    case Element1(
        DataRecord(Some("http://www.example.com/any"), Some("int"), 1),
        DataRecord(Some("http://www.example.com/any"), Some("byte"), 1),
        DataRecord(Some("http://www.example.com/any"), Some("dateTime"), XMLCalendar("2002-10-10T12:00:00Z"))
      ) =>
    case _ => error("match failed: " + obj.toString)
  }
  val document = Element1.toXML(obj, None, Some("foo"), subject.scope)
  println(document)
}

DataRecord は Int，Byte，javax.xml.datatype.XMLGregorianCalendar，など組み込み型に対応した適当な型を格納します．DataRecord はまた内部的に {http://www.w3.org/2001/XMLSchema-instance}type 属性付きでラウンド・トリップする方法を記憶しています．

混在内容，再び

Sat, 02 Oct 2010 10:08:29 +0000

混在内容のサポートを前に始めましたが，おさらいをしておくと，<xs:complexType mixed="true"> の時，XHTML のように一つの要素内にテキストノードと子要素が並列して混在することができようになります．実装した後で，生成される case class が DRY じゃないのが結構気になっていました．

例えば，

<xs:element name="mixedTest">
  <xs:complexType mixed="true">
    <xs:choice maxOccurs="unbounded">
      <xs:element name="billTo" type="Address"/>
      <xs:any namespace="##other" processContents="lax" />
    </xs:choice>
  </xs:complexType>
</xs:element>

は case class Element3(arg1: Seq[rt.DataRecord[Any]], mixed: Seq[rt.DataRecord[Any]]) 生成していましたが，最初のパラメータの arg1 は子要素を収容し，次の mixed は子要素とテキスト・ノードの両方を収容します．case class が XML に往復して帰るためにはテキスト・ノードと子要素の両方を順番通りに mixed に保存する必要があります．しかし，パーシングは子要素のみに行われていたため，arg1のみに Address オブジェクトは格納され，mixed にはパース前の scala.xml.Elem オブジェクトが入っています．お行儀が悪いですね．以前のパーシングがあまり洗練されたものではなかったのが，一つの理由になっています．

いよいよマトモなパーサを使ったパーシングを始めたので，この問題を再検討することにしました．順番を保存する必要性は変わらないので mixed は今後も必要になります．しかし，もしパーシングがしっかりすれば arg1 は無くすことができるのではないでしょうか．そのために複合型が混在であるときはテキスト・ノードも文法の一部とみなすようにパーシングを変更しました．上記の複合型より生成されたコードです:

case class MixedTest(mixed: Seq[rt.DataRecord[Any]])

object MixedTest extends rt.ElemNameParser[MixedTest] {
  val targetNamespace: Option[String] = Some("http://www.example.com/mixed")
  def isMixed: Boolean = true
  
  def parser(node: scala.xml.Node): Parser[MixedTest] =
    optTextRecord ~ rep((((((rt.ElemName(targetNamespace, "billTo")) ^^ 
      (x => rt.DataRecord(x.namespace, Some(x.name), Address.fromXML(x.node)))) ~ 
    optTextRecord) ^^ 
      { case p1 ~ p2 => Seq.concat(Seq(p1),
      p2.toList) })) | 
    (((any ^^ (x => rt.DataRecord(x.namespace, Some(x.name), x.node))) ~ 
      optTextRecord) ^^ 
      { case p1 ~ p2 => Seq.concat(Seq(p1), p2.toList) })) ~ optTextRecord ^^
        { case p1 ~ 
      p2 ~ 
      p3 => MixedTest(Seq.concat(p1.toList,
      p2.flatten,
      p3.toList)) }
        
  def toXML(__obj: MixedTest, __namespace: Option[String], __elementLabel: Option[String], __scope: scala.xml.NamespaceBinding): scala.xml.NodeSeq = {
    var attribute: scala.xml.MetaData  = scala.xml.Null
    
    scala.xml.Elem(rt.Helper.getPrefix(__namespace, __scope).orNull,
      __elementLabel getOrElse { error("missing element label.") },
      attribute, __scope,
      __obj.mixed.flatMap(x => rt.DataRecord.toXML(x, x.namespace, x.key, __scope).toSeq): _*)
  }
}

住所オブジェクトもちゃんとパースされて，しかも重複せずに保存されています．一見問題が解決したかに思われましたが，ラウンド・トリップにおいて新たな問題が発生しました．scala.xml.Elem を保持しないために，DataRecord.toXML が XML を生成できなくなってしまったのです．mixed は Int や String のような組み込み型，scala.xml.Elem のような XMLノード，そして Address のようなユーザ定義型を格納できるように rt.DataRecord[Any] と宣言されています．組み込み型や XMLノードのための XML生成の方法は事前に出荷できますが，ユーザ定義型もサポートする必要があります．型クラスで実装してみることにしました:

scalaxb 0.3.0

Tue, 07 Sep 2010 14:05:41 +0000

<enumeration> のサポートを実装しました．
代替グループのサポートを実装しました．
長いシーケンスをチャンクに分けることで Tuple22 限界を回避しました．

Tuple22 限界への対策

Tue, 07 Sep 2010 00:13:15 +0000

今年の初めに Scala の限界に関して書きました:

Scala は Tuple22 までしかサポートしません．

これは Scala が 22個のパラメータを超えた case class を定義できないことを意味します．22個を超えたパーティクルを持つシーケンスを含む複合型を定義するスキーマを扱えるよう回避策をいくつか用意しました．

まず，シーケンスが MaxParticleSize (20)個以上のパーティクルを持つとき，シーケンスを ChunkParticleSize (10)個ごとのチャンク(塊)に分けることにしました．例えば，30個の要素を持つシーケンスは 10個づつの要素を持った三つのチャンクに分かれます:

<xs:element name="foo">
  <xs:complexType>
   <xs:sequence>
     <xs:element name="string1" type="xs:string"/>
     <xs:element name="string2" type="xs:string"/>
     <xs:element name="string3" type="xs:string"/>
     ...
     <xs:element name="string30" type="xs:string"/>
   </xs:sequence>
  </xs:complexType>
</xs:element>

scalaxb は以上の要素から以下のコードを生成します:

case class Foo(arg1: FooSequence2,
  arg2: FooSequence3,
  arg3: FooSequence4) {
  def string1 = arg1.string1
  def string2 = arg1.string2
  def string3 = arg1.string3
  def string4 = arg1.string4
  def string5 = arg1.string5
  def string6 = arg1.string6
  def string7 = arg1.string7
  def string8 = arg1.string8
  def string9 = arg1.string9
  def string10 = arg1.string10
  def string11 = arg2.string11
  def string12 = arg2.string12
  def string13 = arg2.string13
  def string14 = arg2.string14
  def string15 = arg2.string15
  def string16 = arg2.string16
  def string17 = arg2.string17
  def string18 = arg2.string18
  def string19 = arg2.string19
  def string20 = arg2.string20
  def string21 = arg3.string21
  def string22 = arg3.string22
  def string23 = arg3.string23
  def string24 = arg3.string24
  def string25 = arg3.string25
  def string26 = arg3.string26
  def string27 = arg3.string27
  def string28 = arg3.string28
  def string29 = arg3.string29
  def string30 = arg3.string30
}

case class FooSequence2(string1: String,
  string2: String,
  string3: String,
  string4: String,
  string5: String,
  string6: String,
  string7: String,
  string8: String,
  string9: String,
  string10: String)

case class FooSequence3(string11: String,
  string12: String,
  string13: String,
  string14: String,
  string15: String,
  string16: String,
  string17: String,
  string18: String,
  string19: String,
  string20: String)

case class FooSequence4(string21: String,
  string22: String,
  string23: String,
  string24: String,
  string25: String,
  string26: String,
  string27: String,
  string28: String,
  string29: String,
  string30: String)

拡張によって複合型が 22個のパーティクルを超えることがあります．XML Schema は型システムの継承に似て，複合型を他の型から拡張することができます．一方，case class を継承することはできません．

代替グループ

Mon, 06 Sep 2010 04:34:48 +0000

XML Schema Part 0: Primer:

XML Schema には特定の要素を他の要素に差し替える代替グループという機構を持つ．具体的には，ヘッド要素と呼ばれる特定の要素に代替可能な特別な要素グループに他の要素を割り当てることができる．(ただし，ヘッド要素と代替可能な要素はグローバル要素に限る)

以下に代替グループの例を示します:

<complexType name="GH6Usage">
  <sequence>
    <element ref="ipo:gh6head"/>
    <element name="gh6head2" type="string" />
    <element name="city"   type="string"/>
  </sequence>
</complexType>

<element name="gh6head" type="string" abstract="true"/>
<element name="gh6sub1" type="string" substitutionGroup="ipo:gh6head" />
<element name="gh6sub2" type="string" substitutionGroup="ipo:gh6head" />
<element name="gh6head2" type="string" abstract="true"/>
<element name="gh6sub3" type="string" substitutionGroup="ipo:gh6head2" />
<element name="gh6sub4" type="string" substitutionGroup="ipo:gh6head2" />

ここには ipo:gh6head と ipo:gh6head2 という二つの代替グループがありますが，GH6Usage で使われているのは ipo:gh6head のみです．二つ目の要素 gh6head2 は ipo:gh6head2 と同じ名前が付けられていますが，GH6Usage のローカル要素です．以下が scalaxb が生成するコードです:

case class GH6Usage(gh6head: rt.DataRecord[Any],
  gh6head2: String,
  city: String)

object GH6Usage extends rt.ElemNameParser[GH6Usage] {
  val targetNamespace: Option[String] = Some("http://www.example.com/IPO")
  
  def parser(node: scala.xml.Node): Parser[GH6Usage] =
    (((rt.ElemName(targetNamespace, "gh6sub2")) ^^ 
      (x => rt.DataRecord(x.namespace, Some(x.name), x.node.text))) | 
    ((rt.ElemName(targetNamespace, "gh6sub1")) ^^ 
      (x => rt.DataRecord(x.namespace, Some(x.name), x.node.text)))) ~ 
      (rt.ElemName(targetNamespace, "gh6head2")) ~ 
      (rt.ElemName(targetNamespace, "city")) ^^
        { case p1 ~ 
      p2 ~ 
      p3 => GH6Usage(p1,
      p2.text,
      p3.text) }
        
  def toXML(__obj: GH6Usage, __namespace: Option[String], __elementLabel: Option[String]): scala.xml.NodeSeq = {
    var __scope: scala.xml.NamespaceBinding = scala.xml.TopScope
    __scope = scala.xml.NamespaceBinding("xsi", "http://www.w3.org/2001/XMLSchema-instance", __scope)
    __scope = scala.xml.NamespaceBinding("ipo", "http://www.example.com/IPO", __scope)
    __scope = scala.xml.NamespaceBinding(null, "http://www.example.com/IPO", __scope)
    val node = toXML(__obj, __namespace, __elementLabel, __scope)
    node match {
      case elem: scala.xml.Elem =>
        elem % new scala.xml.PrefixedAttribute(__scope.getPrefix(rt.Helper.XSI_URL),
          "type",
          "ipo:GH6Usage", elem.attributes)
      case _ => node
    }
  }
  
  def toXML(__obj: GH6Usage, __namespace: Option[String], __elementLabel: Option[String], __scope: scala.xml.NamespaceBinding): scala.xml.NodeSeq = {
    var attribute: scala.xml.MetaData  = scala.xml.Null
    
    scala.xml.Elem(rt.Helper.getPrefix(__namespace, __scope).orNull,
      __elementLabel getOrElse { error("missing element label.") },
      attribute, __scope,
      Seq.concat(rt.DataRecord.toXML(__obj.gh6head, targetNamespace, __obj.gh6head.key, __scope),
        scala.xml.Elem(rt.Helper.getPrefix(None, __scope).orNull, "gh6head2", scala.xml.Null, __scope, scala.xml.Text(__obj.gh6head2.toString)),
        scala.xml.Elem(rt.Helper.getPrefix(None, __scope).orNull, "city", scala.xml.Null, __scope, scala.xml.Text(__obj.city.toString))): _*)
  }
  

}

Mon, 06 Sep 2010 04:06:44 +0000

XML Schema Part 0: Primer より:

enumeration (列挙)ファセットは単純型を具体的な値の集合へと限定します．例えば，アメリカの州の略称を値とする USState という新しい単純型をstringから派生して定義するのに enumeration ファセットを利用することができます:

<xsd:simpleType name="USState">
  <xsd:restriction base="xsd:string">
    <xsd:enumeration value="AK"/>
    <xsd:enumeration value="AL"/>
    <xsd:enumeration value="AR"/>
    <!-- and so on ... -->
  </xsd:restriction>
</xsd:simpleType>

このような制限は case object を使って表現することができます．以下は scalaxb が生成するコードです:

trait USState

object USState {
  def fromXML(seq: scala.xml.NodeSeq): USState = fromString(seq.text)

  def fromString(value: String): USState = value match {
    case "AK" => AK
    case "AL" => AL
    case "AR" => AR
    case "DE" => DE

  }
}

case object AK extends USState { override def toString = "AK" }
case object AL extends USState { override def toString = "AL" }
case object AR extends USState { override def toString = "AR" }

scalaxb-appengine

Tue, 27 Jul 2010 18:46:49 +0000

scalaxb-appengine は scalaxb を web上で使うための RESTful API です．n8han/Unfiltered を使ってて，ソースは eed3si9n/scalaxb-appengine にあります．

compile

URL:

http://scalaxb.appspot.com/compile/_{output}.{format}_

フォーマット:

scala, zip

HTTP メソッド:

POST

HTTP エンコーディング:

multipart/form-data

パラメータ:

arg: 省略可，複数化．スキーマファイルの URL．

argf: 省略可，複数化．アップロードするスキーマファイル．
defaultPackageName: 省略可．対象パッケージ．
namespaceURI: 省略可，複数化．パッケージする名前空間 URI．
packageName: 省略可，複数化．namespaceURI によって指定された名前空間の対象パッケージ．
classPrefix: 省略可，生成されるクラス名のプレフィックスを指定します．
paramPrefix: 省略可，生成される仮引数名のプレフィックスを指定します．
wrapContents: 省略可，複数化．別の case class に追い出す複合型を指定します．

備考:

arg か argf かのどちらか一つは指定して下さい．

n番目の packageName が n番目の namespaceURI の対象パッケージを指定します．

scalaxb 0.2.0

Thu, 15 Jul 2010 04:51:09 +0000

<group>, <attributeGroup>, <all> のサポートを実装しました．
シーケンスを含んだ複合型のラウンドトリップを修正しました．
case class をすっきりさせるため，toXMLがコンパニオンオブジェクトに生成されるようになりました．

例えば，

<xs:complexType name="Address">
  <xs:sequence>
    <xs:element name="name"   type="xs:string"/>
    <xs:element name="street" type="xs:string"/>
    <xs:element name="city"   type="xs:string"/>
  </xs:sequence>
</xs:complexType>

から以下のようなコードが生成されます:

case class Address(name: String,
  street: String,
  city: String)

と

Tue, 13 Jul 2010 12:08:05 +0000

XML Schema Part 1 より:

モデルグループ定義を行うスキーマコンポーネントの XML 表現は<group> 要素である．これはXMLで表現された複合型定義内においてモデルグループの参照するための名前付けを行うためのものである．

<group> という機構を使うことによってスキーマ設計者は内容モデルの一部を型派生に頼ることなく再利用することができます．これは込み入ったスキーマを扱うときに便利なものです．例えば，以下のような head.misc という名前のグループと head という名前の要素を考えます．

<group name="head.misc">
  <sequence>
    <choice minOccurs="0" maxOccurs="unbounded">
      <xs:element ref="ipo:script"/>
      <xs:element ref="ipo:style"/>
    </choice>
  </sequence>
</group>

<element name="head">
  <annotation>
    <documentation>
      content model is "head.misc" combined with a single
      title and an optional base element in any order
    </documentation>
  </annotation>
  <complexType>
    <sequence>
      <group ref="ipo:head.misc"/>
      <choice>
        <sequence>
          <xs:element ref="ipo:title"/>
          <group ref="ipo:head.misc"/>
        </sequence>
        <sequence>
          <xs:element ref="ipo:base"/>
          <group ref="ipo:head.misc"/>
          <xs:element ref="ipo:title"/>
          <group ref="ipo:head.misc"/>          
        </sequence>
      </choice>
    </sequence>
    <attributeGroup ref="ipo:i18n"/>
    <attribute name="id" type="ID"/>
    <attribute name="profile" type="anyURI"/>
  </complexType>
</element>

ちょっとバカバカしいぐらいですが，実際に現場で使われるスキーマはこのぐらい複雑なものもあります．例えば，上の例は XHTML 1.0 Strict 規格から持ってきたものです．以下が生成されたコードの対応部分です:

scalaxb 0.1.0

Tue, 22 Jun 2010 10:06:33 +0000

パーサ・コンビネータを使った内容モデルのパーシングを実装しました．
xsi:nillableのサポートを実装しました (GH-3)．

生成されるパーサの一例です:

object Address extends rt.ElemNameParser[Address] {
  val targetNamespace = "http://www.example.com/IPO"

  def parser(node: scala.xml.Node): Parser[Address] =
    (rt.ElemName(targetNamespace, "name")) ~ 
      (rt.ElemName(targetNamespace, "street")) ~ 
      (rt.ElemName(targetNamespace, "city")) ^^
        { case p1 ~ 
      p2 ~ 
      p3 => Address(p1.text,
      p2.text,
      p3.text) }
}

xsi:nillable

Tue, 22 Jun 2010 06:02:49 +0000

XML において値の欠如を表現するのに要素を省くか空要素を使うかの方法があります．

未配送の物品，不明な情報，不適切な情報などを要素の欠落ではなく明示的に表現することが望ましい場合があります．

空要素 <foo></foo> を使うことの問題は，空の値が指定されている xs:positiveInteger にマッチしなくなってしまうことです．確かに，正の整数と空文字の両方を許容するために，xs:positiveInteger と空文字のみを含んだ xs:enumeration（列挙型）の xs:union(ユニオン型) を形成することも可能ですが，厳密には空文字と純粋な無の値は別物です．コードでいうと，null と "" の違い，特に Scala での None と Some("") の違いがあります．

XML Schema ではこの問題を解決するために xsi:nil という特別な属性を使います．

<price xsi:nil="true" />

と書くことで，XML Schema対応のパーサはこれが特別な空要素でその値が空文字ではなくnil値であると解釈します．ある要素において，可空性(nillability, 要素が空の値を取りうるか)と数性(cardinality, 要素が何個現れるか)は別問題であることに注意してください．つまり，minOccurs=0 で maxOccurs=1 のオプショナルでかつ nillable な要素を定義することもできるし，また，maxOccurs="unbounded" で nillable な要素を定義することもできます．そのような要素を使ってドキュメントの一例を示します:

<foo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <price xsi:nil="true" />
  <price>100</price>
  <price xsi:nil="true" />
</foo>

生成されたScalaコードにおいてnullと非nullのチェックを必要以上に導入したくなかったため，<price xsi:nil="true" /> は None 扱いされ，これは minOccurs=0 要素において要素が欠落している場合と同じ値になります．

<xs:element name="NillableTest">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="price" type="xs:positiveInteger" nillable="true"/>
      <xs:element name="tax" type="xs:positiveInteger" minOccurs="0" nillable="true"/>
      <xs:element name="tag" type="xs:positiveInteger" minOccurs="0" maxOccurs="unbounded" nillable="true"/>
  
      <xs:element name="shipTo" type="ipo:Address" nillable="true"/>
      <xs:element name="billTo" type="ipo:Address" minOccurs="0" nillable="true" />
      <xs:element name="via" type="ipo:Address" minOccurs="0" maxOccurs="unbounded" nillable="true" />
    </xs:sequence>
  </xs:complexType>
</xs:element>

以上の定義の要素は以下のコードを生成します:

パーサ・コンビネータを使ったパーシング

Mon, 14 Jun 2010 01:25:07 +0000

ハンド・パーシング(手書き構文解析)の限界は前から分かっていました．トークンの位置に頼ったパーシングは，文法に繰り返し，オプション，シーケンスの選択などの複雑なものが出てきたとたんに手に負えなくなります．ある時点で scala のパーサ・コンビネータを使って内容モデルをパーシングをしようと決めましたが，結構長く時間がかかってしまいました．

まずは，実際に使われているスキーマから複雑な構造を紹介しましょう:

<complexType name="SubjectType">
    <choice>
        <sequence>
            <choice>
                <element ref="saml:BaseID"/>
                <element ref="saml:NameID"/>
                <element ref="saml:EncryptedID"/>
            </choice>
            <element ref="saml:SubjectConfirmation" minOccurs="0" maxOccurs="unbounded"/>
        </sequence>
        <element ref="saml:SubjectConfirmation" maxOccurs="unbounded"/>
    </choice>
</complexType>

選択肢の中にシーケンスがあり，さらにその中に選択肢があります．さて，0.0.3 だとこれをどのように扱うでしょう．

case class SubjectType(arg1: org.scalaxb.rt.DataRecord[Any]) extends org.scalaxb.rt.DataModel {
....
}

生成された case class には rt.DataRecord[Any] しかありません．二番目の選択肢が saml:SubjectConfirmation の繰り返しである可能性を考えると，これは間違いでしょう．

object SubjectType {
  def fromXML(node: scala.xml.Node): SubjectType =
    SubjectType(SubjectTypeOption.fromXML(node.child.filter(_.isInstanceOf[scala.xml.Elem])(0))) 
}

パーシングにも問題があります．まず，上の方法では最初の子要素しか読み込んでいませんが，選択肢の両者とも複数の要素を扱う必要があります．

object SubjectTypeOption {  
  def fromXML: PartialFunction[scala.xml.NodeSeq, org.scalaxb.rt.DataRecord[Any]] = {
    case x: scala.xml.Elem if (x.label == "SubjectConfirmation" && 
        x.scope.getURI(x.prefix) == "urn:oasis:names:tc:SAML:2.0:assertion") =>
      org.scalaxb.rt.DataRecord(x.scope.getURI(x.prefix), x.label, SubjectConfirmationType.fromXML(x))
  }
}

パーシングの限界は SubjectTypeOption.fromXML の実装が一つの要素しか扱っていないことのにも起因しています．つまり，複数の要素を含んだ選択肢は完全に無視されているのです．

scalaxb 0.0.3

Thu, 01 Apr 2010 23:56:53 +0000

名前空間別にパッケージ名をつけれるオプションを実装しました．
<any>，<anyAttribute>，および混在内容のサポートを実装しました．
xmlドキュメントからscalaオブジェクトに変換して，そこからまたxmlドキュメントに変換できるようにするラウンド・トリップ機能を実装しました．

以下ラウンド・トリップの例です:

val subject = <foo xmlns="urn:example:ipo"
  xmlns:ipo="urn:example:ipo">
    foo<Choice2>2</Choice2>bar</foo>
val obj = Element3.fromXML(subject)
val document = obj.toXML(null, "foo", subject.scope)

混在内容

Thu, 01 Apr 2010 23:43:45 +0000

一つの要素内にテキストノードと子要素が並列して混在している混在内容のサポートを実装しました．<any>と同様にテキストは他のDataRecordオブジェクトと一緒にDataRecord[String]オブジェクトの中に保存され，mixedという値で呼ばれます．

次のようなスキーマがあるとすると，，

<element name="Element3">
  <complexType mixed="true">
    <choice maxOccurs="unbounded">
      <element ref="ipo:Choice1"/>
      <element ref="ipo:Choice2"/>
      <any namespace="##other" processContents="lax" />
    </choice>
  </complexType>
</element>

使用例のコードは以下のようになります．

val subject = <foo xmlns="http://www.example.com/IPO"
    xmlns:ipo="http://www.example.com/IPO">foo<Choice2>2</Choice2>bar</foo>
val obj = Element3.fromXML(subject)
obj match {
  case Element3(Seq(DataRecord("http://www.example.com/IPO", "Choice2", 2)),
    Seq(DataRecord(null, null, "foo"),
      DataRecord("http://www.example.com/IPO", "Choice2", 2),
      DataRecord(null, null, "bar"))) =>
  case _ => error("match failed: " + obj.toString)
}
val document = obj.toXML(null, "foo", subject.scope)

と

Mon, 29 Mar 2010 04:35:21 +0000

前回

今後の予定としては，このジェネリックなコンテナを使って現在切り捨てている<any>をちゃんと変換することです．おそらくscala.xml.Elemをそのままの形でコレクションの中に残しておくような形になると思います．一旦ラウンド・トリップ機能を提供すると，ユーザは途中で荷物が無くならないことを期待すると思うので．

と書いたとおり， <any>の処理を変更しました．<any>の処理には2パターンあって，まずsequence の一部として使われる場合.

<element name="Choice1">
  <complexType>
    <sequence>
      <any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
  </complexType>
</element>

scalaxb は以下のコードを生成します:

case class Choice1(any: org.scalaxb.rt.DataRecord[scala.xml.Node]*) extends org.scalaxb.rt.DataModel {
    
  def toXML(namespace: String, elementLabel: String, scope: scala.xml.NamespaceBinding): scala.xml.Node = {
    val prefix = scope.getPrefix(namespace)
    var attribute: scala.xml.MetaData  = scala.xml.Null
    
    scala.xml.Elem(prefix, elementLabel,
      attribute, scope,
      Seq(any.map(x => x.toXML(x.namespace, x.key, scope))).flatten: _*)
  }
}

object Choice1 {
  def fromXML(node: scala.xml.Node): Choice1 =
    Choice1((node.child.partialMap {
      case x: scala.xml.Elem =>
        org.scalaxb.rt.DataRecord(x.scope.getURI(x.prefix), x.label, x) }).toList: _*) 
}

次にchoice の選択肢として使われる場合．

<element name="Element1">
  <complexType>
    <sequence>
      <choice maxOccurs="unbounded">
        <element ref="ipo:Choice1"/>
        <any namespace="##other" processContents="lax" />
      </choice>
    </sequence>
  </complexType>
</element>

scalaxb は以下のコードを生成します:

ラウンド・トリップ

Thu, 25 Mar 2010 12:27:54 +0000

ラウンド・トリップ（往復券）の実装を始めています．つまり，xmlドキュメントからscalaオブジェクトに変換して，そこからまたxmlドキュメントに変換できるようにする機能です．以下のようなドキュメントがあるとして，

val subject = <shipTo xmlns="http://www.example.com/IPO"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ipo="http://www.example.com/IPO"
    xsi:type="ipo:USAddress">
  <name>Foo</name>
  <street>1537 Paper Street</street>
  <city>Wilmington</city>
  <state>DE</state>
  <zip>19808</zip>
</shipTo>

fromXML()を呼び出すことでオブジェクトに変換できます

val obj = Addressable.fromXML(subject)

でさらにtoXML()を呼び出すことでxmlドキュメントに再変換できます

obj match {
  case usaddress: USAddress =>
    val document = usaddress.toXML("shipTo")
    println(document)
  case _ => error("parsed object is not USAddress") 
}

これは以下のxmlドキュメントを生成します:

<shipTo xsi:type="ipo:USAddress" xmlns="http://www.example.com/IPO" xmlns:ipo="http://www.example.com/IPO" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><name>Foo</name><street>1537 Paper Street</street><city>Wilmington</city><state>DE</state><zip>19808</zip></shipTo>

意味論的には元のドキュメントと同一のものですね．ラウンド・トリップを実装してて再度気付かされたのが，xmlでは型の他に要素名も情報を持つということです．以下XML暗号より抜粋:

<element name='ReferenceList'>
  <complexType>
    <choice minOccurs='1' maxOccurs='unbounded'>
      <element name='DataReference' type='xenc:ReferenceType'/>
      <element name='KeyReference' type='xenc:ReferenceType'/>
    </choice>
  </complexType>
</element>

DataReferenceとKeyReferenceの両要素ともxenc:ReferenceTypeの型ですが，オブジェクトが型情報しか保存しない場合，xmlドキュメントに変換する時にどっちの要素に戻っていいのか分からなくなってしまいます．この曖昧さはオブジェクトの使用時にも当然問題になります．

DataRecord[A]というパラメタ化したcase classにオブジェクトと要素名を両方保存することで解決しました．

case class DataRecord[A](key: String, value: A) {
  def toXML(elementLabel: String,
      scope: scala.xml.NamespaceBinding): scala.xml.Node = value match {
    case x: DataModel => x.toXML(elementLabel, scope)
    case _ => scala.xml.Elem(null, elementLabel, scala.xml.Null, scope,
      scala.xml.Text(value.toString))
  }
}

case classをパラメタ化することで，choiceラッパーもいらなくすることができました．

名前空間別パッケージ名

Sat, 20 Mar 2010 18:28:37 +0000

名前空間ごとに別のパッケージ内にクラスを生成できるようになりました．

  -p:<namespaceURI>=<package> | --package:<namespaceURI>=<package>
        specifies the target package for <namespaceURI>

例えばXML SignatureとSAML 2.0 assertionは別のパッケージの方がいいですね:

$ scalaxb -p:http://www.w3.org/2000/09/xmldsig#=org.w3.xmldsig -p:http://www.w3.org/2001/04/xmlenc#=org.w3.xmlenc -p:urn:oasis:names:tc:SAML:2.0:assertion=org.xml.saml2.assertion -p:urn:oasis:names:tc:SAML:2.0:metadata=org.xml.saml2.metadata saml-schema-metadata-2.0.xsd saml-schema-assertion-2.0.xsd xenc-schema.xsd xmldsig-core-schema.xsd 
generated ./xmldsig-core-schema.scala
generated ./xenc-schema.scala
generated ./saml-schema-assertion-2.scala
generated ./saml-schema-metadata-2.scala
$ scalac xmldsig-core-schema.scala xenc-schema.scala saml-schema-assertion-2.scala saml-schema-metadata-2.scala Helper.scala

これは結構長い事欲しかった機能で，scoptにkeyValueOptを実装したのが一週間前なので，最低でも一週間ですね．これにより，Helper object は Helper.scala というファイル内のorg.scalaxb.rtというパッケージに移行します．