matlab.wsdl.createWSDLClient

SOAP ベースの Web サービスへのインターフェイスの作成

ページ内をすべて折りたたむ

構文

matlab.wsdl.createWSDLClient(wsdlURL)

matlab.wsdl.createWSDLClient(wsdlURL,folder)

matlab.wsdl.createWSDLClient(wsdlURL,folder,'silent')

matlab.wsdl.createWSDLClient(___,options)

classname = matlab.wsdl.createWSDLClient(___)

説明

例

matlab.wsdl.createWSDLClient(wsdlURL) は、wsdlURL によって指定された WSDL (Web サービス記述言語) ドキュメントに基づいてサービスへのインターフェイスを作成します。この関数は WSDL で記述された SOAP (簡易オブジェクトアクセスプロトコル) の各バインディングに対して 1 つの MATLAB^® クラスファイルを現在のフォルダーに作成します。必要に応じて追加のサポートファイルも作成されます。これらのファイルはパッケージして他のユーザーに配布することができます。

WSDL ツール、Java^® JDK™ および Apache^® CXF ソフトウェアをインストールしてから、関数 matlab.wsdl.setWSDLToolPath を使用してツールパスを設定しなければなりません。

現在のフォルダーに対して書き込み権限がなければなりません。

matlab.wsdl.createWSDLClient(wsdlURL,folder) はインターフェイスファイルを folder に作成します。これは MATLAB パス上になければなりません。

matlab.wsdl.createWSDLClient(wsdlURL,folder,'silent') は生成されたファイルとフォルダーの表示を抑制します。

matlab.wsdl.createWSDLClient(___,options) は、WSDL ドキュメントへのアクセスに必要な追加情報を指定します。この構文では、前述の構文の入力引数のいずれかを使用できます。

classname = matlab.wsdl.createWSDLClient(___) は、作成したクラスのハンドルを返します。複数のクラスが作成された場合、関数はハンドルの cell 配列を返します。この構文では、前述の構文の入力引数のいずれかを使用できます。

クラスの使用方法に関する情報を取得するには、そのクラス名で MATLAB の関数 help を呼び出します。

例

すべて折りたたむ

`USGSImageryOnly_MapServer` Web サービスからのマップ名の取得

この例を実行するには、WSDL ツールをインストールしてツールパスを設定します。jdk および cxf は、使用しているシステム上のこれらのツールへのパスです。

matlab.wsdl.setWSDLToolPath('JDK',jdk,'CXF',cxf)

クラスファイルを作成します。

url = ...
'http://basemap.nationalmap.gov/arcgis/services/USGSImageryOnly/MapServer?wsdl';
matlab.wsdl.createWSDLClient(url)

Created USGSImageryOnly_MapServer.
  .\USGSImageryOnly_MapServer.m
  .\+wsdl

In order to use USGSImageryOnly_MapServer, you must run javaaddpath('.\+wsdl\mapserver.jar').

jar ファイルを Java パスに追加します。

javaaddpath('.\+wsdl\mapserver.jar')

サービスを作成します。

wsdl = USGSImageryOnly_MapServer;

サービスとその関数のヘルプを参照します。

help USGSImageryOnly_MapServer

USGSImageryOnly_MapServer   A client to connect to the USGSImageryOnly_MapServer service
     SERVICE = USGSImageryOnly_MapServer  connects to http://basemap.nationalmap.gov/arcgis/services/USGSImageryOnly/MapServer and returns a SERVICE.
     
     To communicate with the service, call a function on the SERVICE:
 
        [...] = FUNCTION(SERVICE,arg,...) 
 
     See doc USGSImageryOnly_MapServer for a list of functions.

マップ名を返す GetDefaultMapName など、いずれかのメソッドを呼び出します。

GetDefaultMapName(wsdl)

ans =

Layers

入力引数

すべて折りたたむ

`wsdlURL` — WSDL URL またはファイルパス
string | 文字ベクトル

WSDL URL またはファイルパス。サービスメソッド、引数、およびトランザクションを定義する string または文字ベクトルとして指定します。

wsdlURL は http または https URL またはローカルパスにすることができます。 wsdlURL を file:// URL にすることはできません。Microsoft^® Windows^® では、UNC パスはサポートされていません。

例: 'http://www.mywebservice.com/servicename?WSDL'

`folder` — 生成されたファイルのフォルダー
string | 文字ベクトル

生成されたファイルのフォルダー。string または文字ベクトルとして指定します。省略するか空 ('') の場合、matlab.wsdl.createWSDLClient は現在のフォルダーを使用します。フォルダーに対する書き込み権限がなければなりません。関数は生成されたファイルと同じ名前で既存のファイルを上書きします。

例: 'c:\work'