Exponenta Banner

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

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

Примеры

свернуть все

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

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

свернуть все

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

wsdlURL может быть http или https URL-адрес или локальный путь. wsdlURL не может быть file:// URL-АДРЕС. На 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

Документация MATLAB

Поддержка