Main Content

matlab.wsdl.createWSDLClient

创建基于 SOAP 的 Web 服务的接口

说明

matlab.wsdl.createWSDLClient(wsdlURL) 基于 wsdlURL 指定的 Web 服务描述语言 (WSDL) 文档创建一个服务接口。此函数为 WSDL 中的每个简单对象访问协议 (SOAP) 绑定在当前文件夹中创建一个 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(___) 返回所创建的类的句柄。如果创建了多个类,则该函数将返回一个由句柄组成的元胞数组。您可将此语法与上述语法中的任何输入参量一起使用。

要获取有关使用类的信息,请对类名称调用 MATLAB help 函数。

示例

全部折叠

要运行此示例,请安装 WSDL 工具并设置工具路径。jdkcxf 是系统上这些工具的路径。

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

输入参数

全部折叠

WSDL URL 或文件路径,指定为字符串或字符向量,用于定义服务方法、参量和事务。

wsdlURL 可以是 httphttps URL 或本地路径。wsdlURL 不能是 file:// URL。在 Microsoft® Windows® 上,不支持 UNC 路径。

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

用来存放所生成文件的文件夹,指定为字符串或字符向量。如果省略或为空 (''),matlab.wsdl.createWSDLClient 使用当前文件夹。您必须具有文件夹的写权限。此函数使用与生成的文件相同的名称覆盖现有文件。

示例: 'c:\work'

其他选项,指定为访问 WSDL 文档所需的 weboptions 对象,例如 UsernamePasswordTimeout

weboptions 中指定的其他选项不适用于任何其他文档,如其他导入的 WSDL 文档或主 WSDL 文档引用的架构。这些选项也不适用于生成的代码对服务器所做的请求。

示例: 'Username','john','Password','mypassword'

提示

  • 如果在计算机上的多个位置中创建 WSDL 文件,则为避免混淆,可从重复位置删除类文件,然后调用 clear java

版本历史记录

在 R2014b 中推出