Exponenta Banner
exponenta event banner

matlab.wsdl.createWSDLClient

Создание интерфейса для веб-службы на основе SOAP

свернуть все на странице

Синтаксис

matlab.wsdl.createWSDLClient (wsdlURL)
matlab.wsdl.createWSDLClient (wsdlURL, папка)
matlab.wsdl.createWSDLClient (wsdlURL, папка, «тихий»)
matlab.wsdl.createWSDLClient (___, параметры)
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

Поддержка