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

XML Interface for Network Services ( XINS ) は、仕様指向のアプローチを実施するインターネット アプリケーションの定義と実装のための オープン ソーステクノロジです。

仕様指向のアプローチは 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 サーバー フレームワーク(xins-server.jar 内)。これは、XINS API 用のサーブレット コンテナのようなものです。
• XINS/Java クライアント フレームワークと XINS/Java サーバー フレームワークの両方で使用される、いくつかの共通機能を備えた Java ライブラリ: xins-common.jar 内のXINS/Java 共通ライブラリ。

XINS Primer と呼ばれる入門チュートリアルでは、スクリーンショットを使用して、実行するためのわかりやすい手順を読者に案内します。

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

XINS はオープンソースであり、自由なBSD ライセンスに基づいて配布されます。

すべての XINS 仕様ファイルはPlain Old XMLです。SOAP / WSDL / UDDIなどと比較すると、形式は非常にシンプルです。プロジェクト、環境リスト、API、関数、タイプ、エラー コードの仕様があります 。

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

<プロジェクト名= "MyProject"ドメイン= "com.mycompany" > <api名= "MyAPI" > <impl/> <environments/> </api> </project>  
   
    
    
  

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

<環境> 
<環境ID = "netarray" URL = "http://xins.users.mcs2.netarray.com/myproject/xins/" /> </環境>    

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 ブラウザとの互換性が確保されます。

リクエストの例:

http://somehost/someapi/?_convention=_xins-std&_function=SayHello&firstName=John&lastName=Doe [永久リンク切れ‍ ]

成功した応答の例:

<result> 
<param name= "greeting" >こんにちは、John Doeさん！</param> </result>      

XINS と同様に、仕様指向開発への統合アプローチを提供する既知の製品はありません。ただし、XINS の個々の部分と同様の機能を提供するフレームワークとライブラリはいくつかあります。

• JWSDP : Java プログラミング言語用のさまざまなXMLおよびSOAPテクノロジのコレクション。
• Apache Axis : SOAP 実装用のJavaベースのフレームワーク。
• Codehaus XFire : 同上。
• Hessian Web サービス プロトコル: XINS 標準呼び出し規約のバイナリ代替。

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