• ユーザビリティの向上
• デコード関数、エンコード関数のインタフェース変更
• MSV、Jing、Trang、Xalan の同梱
• 必要なソフトウェアとインストール方法の同梱
• 機能拡張
• 生成ソースコードの最適化
• datatypeLibrary の hexBinary型対応
• 不具合対応
• ゼロパディングされた value 要素
• separator, delimiter に ' や `` を指定
• ランタイムエラーの Hex Dump の時の表示
• <value> で大きい数値を指定すると、コンパイル時に警告やエラーが発生する
• <value type=''float``>3.14</value> で値がマッチしない
• エラーメッセージに XSLT 云々が表示される
• 環境変数未チェック

[20061122 版 umsCodeGenerator リリース] Mitsuhiro TOYODA, Keiichi MATSUZAKI, Hiroyuki YAMAJI

ユーザビリティの向上

デコード関数、エンコード関数のインタフェース変更

以下の点を変更しました。

• デコード関数の戻り値で、デコード処理ビット数を返すようにした。（これまでは void）
  
• エンコード関数の戻り値で、エンコード処理ビット数を返すようにした。（これまでは void）
  
• エンコード関数の第2引数を、出力バッファ長にした。（これまでは、出力バッファ長をポインタ、または長さ1の配列として関数に渡し、関数内でその変数にエンコード処理ビット数を格納していた）
  
• C言語版について、データ格納バッファとビット長を格納する変数は、typedef した型を使用するようにした。（これまでは「char」 、「int」 とプリミティブ型をそのまま使用していた）
  

各言語ごとのインタフェースは以下のとおりです。

• C言語版
  
C言語版では、デコード関数、エンコード関数を呼び出すファイルで、「ums.h」 をインクルードしてください。

      /**
       * デコード処理を行う。
       *
       * @param ums__buffer 入力データ格納バッファ
       * @param ums__bitlen 入力データ長(bit)
       *                    ※入力データそのもののデータであり、入力格納バッファのサイズではない。
       * @param ums__ex 例外情報
       * @return デコードデータサイズ(bit)
       */
      ums__bitlen_t decode( ums__bitdata_t *ums__buffer, ums__bitlen_t ums__bitlen, ums__exception_t *ums__ex )

      /**
       * エンコード処理を行う。
       *
       * @param ums__buffer 出力データ格納バッファ
       * @param ums__bitlen 出力データ格納バッファの長さ(bit)
       * @param ums__ex 例外情報
       * @return エンコードデータサイズ(bit)
       */
      ums__bitlen_t encode( ums__bitdata_t *ums__buffer, ums__bitlen_t ums__bitlen, ums__exception_t *ums__ex )

• Java版
  

      /**
       * デコード処理を行う。
       *
       * @param ums__buffer 入力データ格納バッファ
       * @param ums__bitlen 入力データ長(bit)
       *                    ※入力データそのもののデータであり、入力格納バッファのサイズではない。
       * @return デコードデータサイズ(bit)
       * @exception UMSException デコード処理エラー
       */
      int decode( byte[] ums__buffer, int ums__bitlen ) throws UMSException

      /**
       * エンコード処理を行う。
       *
       * @param ums__buffer 出力データ格納バッファ
       * @param ums__bitlen 出力データ格納バッファの長さ(bit)
       * @return エンコードデータサイズ(bit)
       * @exception UMSException エンコード処理エラー
       */
      int encode( byte[] ums__buffer, int ums__bitlen ) throws UMSException

MSV、Jing、Trang、Xalan の同梱

MSV、Jing、Trang、XALAN を以下のディレクトリに配置しました。

  umsCodeGenerator/yyyymmddvv/lib/msv
                                 /jing
                                 /trang
                                 /xalan

これに伴い、これまで必要だった以下の作業が不要になりました。

• MSV のインストールと環境変数 $MSV_HOME の設定
  
• Jing のインストールと環境変数 $JING_HOME の設定
  
• Trang のインストールと環境変数 $TRANG_HOME の設定
  
• Xalan のインストールと環境変数 $XALAN_HOME の設定
  

各々のツールのライセンスおよびコピーライトは以下の通りです。

• MSV LICENSE
• MSV COPYRIGHT
• Jing COPYING
• Trang COPYING
• apache 1.1 LICENSE
• apache 2.0 LICENSE

- [Bugzilla #655 XALAN、MSV、JING の同梱 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=655 ]

必要なソフトウェアとインストール方法の同梱

umsCodeGenerator を実行するために必要なソフトウェアと、umsCodeGenerator のインストール手順を テキストファイルに記述し、配布に含めました。

機能拡張

生成ソースコードの最適化

list 構造と interleave 構造のデータを処理する生成ソースコードについて、 不要な処理コードを生成しないようにしました。

datatypeLibrary の hexBinary型対応

datatypeLibrary が hexBinary型に対応しました。 以下のようにスキーマを記述することができます。

  <txt:byte>
    <txt:value type="hexBinary">89AB</txt:value>
  </txt:byte>

不具合対応

ゼロパディングされた value 要素

ゼロパディングされた value 要素の値について、正しく処理するようにいたしました。

- [Bugzilla #77 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=77 ]

separator, delimiter に ' や `` を指定

' や `` を区切りに使用したい場合は、以下のように記述してください。

  <list delimiter='\"'/>
  <list separator="\'"/>

- [Bugzilla #520 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=520 ]

ランタイムエラーの Hex Dump の時の表示

「0x80」 を超えた際に、「ffffff80」 と表示せず、「80」と表示するようにしました。

- [Bugzilla #679 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=6797 ]

<value> で大きい数値を指定すると、コンパイル時に警告やエラーが発生する

各々の変数の型でキャストし、コンパイル時に警告やエラーが発生しないようにしました。

- [Bugzilla #668 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=668 ]

<value type=``float''>3.14</value> で値がマッチしない

リテラルの側をキャストし、値がマッチするようにしました。

- [Bugzilla #667 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=667 ]

エラーメッセージに XSLT 云々が表示される

余分なスタックトレースが表示されないようにしました。

- [Bugzilla #682 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=681 ]

環境変数未チェック

以下のチェックを行うようにしました。

• TABLETOOLS_HOME が設定してあるかどうか
  
• TABLETOOLS_TEMP が設定してあるかどうか
  
• TABLETOOLS_TEMP で指定されたディレクトリがあるかどうか
  
• TABLETOOLS_TEMP で指定されたディレクトリに書き込み権限があるかどうか
  
• UMS_THREAD が設定してあるかどうか
  

- [Bugzilla #55 http://eda.plain.isas.jaxa.jp/bugzilla/show_bug.cgi?id=55 ]

以上