Magic xpiトレーニングテキスト
13. 基本的なアダプタの使い方その4

13.1 Web Serviceとは

【Web Serviceとは】

• インターネットに関連する技術を応用して、ソフトウェアの機能をネットワークを通じて利用できるようにするための技術、または、そのような形態で提供されるサービスのこと
• 異なるOSや言語やツールでも利用可能であるのが特徴のひとつ
• Webアプリケーションはブラウザなどを使用して人間が利用するものであるのに対して、Web Serviceはプログラムが利用するAPI
• 古くからある高機能で複雑なSOAPと、昨今急速に普及してきたシンプルなRESTがある

【SOAPとは】

• SOAPはSimple Object Access Protocolの略
• リクエスト、レスポンスともにXMLフォーマットのデータで行う形式
• SOAPのURLは操作と対応づけられるため、URLの命名が動詞的になることが多い

【RESTとは】

• RESTはREpresentational State Transferの略
• RESTの世界では、ネットワーク上のコンテンツ(リソース)を一意なURLで表すのが基本
• 各リソース（URL）に対してGET、POST、PUT、DELETEでリクエストを送信し、レスポンスをXMLやJSONなどで受け取る形式（レスポンスのフォーマット形式は指定されていない）
• RESTのURLはリソースと対応づけられるため、URLの命名が名詞的になることが多い

13.2 コンポーネントとサービス

• xpiで使用できるWebサービス関連のコンポーネントは下記の通りです。
• Web Servicesコンポーネントを使用する場合は、サービス「Magic xpi 4.13 Soap Service」の起動が必要です。
• 次章の演習では、REST Clientコンポーネントを扱います。

13.3 テスト用RESTサービスの準備

【テスト用RESTサービスの準備】 ※トレーニング用マシンでは準備されているので下記手順の実施は不要です。

• REST Clientコンポーネントを使用するためには、接続先となるRESTサービスが必要です。
• 次章の演習では、REST APIを備えたプロジェクト管理ソフトウェアRedmineを使用します。
• Redmineの環境構築にはBitnamiを使用します。

【BitnamiのRedmineインストール】

• BitnamiのサイトからRedmineのインストーラをダウンロードし、インストールします。

【Redmineの設定】

• Redmineの管理画面にて下記の設定を行います。

13.4 REST Clientコンポーネント

【REST Clientリソースの定義】

• メニュー > プロジェクト > 設定よりREST Clientリソースを定義します。

【パスとパラメータの定義】

• リソース設定画面で「パス」ボタンを押し、パス画面でパスとパラメータを定義します。

【REST Clientコンポーネントの設定】

• REST Clientコンポーネントをダブルクリックし、REST Client構成画面で設定します。

【REST Clientコンポーネントの設定】

• マッパ画面では、リクエストボディなどを設定します。