ネットワークサービス用XMLインターフェース

XML Interface for Network Services ( XINS ) は、仕様指向のアプローチを強制するインターネットアプリケーションの定義と実装のためのオープンソース技術です。 ^{[ 1 ]}

仕様指向のアプローチは、XINSの中核を成すものです。

• まず仕様書を作成する必要がある。
• そして、これらの仕様に基づいてドキュメントとコードが生成されます。
• そうすれば、テストと実装の両方を開始できます。

仕様によると、XINSは以下を生成できます。

• HTMLドキュメント
• テストフォーム
• SOAP準拠のWSDL
• 基本的なJavaウェブアプリケーション
• 単体テストコード（Java）
• スタブ（Java）
• クライアント側のコード（Java）

技術的には、XINSは以下の要素で構成されています。

• プロジェクト、API、関数、型、エラーコードのためのXMLベースの仕様フォーマット
• POXスタイルのRPCプロトコル（XINS標準呼び出し規約と呼ばれる）で、Webブラウザと互換性がある（入力はHTTPパラメータ、出力はXML）。
• 仕様書から人間が読める形式のドキュメントを生成するツール。
• 仕様書からWSDLを生成するためのツール。
• Log4jをベースとしたログ記録技術（Logdocと呼ばれる）で、仕様フォーマット、ログメッセージの国際化、HTMLドキュメントの生成、およびコードの生成機能を提供する。
• XINS関数を呼び出すためのJavaライブラリ、XINS/Javaクライアントフレームワーク。xins-client.jarに含まれています。
• JavaベースのXINS API実装用のサーバーサイドコンテナであるXINS/Java Server Framework（xins-server.jarに含まれています）。これはXINS API用のサーブレットコンテナのようなものです。
• XINS/JavaクライアントフレームワークとXINS/Javaサーバーフレームワークの両方で使用される、共通機能を持つJavaライブラリ：XINS/Java共通ライブラリ（xins-common.jar内）。

「 XINS入門」と呼ばれる入門チュートリアルでは、スクリーンショット付きで分かりやすい手順を丁寧に解説し、読者を丁寧にサポートします。

バージョン1.3.0以降、XINS/Java Server FrameworkはPOXスタイルの呼び出しだけでなく、SOAPとXML-RPCもサポートしています。また、 XSLTを使用した変換もサポートしています。バージョン2.0以降では、JSONとJSON-RPCもサポートしています。

XINSはオープンソースであり、寛容なBSDライセンスの下で配布されています。^{[ 2 ]}

XINSの仕様ファイルはすべてプレーンなXMLです。SOAP 、WSDL 、UDDIなどと比較すると、フォーマットは非常にシンプルです。プロジェクト、環境リスト、API、関数、型、エラーコードに関する仕様が含まれています。

以下は、XINSプロジェクト定義の例です。

<project name= "MyProject" domain= "com.mycompany" > <api name= "MyAPI" > <impl/> <environments/> </api> </project>

環境リストの仕様例を以下に示します。

<environments> <environment id= "netarray" url= "http://xins.users.mcs2.netarray.com/myproject/xins/" /> </environments>

API仕様ファイルの例：

<api name= "MyAPI" > <description>初めてのXINS API </description> < function name= "Hello" /> </api>

関数定義の例：

<function name= "Hello" > <description>指定された人に挨拶します。</description> <input> <param name= "name" required= "true" > <description>挨拶する人の名前。</description> </param> </input> <output> < param name= "greeting" required= "true" > <description>作成された挨拶。</description> </param> </output> </function>

XINS標準呼び出し規約は、シンプルなHTTPベースのRPCプロトコルです。入力はHTTPパラメータで構成され、出力はXMLドキュメントです。この方式により、一般的なWebブラウザとの互換性が確保されます。

リクエストの例：

[permanent dead link]"}]],"parts":["http://somehost/someapi/?_convention=_xins-std&_function=SayHello&firstName=John&lastName=Doe",{"template":{"target":{"wt":"dead link","href":"./Template:Dead_link"},"params":{"date":{"wt":"July 2016"},"bot":{"wt":"InternetArchiveBot"},"fix-attempted":{"wt":"yes"}},"i":0}}]}">http://somehost/someapi/?_convention=_xins-std&_function=SayHello&firstName=John&lastName=Doe

成功した応答の例：

<result> <param name= "greeting" >こんにちは、ジョン・ドゥさん！</param> </result>

XINSと同様に、仕様指向開発への統合的なアプローチを提供する既知の製品は存在しません。しかし、XINSの個々の機能と同様の機能を提供するフレームワークやライブラリはいくつか存在します。例えば、以下のようなものがあります。

• JWSDP ： Javaプログラミング言語向けの様々なXMLおよびSOAP技術のコレクション。
• Apache Axis：SOAP実装のためのJavaベースのフレームワーク。
• Codehaus XFire : 同上。
• Hessian Web Service Protocol : XINS 標準呼び出し規約のバイナリ代替。^{[ 3 ]}

• XINSウェブサイト
• よくある質問