11

XSD スキームで表されるデータ モデルを設計しました。データ モデルは、WSDL 記述子で Web サービス パラメータとして使用される型も提供します。

XSD スキームを送信し、関係者にデータ モデルのピア レビューを依頼したいと思います。

査読の基礎として使用するために、どのツールまたはプレゼンテーション方法を提案しますか? データ モデルは、少なくともパラメータの意味的な意味に関しては、熟練していない人でも読めるようにする必要があります。

編集：

より具体的に言うと、もちろん、構文的には、スキームは検証されます。実際、私はすでに JAXB 生成クラスに基づくコードに取り組んでいます。私の目標は

  1. データモデルを凍結し、入力パラメータを凍結します
  2. セマンティック（ビジネス関連の意味で）の観点から、何も失われたり忘れられたりしないようにするためです。

編集 2

私は、データモデルを広めるのがおそらくどのように最善であるかについて考えてきました。XSD スキーマの JavaDoc のようなものを考えています。そのようなものが存在するかどうか誰でも知っていますか？基本的には、一連の XSLT を使用して実行されますよね?

4

5 に答える 5

0

何かに XSD を使用することをお勧めします。具体的には、いくつかの実際のアプリケーションを、例を実際のコードとして示します。

スキーマを面白くするのは、実際のアプリケーションです。例は、大きくて洗練されていたり、完全に現実的である必要はありません。コンパイルするだけです。他の人は、コード サンプルをコピーして貼り付けたいと思うでしょう。

これらの例は、スキーマの「Hello World」です。そして、それらはスキーマの一種の単体テストとして機能します。

于 2008-10-14T17:22:59.953 に答える
0

** 開示 : 私は、下記のドキュメンテーション ツールのプロデューサーである Innovasys で働いています*

Innovasys Documentをご覧ください。×。すべての要素、単純型、複合型、グループ、および属性グループの構造化およびリンクされたページを自動的に生成するだけでなく、リンクされた XSD ダイアグラム (シーケンス/選択などを含む) および XSD からの注釈を含む構造テーブルも生成します。スキーマ内の要素間の関係を理解し​​てください。出力はテンプレート ベースであるため、好みのスタイルと構造に適応させることができます。出力を Web 対応の html またはコンパイル済みのヘルプ ファイルにビルドします。

ユニークな点として、追加のコンテンツを作成して、自動的に生成されたものや XSD ソースからの注釈を補足できる WYSIWYG エディターも含まれているため、ピア レビュー用に追加のコンテキスト情報を提供できます。また、生成された出力を表示してコメントやフィードバックを記録し、Document 内から直接表示してアクションを実行できるようにする Community Extensions 機能もあります。バツ。

于 2011-08-11T09:54:42.723 に答える
0

非常に有用な Oxygen XML 開発者は、ドキュメントの生成もサポートしています 。http://www.oxygenxml.com/xml_schema_documentation.htmlを参照してください (商用ですが、完全に機能する 30 日間の試用版が利用可能です) 。

すべてのタイプと使用可能な xsd:documentation 記述を単純なインターフェース記述として含むドキュメントを生成する簡単な方法が必要です...

于 2012-03-29T13:39:00.180 に答える
0

私が見た XML スキーマの Javadoc に最も近いのは、スキーマから生成されたソースに対して Javadoc ツールを実行することです。これには次の 2 つのことが必要です。1) スキーマにそれを文書化する内部注釈要素があること、および 2) ソース ジェネレータがそれらの注釈を Javadoc 要素として使用すること。

于 2009-01-23T19:43:24.673 に答える