2009-07-02 8 views
1

私は、一連のWebサービスのファサードとして機能するアプリケーションを文書化する必要があります。アプリケーションはSOAP要求を受け取り、これらの要求を基礎となるWebサービスが理解できる形式に変換します。このようなサービスはいくつかあり、それぞれ独自のインターフェースを備えています。 SOAPを受け入れるものもあればHTTP POSTを受け入れるものもあれば、礼儀正しい社会で言及されていない他の形式もあります。人間が読める形式でツリーツーツリー変換をどのように文書化しますか?

SOAPコールのフィールドとこれらの他のフォーマットのフィールドをどのようにマッピングするかを文書化する必要があります。誰もが "XSLT"を叫ぶ前に、その表記は人間にやさしいものでなければならないと言わなければなりません。理想的には、Excel可能なものになります。

誰もこの種の問題に遭遇しましたか?どのように解決しましたか?スプレッドシートに収まるツリーツーツリー変換のための、人間にやさしい表記法はありますか?

+0

XSLT:参考のために、私は、ここですべてのJavaBeanへの変換のJavaBeanのいくつかの種類をやって最も有望なものをリストアップしています! (申し訳ありませんが、私は抵抗できませんでした:D) – Tomalak

+0

私はそれを理解しています - 文書化するだけですか(例:読み取り専用表現)フィールドマッピングが単純な形式で含まれているリスト? – Tomalak

+0

@Tomalak私は本当にそれを文書化する必要があります。私たちが始めたのは、フィールドごとに1つの行(およびそのXPath)を持つExcelスプレッドシートと、それがマップされた場所を示す別の列でした。しかし、これは容易に解読できなくなり、より複雑な構造ではうまく機能しません。 – lindelof

答えて

0

私はちょうどこれをしなければなりませんでした。私がやったやり方は、階層的な構造にしたがって、ちょうど書き込みを始めることでした。

最終的に私は自分自身を繰り返していることが分かりました。一例は、特定の要素に共通の属性セットがあることです。私は、特定の要素に関するセクションの前にその共通の設定のドキュメントを引き出すだろう。特定のsimpleTypesの処理に関するドキュメンテーションと同じこと。

結局のところ、全体的な流れと変換の "哲学"についての高レベルの議論さえありました。しかし、私はそれがすべて繰り返されて退屈になったので、それを修正し、ビットごとに少しずつ起こさせました。

つまり、私は技術者ではなく開発者です。

0

私はこれまでに何も見つけ出していませんが、Javaのあるタイプのオブジェクトを別のタイプに変換するのに役立つ多くのライブラリへのポインタを見つけました。

関連する問題