matlab.wsdl.createWSDLClient

Создайте интерфейс к основанному на SOAP веб-сервису

Синтаксис

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) создает интерфейс к сервису на основе документа Языка описания веб-сервисов (WSDL), заданного wsdlURL. Эта функция создает файл класса MATLAB® для каждой привязки простого протокола доступа к объектам (SOAP) в WSDL в текущей папке. При необходимости функция создает дополнительные файлы поддержки. Можно группировать и распределить эти файлы другим пользователям.

Необходимо установить инструменты 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(___) возвращает указатель на созданный класс. Если несколько классов были созданы, функция возвращает массив ячеек указателей. Можно использовать этот синтаксис с любым из входных параметров предыдущих синтаксисов.

Чтобы получить информацию об использовании класса, вызовите функцию help MATLAB на имени класса.

Примеры

свернуть все

Чтобы запустить этот пример, установите инструменты 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').

Добавьте файлы банки в путь 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

Входные параметры

свернуть все

URL WSDL или путь к файлу, заданный как строка или вектор символов, который задает сервисные методы, аргументы и транзакции.

wsdlURL может быть http или https URL или локальный путь. wsdlURL не может быть URL file://. На Microsoft® Windows® не поддержаны пути UNC.

Пример: 'http://www.mywebservice.com/servicename?WSDL'

Папка для сгенерированных файлов, заданных как строка или вектор символов. Если не использовано или пустой (''), matlab.wsdl.createWSDLClient использует текущую папку. У вас должно быть разрешение записи для папки. Функция перезаписывает существующие файлы с теми же именами как сгенерированные файлы.

Пример: 'c:\work'

Дополнительные опции, заданные как объект weboptions, должны были получить доступ к документу WSDL, такому как Username, Password и Timeout.

Дополнительные опции, заданные в weboptions, не применяются ни к каким другим документам, таким как другие импортированные документы WSDL или схемы, что первичные ссылки на документы WSDL. Опции также не применяются к запросам, выполненным серверам сгенерированным кодом.

Пример: 'Username','john','Password','mypassword'

Советы

  • Если вы создаете файлы WSDL в нескольких местоположениях на вашем компьютере, избегаете беспорядка путем удаления файлов класса из дублирующихся местоположений, и затем вызываете clear java.

Введенный в R2014b