当前位置:文档之家› Web Service描述语言 WSDL 详解

Web Service描述语言 WSDL 详解

Web Service描述语言 WSDL 详解
Web Service描述语言 WSDL 详解

Web Service描述语言WSDL 详解

为什么使用WSDL?

像Internet协议之类的标准有没有为权威所利用,或者人们这样看待它是因为顺之所获的好处远远超出了代价?曾经有许多试图建立的标准都流产了。有时候,那些还没有普遍使用的标准甚至由法令或政府规定强行推出:Ada语言就是一例。

我相信正是跟随标准所带来的好处使它广泛接受。例如,对于铁路服务来说,真正重要的是,不同公司所铺设的铁路结合到一起,或者是来自好几个公司的产品协调的工作在一起。几家大的企业合力建立了SOAP标准。Web Service描述语言(WSDL)向这种Web Service的提供商和用户推出了方便的协调工作的方法,使我们能更容易的获得SOAP的种种好处。几家公司的铁道并在一起不算什么难事,他们所需遵循的只是两轨间的标准距离。对Web Service来说,这要复杂得多。我们必须先制定出指定接口的标准格式。

曾经有人说SOAP并不真需要什么接口描述语言。如果SOAP是交流纯内容的标准,那就需要一种语言来描述内容。SOAP 消息确实带有某些类型信息,因此SOAP允许动态的决定类型。但不知道一个函数的函数名、参数的个数和各自类型,怎么可能去调用这个函数呢?没有WSDL,我可以从必备文档中确定调用语法,或者检查消息。随便何种方法,都必须有人参与,这个过程可能会有错。而使用了WSDL,我就可以通过这种跨平台和跨语言的方法使Web Service代理的产生自动化。就像COM 和CORBA的IDL文件,WSDL文件由客户和服务器约定。

注意由于WSDL设计成可以绑定除SOAP以外的其他协议,这里我们主要关注WSDL在HTTP上和SOAP的关系。同样,由于SOAP目前主要用来调用远程的过程和函数,WSDL支持SOAP传输的文档规范。WSDL 1.1已经作为记录递交给W3C(见https://www.doczj.com/doc/339023931.html,/TR/wsdl.html)

WSDL文档结构

若要理解XML文档,将之看作块状图表非常有用。下图以XML的文档形式说明了WSDL的结构,它揭示了WSDL文档五个栏之间的关系。

WSDL文档可以分为两部分。顶部分由抽象定义组成,而底部分则由具体描述组成。抽象部分以独立于平台和语言的方式定义SOAP消息,它们并不包含任何随机器或语言而变的元素。这就定义了一系列服务,截然不同的网站都可以实现。随网站而异的东西如序列化便归入底部分,因为它包含具体的定义。

l 抽象定义

Types

独立与机器和语言的类型定义

Messages

包括函数参数(输入与输出分开)或文档描述

PortTypes

引用消息部分中消息定义来描述函数签名(操作名、输入参数、输出参数)

2 具体定义

Bindings

PortTypes部分的每一操作在此绑定实现

Services

确定每一绑定的端口地址

下面的图中,箭头连接符代表文档不同栏之间的关系。点和箭头代表了引用或使用关系。双箭头代表"修改"关系。3-D的箭头代表了包含关系。这样,各Messages栏使用Types栏的定义,PortTypes栏使用Messages栏的定义;Bindings栏引用了PortTypes栏,Services栏引用Bindings栏,PortTypes和Bindings栏包含了operation元素,而Services栏包含了port元素。PortTypes 栏里的operation元素由Bindings栏里的operation元素进一步修改或描述。

在此背景中,我将使用标准的XML术语来描述WSDL文档。Element是指XML的元素,而"attribute"指元素的属性。于是:

<element attribute="attribute-value">contents</element>

内容也可能由一个或多个元素以递归的方式组成。根元素是所有元素之中最高级的元素。子元素总是从属于另一个元素,父元素。

注意,文档之中可能只有一个Types栏,或根本没有。所有其他的栏可以只有零元素、单元素或是多元素。WSDL的列表要求所有的栏以固定的顺序出现:import, types, message, portType, binding, service。所有的抽象可以是单独存在于别的文件中,也可以从主文档中导入。

图一:抽象定义和具体定义

targetNamespace="https://www.doczj.com/doc/339023931.html,/wsdl/"

xmlns:wsdlns="https://www.doczj.com/doc/339023931.html,/wsdl/"

xmlns:typens="https://www.doczj.com/doc/339023931.html,/xsd"

xmlns:xsd="https://www.doczj.com/doc/339023931.html,/2001/XMLSchema"

xmlns:soap="https://www.doczj.com/doc/339023931.html,/wsdl/soap/"

xmlns:stk="https://www.doczj.com/doc/339023931.html,/soap-toolkit/wsdl-extension"

xmlns="https://www.doczj.com/doc/339023931.html,/wsdl/">

<types>

<schema targetNamespace="https://www.doczj.com/doc/339023931.html,/xsd"

xmlns="https://www.doczj.com/doc/339023931.html,/2001/XMLSchema"

xmlns:SOAP-ENC="https://www.doczj.com/doc/339023931.html,/soap/encoding/"

xmlns:wsdl="https://www.doczj.com/doc/339023931.html,/wsdl/"

elementFormDefault="qualified" >

</schema>

</types>

<message name="Simple.foo">

<part name="arg" type="xsd:int"/>

</message>

<message name="Simple.fooResponse">

<part name="result" type="xsd:int"/>

</message>

<portType name="SimplePortType">

<operation name="foo" parameterOrder="arg" >

<input message="wsdlns:Simple.foo"/>

<output message="wsdlns:Simple.fooResponse"/>

</operation>

</portType>

<binding name="SimpleBinding" type="wsdlns:SimplePortType">

<stk:binding preferredEncoding="UTF-8" />

<soap:binding style="rpc"

transport="https://www.doczj.com/doc/339023931.html,/soap/http"/>

<operation name="foo">

<soap:operation soapAction="https://www.doczj.com/doc/339023931.html,/action/Simple.foo"/>

<input>

<soap:body use="encoded" namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle="https://www.doczj.com/doc/339023931.html,/soap/encoding/" />

</input>

<output>

<soap:body use="encoded" namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle="https://www.doczj.com/doc/339023931.html,/soap/encoding/" />

</output>

</operation>

</binding>

<service name="FOOSAMPLEService">

<port name="SimplePort" binding="wsdlns:SimpleBinding"><soap:address location="http://carlos:8080/FooSample/FooSample.asp"/>

</port>

</service>

</definitions>

以下是该实例文档的总述:稍后我将详细讨论每一部分的细节。

第一行申明该文档是XML。尽管这并不是必需的,但它有助于XML解析器决定是否解析WSDL文件或只是报错。第二行是WSDL文档的根元素:<definitions>。一些属性附属于根元素,就像<schema>子元素对于<types>元素。

<types>元素包含了Types栏。如果没有需要声明的数据类型,这栏可以缺省。在WSDL范例中,没有应用程序特定的types声明,但我仍然使用了Types栏,只是为了声明schema namespaces。

<message>元素包含了Messages栏。如果我们把操作看作函数,<message>元素定义了那个函数的参数。<message>元素中的每个<part>子元素都和某个参数相符。输入参数在<message>元素中定义,与输出参数相隔离--输出参数有自己的<message>元素。兼作输入、输出的参数在输入输出的<message>元素中有它们相应的<part>元素。输出<message>元素以"Response"结尾,就像以前所用的"fooResponse"。每个<part>元素都有名字和类型属性,就像函数的参数有参数名和参数类型。

用于交换文档时,WSDL允许使用<message>元素来描述交换的文档。

<part>元素的类型可以是XSD基类型,也可以是SOAP定义类型(soapenc)、WSDL定义类型(wsdl)或是Types 栏定义的类型。

一个PortTypes栏中,可以有零个、单个或多个<portType>元素。由于抽象PortType定义可以放置在分开的文件中,在某个WSDL文件中没有<portType>元素是可能的。上面的例子里只是用了一个<portType>元素。而一个<po rtType>元素可在<operation>元素中定义一个或是多个操作。示例仅使用了一个名为"foo"的<operation>元素。这和某个函数名相同。<operation>元素可以有一个、两个、三个子元素:<input>, <output>和<fault>元素。每个<input>和<output>元素中的消息都引用Message栏中的相关的<message>元素。这样,示例中的整个<port Type>元素就和以下的C函数等效:

int foo(int arg);

这个例子足见XML和C相比要冗长的多。(包括<message>元素,XML在示例中共使用了12行代码来表达相同的单行函数声明。)

Bindings栏可以有零个、一个或者多个<binding>元素。它的意图是制定每个<operation>通过网络调用和回应。

Services栏同样可以有零个、一个、多个<service>元素。它还包含了<port>元素,每个<port>元素引用一个Bind ings栏里的<binding>元素。Bindings和Services栏都包含WSDL文档。

Namespace

<definitions>和子节点<schema>都是namespace属性:

<definitions name="FooSample"

targetNamespace="https://www.doczj.com/doc/339023931.html,/wsdl/"

xmlns:wsdlns="https://www.doczj.com/doc/339023931.html,/wsdl/"

xmlns:typens="https://www.doczj.com/doc/339023931.html,/xsd"

xmlns:xsd="https://www.doczj.com/doc/339023931.html,/2001/XMLSchema"

xmlns:soap="https://www.doczj.com/doc/339023931.html,/wsdl/soap/"

xmlns:stk="https://www.doczj.com/doc/339023931.html,/soap-toolkit/wsdl-extension"

xmlns="https://www.doczj.com/doc/339023931.html,/wsdl/">

<types>

<schema targetNamespace="https://www.doczj.com/doc/339023931.html,/xsd"

xmlns="https://www.doczj.com/doc/339023931.html,/2001/XMLSchema"

xmlns:SOAP-ENC="https://www.doczj.com/doc/339023931.html,/soap/encoding/"

xmlns:wsdl="https://www.doczj.com/doc/339023931.html,/wsdl/"

elementFormDefault="qualified" >

</schema>

</types>

每个namespace属性都声明了一个缩略语,用在文档中。例如"xmlns:xsd"就为https://www.doczj.com/doc/339023931.html,/2001/XMLSchema定义了一个缩略语(xsd)。这就允许对该namespace的引用只需简单的在名字前加上前缀就可以了,如:"xsd:int"中的"xsd"就是合法的类型名。普通范围规则可运用于缩略前缀。也就是说,前缀所定义的元素只在元素中有效。

Namespace派什么用?namespace的作用是要避免命名冲突。如果我建立一项Web Service,其中的WSDL文件包含一个名为"foo"的元素,而你想要使用我的服务与另一项服务连接作为补充,这样的话另一项服务的WSDL文件就不能包含名为"foo"的元素。两个服务器程序只有在它们在两个事例中表示完全相同的东西时,才可以取相同的名字。如果有了表示区别的namespace,我的网络服务里的"foo"就可以表示完全不同于另一个网络服务里"foo"的含义。在你的客户端里,你只要加以限制就可以引用我的"foo"。

见下例:https://www.doczj.com/doc/339023931.html,/fooService#foo 就是完全限制的名字,相当于"carlos:foo",如果我声明了carlos作为https://www.doczj.com/doc/339023931.html,/fooService的快捷方式。请注意namespace中的URL是用来确定它们的唯一性的,同时也便于定位。URL所指向的地方不必是实际存在的网络地址,也可以使用GUID来代替或补充URL。例如,GUID"335DB901-D44A-11D4-A96E-0080AD76435D"就是一个合法的namespace指派。

targetNamespace属性声明了一个namespace,元素中所有的声明的名字都列于其内。在WSDL示例中,<definitions>的

targetNamespace 是https://www.doczj.com/doc/339023931.html,/wsdl。这意味着所有在WSDL文档中声明的名字都属于这个namespace。<schema>元素有自己的targetNamespace属性,其值为https://www.doczj.com/doc/339023931.html,/xsd ,在<schma>元素中定义的所有名字都属于这个namespace而不是main的target namespace。

<schema>元素的以下这行声明了默认的namespace。Schema中所有有效的名字都属于这个namespace。

xmlns=https://www.doczj.com/doc/339023931.html,/2001/XMLSchema

SOAP消息

对于使用WSDL的客户机和服务机来说,研究WSDL文件的一种方法就是决定什么来接受所发送的信息。尽管SOAP使用底层协议,如IP和HTTP等,但应用程序决定了服务器与客户机之间交互的高级协议。也就是说,进行一项操作,比如"echoint"把输入的整数送回,参数的数目、每个参数的类型、以及参数如何传送等因素决定了应用程序特定的协议。有很多方法可以确定此类协议,但我相信最好的方法就是使用WSDL。如果我们用这种视角来看待它,WSDL不只是一种接口协议,而且是一种协议特定的语言。它就是我们超越"固定"协议(IP、HTTP等)所需要的应用程序特定协议。

WSDL可以确定SOAP消息是否遵从RPC或文档风格。RPC风格的消息(就是示例中所用的)看起来像是函数调用。而文档风格的消息则更普通,嵌套层次更小。下面的XML消息就是示例WSDL文件解析后的发送/接受效果,解析使用的是MS SOAP Toolkit 2.0(MSTK2)中的SoapClient对象。

从客户端调用"foo(5131953)"函数:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<SOAP-ENV:Envelope

SOAP-ENV:encodingStyle="https://www.doczj.com/doc/339023931.html,/soap/encoding/"

xmlns:SOAP-ENV="https://www.doczj.com/doc/339023931.html,/soap/envelope/">

<SOAP-ENV:Body>

<m:foo xmlns:m="https://www.doczj.com/doc/339023931.html,/message/">

<arg>5131953</arg>

</m:foo>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

从服务器接受的信息:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<SOAP-ENV:Envelope

SOAP-ENV:encodingStyle="https://www.doczj.com/doc/339023931.html,/soap/encoding/"

xmlns:SOAP-ENV="https://www.doczj.com/doc/339023931.html,/soap/envelope/">

<SOAP-ENV:Body>

<SOAPSDK1:fooResponse xmlns:SOAPSDK1="https://www.doczj.com/doc/339023931.html,/message/">

<result>5131953</result>

</SOAPSDK1:fooResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

两函数都调用了消息,其回应是有效的XML。SOAP消息由几部分组成,首先是<Envelop>元素,包含一个可选的<Header >元素以及至少一个<body>元素。Rpc函数所调用的消息体有一个根据操作"foo"命名的元素,而回应信息体有一个"fooResponse"元素。Foo元素有一个部分<arg>,就和WSDL中描述的一样,是单参数的。fooResponse也相应的有一个<result >的部分。注意encodingStyle、envelope和message的namespace和WSDL Bindings栏中的预定义的一致,重复如下:

<binding name="SimpleBinding" type="wsdlns:SimplePortType">

<stk:binding preferredEncoding="UTF-8" />

<soap:binding style="rpc"

transport="https://www.doczj.com/doc/339023931.html,/soap/http"/>

<operation name="foo">

<soap:operation

soapAction="https://www.doczj.com/doc/339023931.html,/action/Simple.foo"/>

<input>

<soap:body use="encoded"

namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle=

"https://www.doczj.com/doc/339023931.html,/soap/encoding/" />

</input>

<output>

<soap:body use="encoded"

namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle=

"https://www.doczj.com/doc/339023931.html,/soap/encoding/" />

</output>

</operation>

</binding>

WSDL的Types栏和Messages栏中的XML Schema

WSDL数据类型是基于"XML Schema: Datatypes"(XSD)的,现在已经被W3C推荐。这一文档共有三个版本(1999,2000/10,2001),因此必须在namespace属性的<definitions>元素中指明所使用的是哪一个版本。

xmlns:xsd="https://www.doczj.com/doc/339023931.html,/2001/XMLSchema"

在本文中,我将只考虑2001版本。WSDL标准的推荐者强烈建议使用2001版。

在本栏和以后各部分,需使用以下简缩或前缀

XSD基类型

下表是直接从MSTK2文档中取出的,列举了MSTK2所支持的所有XSD基类型。它也告诉在客户端或服务器端的WSDL 读取程序如何把XSD类型映射到在VB、C++和IDL中相应的类型。

XSD定义了两套内建的数据类型:原始的和派生的。在下文中查阅内建数据类型的层次十分有益:

数组

XSD提供<list>结构来声明一个数组,元素之间有空格界定。不过SOAP不是使用XSD来编码数组的,它定义了自己的数组类型--"SOAP-ENC: Array"。下列的例子揭示了从这一类型派生出一位整数数组的方法:

<xsd:complexType name="ArrayOfInt">

<xsd:complexContent>

<xsd:restriction base="soapenc:Array">

<attribute ref="soapenc:arrayType" wsdl:arrayType="xsd:int[]"/>

</xsd:restriction>

</xsd:complexContent>

</xsd:complexType>

新的complex类型从soapenc:array限制派生。然后又声明了complex类型的一个属性。引用"soapenc:arrayType"实际上是这样完成的:

<xsd:attribute name="arrayType" type="xsd:string"/>

wsdl:arrayType属性值决定了数组每个成员的类型。数组的成员也可以是Complex类型。:

<xsd:complexType name="ArrayOfPERSON">

<xsd:complexContent>

<xsd:restriction base="soapenc:Array">

<attribute ref="soapenc:arrayType"

wsdl:arrayType="typens:PERSON[]"/>

</xsd:restriction>

</xsd:complexContent>

</xsd:complexType>

WSDL要求数组的类型由"ArrayOf"和每个数组元素的类型串联而成。很显然,顾名思义,"ArrayOfPERSON"是PERSON 结构的数组。下面我将使用ArrayOfPERSON来声明一个<message>,并加入不止一个PERSON:

<?xml version="1.0" encoding="UTF-8" ?>

<definitions …>

<types>

<schema targetNamespace="someNamespace"

xmlns:typens="someNamespace" >

<xsd:complexType name="PERSON">

<xsd:sequence>

<xsd:element name="firstName" type="xsd:string"/>

<xsd:element name="lastName" type="xsd:string"/>

<xsd:element name="ageInYears" type="xsd:int"/>

<xsd:element name="weightInLbs" type="xsd:float"/>

<xsd:element name="heightInInches" type="xsd:float"/>

</xsd:sequence>

</xsd:complexType>

<xsd:complexType name="ArrayOfPERSON">

<xsd:complexContent>

<xsd:restriction base="soapenc:Array">

<attribute ref="soapenc:arrayType"

wsdl:arrayType="typens:PERSON[]"/>

</xsd:restriction>

</xsd:complexContent>

</xsd:complexType>

</schema>

</types>

<message name="addPersons">

<part name="person" type="typens:ArrayOfPERSON"/>

</message>

<message name="addPersonResponse">

<part name="result" type="xsd:int"/>

</message>

</definitions>

<portType>和<operation>元素

PortType定义了一些抽象的操作。PortType中的operation元素定义了调用PortType中所有方法的语法,每一个operation 元素声明了方法的名称、参数(使用<message>元素)和各自的类型(<part>元素要在所有<message>中声明)。

在一篇WSDL文档中可以有几个<PortType>元素,每一个都和一些相关操作放在一起,就和COM和一组操作的接口相似。

在<operation>元素中,可能会有至多一个<input>元素,一个<output>元素,以及一个<fault>元素。三个元素各有一个名字和一个消息属性。

<input>, <output>, <fault>元素属性的名字有何含义呢?它们可以用来区别两个同名操作(重载)。例如,看下面两个C函数:

void foo(int arg);

void foo(string arg);

这种重载在WSDL中可以这样表示:

<?xml version="1.0" encoding="UTF-8" ?>

<definitions name="fooDescription"

targetNamespace="https://www.doczj.com/doc/339023931.html,/wsdl/"

xmlns:wsdlns="https://www.doczj.com/doc/339023931.html,/wsdl/"

xmlns:typens="https://www.doczj.com/doc/339023931.html,/xsd"

xmlns:xsd="https://www.doczj.com/doc/339023931.html,/2001/XMLSchema"

xmlns:soap="https://www.doczj.com/doc/339023931.html,/wsdl/soap/"

xmlns:stk="https://www.doczj.com/doc/339023931.html,/soap-toolkit/wsdl- extension"

xmlns="https://www.doczj.com/doc/339023931.html,/wsdl/">

<types>

<schema targetNamespace="https://www.doczj.com/doc/339023931.html,/xsd"

xmlns="https://www.doczj.com/doc/339023931.html,/2001/XMLSchema"

xmlns:SOAP-ENC="https://www.doczj.com/doc/339023931.html,/soap/encoding/" xmlns:wsdl="https://www.doczj.com/doc/339023931.html,/wsdl/" elementFormDefault="qualified" >

</schema>

</types>

<message name="foo1">

<part name="arg" type="xsd:int"/>

</message>

<message name="foo2">

<part name="arg" type="xsd:string"/>

</message>

<portType name="fooSamplePortType">

<operation name="foo" parameterOrder="arg " >

<input name="foo1" message="wsdlns:foo1"/>

</operation>

<operation name="foo" parameterOrder="arg " >

<input name="foo2" message="wsdlns:foo2"/>

</operation>

</portType>

<binding name="fooSampleBinding" type="wsdlns:fooSamplePortType"><stk:binding preferredEncoding="UTF-8" />

<soap:binding style="rpc"

transport="https://www.doczj.com/doc/339023931.html,/soap/http"/>

<operation name="foo">

<soap:operation soapAction="https://www.doczj.com/doc/339023931.html,/action/foo1"/>

<input name="foo1">

<soap:body use="encoded" namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle="https://www.doczj.com/doc/339023931.html,/soap/encoding/" />

</input>

</operation>

<operation name="foo">

<soap:operation soapAction="https://www.doczj.com/doc/339023931.html,/action/foo2"/>

<input name="foo2">

<soap:body use="encoded"

namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle="https://www.doczj.com/doc/339023931.html,/soap/encoding/"

/>

</input>

</operation>

</binding>

<service name="FOOService">

<port name="fooSamplePort" binding="fooSampleBinding">

<soap:address

location="http://carlos:8080/fooService/foo.asp"/>

</port>

</service>

</definitions>

到目前为止,还没有一种SOAP的实现支持重载。这对基于JA V A的客户端十分重要,因为JA V A服务器使用的接口用到JA V A的重载特性。而对基于COM的客户端,就不那么重要,因为COM是不支持重载的。

<binding>和<operation>元素

Binding栏是完整描述协议、序列化和编码的地方,Types, Messages和PortType栏处理抽象的数据内容,而Binding栏是处理数据传输的物理实现。Binding栏把前三部分的抽象定义具体化。

把相关的数据制定和消息声明分开,这意味着同一类型服务的提供者可以把一系列的操作标准化。每个提供者可以提供定制的binding来互相区分。WSDL也有一个重要的结构,使抽象定义可以放在分离的文件中,而不是和Bindings和Services在一起,这样可在不同的服务提供者之间提供标准化的抽象定义,这很有帮助。例如,银行可以用WSDL文档来标准化一些银行的操作。每个银行仍然可以自由的订制下层的协议、串行优化,及编码。

下面是重载的WSDL示例的Binding栏,重复在此以便讨论:

<binding name="fooSampleBinding" type="wsdlns:fooSamplePortType">

<stk:binding preferredEncoding="UTF-8" />

<soap:binding style="rpc"

transport="https://www.doczj.com/doc/339023931.html,/soap/http"/>

<operation name="foo">

<soap:operation soapAction="https://www.doczj.com/doc/339023931.html,/action/foo1"/>

<input name="foo1">

<soap:body use="encoded" namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle=

"https://www.doczj.com/doc/339023931.html,/soap/encoding/" />

</input>

</operation>

<operation name="foo">

<soap:operation soapAction="https://www.doczj.com/doc/339023931.html,/action/foo2"/>

<input name="foo2">

<soap:body use="encoded"

namespace="https://www.doczj.com/doc/339023931.html,/message/"

encodingStyle=

"https://www.doczj.com/doc/339023931.html,/soap/encoding/" />

</input>

</operation>

</binding>

<binding>元素已经取了一个名字(本例中"fooSampleBinding"),这样就可以被Services栏的<port>元素引用了。它有一个"type"的属性引用<portType>,本例中就是"wsdlns:fooSamplePortType"。第二行是MSTK2的扩展元素<stk:binding>,它指定了preferredEncoding属性为"UTF-8"。

<soap:binding>元素指定了所使用的风格("rpc")和传输方式。Transport属性应用了一个namespace,正是这个namespace 指明使用HTTP SOAP协议。

有两个同以"foo"命名的<operation>元素。唯一不同的是它们各自的<input>名字,分别为"foo1"和"foo2"。两个<operation >元素中的<soap:operation>元素有同样的"soapAction"属性,是URI。soapAction属性是SOAP特定的URI,它只是简单的使用于SOAP消息。所产生的SOAP消息有一个SOAPAction头,而URI也仅在<soap:operation>元素里才起作用。soapAction 属性在HTTP的binding中是必需的,但在其他非HTTP binding中却不要提供。目前它的使用并不清楚,但它似乎有助于本例中的两个"foo"操作。SOAP 1.1指明soapAction用来确定消息的"意图"。似乎服务器可以在不解析整个消息的情况下就能使用这一属性来发送消息。实际上,它的使用多种多样。<soap:operation>元素也可以包含另一属性,即"style"属性,在有必要冲突<soap:binding>元素指定的风格时可以使用。

<operation>属性可以包含<input>, <output>和<fault>的元素,它们都对应于PortType栏中的相同元素。只有<input >元素在上例中提供。这三个元素中的每一个可有一个可选的"name"属性,在本例中,我们用这种方法来区分同名操作。在本例的<input>元素中有一个<soap:body>元素,它指定了哪些信息被写进SOAP消息的信息体中。该元素有以下属性:

Use

用于制定数据是"encoded"还是"literal"。"Literal"指结果SOAP消息包含以抽象定义(Types, Messages, 和PortTypes)指定格式存在的数据。"Encoded"指"encodingStyle"属性决定了编码方式。

Namespace

每个SOAP消息体可以有其自己的namespace来防止命名冲突。这一属性制定的URI在结果SOAP消息中逐字使用。

EncodingStyle

对SOAP编码,它应该有以下URI值:

"https://www.doczj.com/doc/339023931.html,/soap/encoding"

文档风格实现

在前几栏中,<soap:binding>元素有一个类型属性,设为"rpc"。此属性设为"document"时会改变传输时消息的串行化。不同于函数签名,现在的消息是文档传输的。在这类binding中,<message>元素定义文档格式,而不是函数签名。作为例子,考虑以下WSDL片段:

<definitions

xmlns:stns="(SchemaTNS)"

xmlns:wtns="(WsdlTNS)"

targetNamespace="(WsdlTNS)">

<schema targetNamespace="(SchemaTNS)"

elementFormDefault="qualified">

<element name="SimpleElement" type="xsd:int"/>

<element name="CompositElement" type="stns:CompositeType"/>

<complexType name="CompositeType">

<all>

<element name='a' type="xsd:int"/>

<element name='b' type="xsd:string"/>

</all>

</complexType>

</schema>

<message...>

<part name='p1' type="stns:CompositeType"/>

<part name='p2' type="xsd:int"/>

<part name='p3' element="stns:SimpleElement"/>

<part name='p4' element="stns:CompositeElement"/>

</message>

</definitions>

schema有两个元素:SimpleElement和CompositeElement,还有一个类型声明(CompositeType)。唯一声明的<message>元素有四个部分:p1:Composite型;p2:int型;p3:SimpleElement型;p4:CompositeElement型。以下有一个表,对四种类型的use/type决定的binding作一比较:rpc/literal, document/literal, rpc/encoded, 以及document/encoded。表指明了每种binding 的表现。

<service>和<port>元素

service是一套<port>元素。在一一对应形式下,每个<port>元素都和一个location关联。如果同一个<binding>有多个<port>元素与之关联,可以使用额外的URL地址作为替换。

一个WSDL文档中可以有多个<service>元素,而且多个<service>元素十分有用,其中之一就是可以根据目标URL来组织端口。这样,我就可以方便的使用另一个<service>来重定向我的股市查询申请。我的客户端程序仍然工作,因为这种根据协议归类的服务不随服务而变化。多个<service>元素的另一个作用是根据特定的协议划分端口。例如,我可以把所有的HTTP 端口放在同一个<service>中,所有的SMTP端口放在另一个<service>里。我的客户可以搜索与它可以处理的协议相匹配的<service>。

<service name="FOOService">

<port name="fooSamplePort" binding="fooSampleBinding">

<soap:address

location="http://carlos:8080/fooService/foo.asp"/>

</port>

</service>

在一个WSDL文档中,<service>的name属性用来区分不同的service。因为同一个service中可以有多个端口,它们也有"name"属性。

总结

本文中我描述了WSDL文档关于SOAP方面的最显著的特点。不过应该说明的是WSDL并不仅限于HTTP上的SOAP。WSDL用来描述HTTP-POST、HTTP-GET、SMTP及其他协议时非常清晰。使用了WSDL,SOAP更加容易处理了,无论是开发者还是使用者。我相信WSDL和SOAP一起将会开创网络应用程序世界的新时代。

WSDL的namespace里有一系列的XML元素。下表概述了那些元素、它们的属性和内容。

本文来自CSDN博客,转载请标明出处:https://www.doczj.com/doc/339023931.html,/abedon/archive/2002/08/22/3920.aspx 资源:

1. WSDL 1.1

2. SOAP 1.1

3. XML Schema Primer

4. MS SOAP Toolkit Download Site

5. A tool for translating IDL to WSDL

6. Free Web Services resources including a WSDL to VB proxy generator

7. PocketSOAP: SOAP related components, tools & source code

本文来自CSDN博客,转载请标明出处:https://www.doczj.com/doc/339023931.html,/abedon/archive/2002/08/22/3920.aspx

SAP开发webservice接口教程

SAP开发webservice接口教程 在client=100中进行开发: 1.创建RFC函数 SE80,在函数组下,右击->创建,创建函数模块,填写函数模块名称及描述。 2.函数属性标签页,选择“远程启用的模块”,其余默认不变。 3.函数导入标签页,需要添加调用时传入的参数(表),“传递值”需勾选。 表类型:ZSHR_EMPLOYEER_T (需要自己创建) 行类型:ZSHR_EMPLOYEER (需要自己创建)

4.函数导出标签页,需要添加调用返回的参数(表),“传递值”需勾选。 表类型:ZSHR_EMPLOYEER_OUT_T (需要自己创建) 行类型:ZSHR_EMPLOYEER_OUT (需要自己创建) 5.函数源代码标签页,需要写代码实现把传入的数据保存在透明表中。 至此,函数创建完成。 6.创建Web Services 右击包名创建企业服务,进入如下页面,选择“Service Provider”,因为我们是服务提供者,点击“继续”。

7.选择“Existing ABAP Object (Inside Out)”,点击“继续”。 8.给服务起名,并填写描述,点击“继续”

9.选择“Function Module”,点击“继续”。 10.填写我们第一步创建的函数,并勾选“Map Name”,点击“继续”。 11.SOAP Appl默认不变,Profie下拉框选择第四个选择,即不进行权限认证。点击“继续”。 12.填写对于的包和请求,点击“继续”。 下一步,直接点击“完成”。服务创建成功。

13.配置SOA 使用T-CODE:soamanager,进入web页面的SOA管理(client=100)。 14.点击“简化Web服务配置”,进入如下设置页面,点击“执行”,从列表中找到自己创建的 服务,勾选第一个checkbox,User Name/Password(basic),点击列表左上角的“保存”,之后页面右上角的“返回”按钮,返回首页。 这一步设置,代表我们只设置用户名/密码的调用认证方式。

EBS中发布WEBSERVICE接口的方法

在Oracle EBS二次开发中,PL/SQL程序是开发人员使用频率最高的开发语言,同时也是大家最容易掌握的工具之一了,而我们也很希望将自己编写的PL/SQL 程序发布为Web服务来提供给客户端程序使用,同时也可以实现和外围系统的集成,有了irep_parser这个工具,我们就可以将自己编写的PL/SQL 程序发布到Oracle Integration Repositoy中。Oracle Integration Repositoy中集成接口的来源都是Oracle,客户化的程序发布上去的为Custom: 下面描述如何将PL/SQL程序接口发布到Oracle Integration Repositoy中作为集成接口供第三方程序集成调用 一、给EBS系统打补丁 参考如下安装文档: 安装文档.docx 二、添加客户化应用到Product Family 客户化应用设置好之后,它没有归属于任何的产品家族,如我的客户化应用CUX,因此发布在客户化应用下的集成接口在Oracle Integration Repositoy中无法方便的查看,如下图:

如果客户化集成接口是组织到自己的应用下就需要先注册一个产品家族,下面将CUX Developer(CUX) 应用注册到CUX Developer(cux_pf)这个产品家族下作为例子进行演示: 1,添加产品家族 CUX Developer(cux_pf) --添加产品家族 begin -- Call the procedure ad_pa_insert_package.insert_ad_pm_product_info(x_product_abbreviation => 'cux_pf', x_pseudo_product_flag => 'N', x_product_family_flag => 'Y', x_application_short_name => NULL, x_product_name => 'CUX Developer', x_product_family_abbreviation => NULL, x_product_family_name => NULL, x_aru_update_date => to_char(SYSDATE,'YYYY-MM-DD HH24:MI:SS'), x_currdate => to_char(SYSDATE,'YYYY-MM-DD HH24:MI:SS'), x_last_updated_by => -1, x_created_by => -1); COMMIT; end; 2,注册CUX Developer(CUX)应用到产品家族中

webservice注解详解

webservice注解详解

javax.jws.WebService 当实现Web Service 时,@WebService 注释标记Java 类;实现Web Service 接口时,标记服务端点接口(SEI)。 要点: ? 实现Web Service 的Java 类必须指定@WebService 或@WebServiceProvider 注释。不能同时提供这两种注释。 此注释适用于客户机/服务器SEI 或JavaBeans 端点的服务器端点实现类。 ? 如果注释通过endpointInterface属性引用了某个SEI,那么还必须使用@WebService 注释来注释该SEI。 ? 请参阅适用于使用@WebService 注释的类的方法的规则,以了解更多信息 ?注释目标:类型 ?属性: - name wsdl:portType的名称。缺省值为Java 类或接口的非限定名称。(字符串)- targetNamespace 指定从Web Service 生成的WSDL 和XML 元素的XML 名称空间。缺省值为从包含该Web Service 的包名映射的名称空间。(字符串) - serviceName 指定Web Service 的服务名称:wsdl:service。缺省值为Java 类的简单名称 + Service。(字符串) - endpointInterface 指定用于定义服务的抽象Web Service 约定的服务端点接口的限定名。如果指定了此限定名,那么会使用该服务端点接口来确定抽象WSDL 约定。(字符串)- portName wsdl:portName。缺省值为https://www.doczj.com/doc/339023931.html,+Port。(字符串)

【WebService】接口的测试方法

【WebService】接口的测试方法 有以下多种方式: 一、通过WSCaller.jar工具进行测试: 前提:知道wsdl的url。 wsCaller可执行程序的发布方式为一个wsCaller.jar包,不包含Java运行环境。你可以把wsCaller.jar复制到任何安装了Java运行环境(要求安装JRE/JDK 1.3.1或更高版本)的计算机中,用以下命令运行wsCaller: java -jar wsCaller.jar 使用wsCaller软件的方法非常简单,下面是wsCaller的主界面: 首先在WSDL Location输入框中输入你想调用或想测试的Web Service的WSDL位置,如“https://www.doczj.com/doc/339023931.html,/axis/services/StockQuoteService?wsdl”,然后点“Find”按钮。wsCaller就会检查你输入的URL地址,并获取Web Service的WSDL信息。如果信息获取成功,wsCaller会在Service和Operation下拉列表框中列出该位置提供的Web Service服务和服务中的所有可调用的方法。你可以在列表框中选择你要调用或测试的方法名称,选定后,wsCaller窗口中间的参数列表框就会列出该方法的所有参数,包括每个参数的名

称、类型和参数值的输入框(只对[IN]或[IN, OUT]型的参数提供输入框)。你可以输入每个参数的取值。如下图: 这时,如果你想调用该方法并查看其结果的话,只要点下面的“Invoke”按钮就可以了。如果你想测试该方法的执行时间,则可以在“Invoke Times”框中指定重复调用的次数,然后再按“Invoke”按钮。wsCaller会自动调用你指定的方法,如果调用成功,wsCaller会显示结果对话框,其中包括调用该方法所花的总时间,每次调用的平均时间和该方法的返回值(包括返回值和所有输出型的参数)。如下图:

webservice注解详解

javax.jws.WebService 当实现Web Service 时,@WebService注释标记Java 类;实现Web Service 接口时,标记服务端点接口(SEI)。 要点: ? 实现Web Service 的Java 类必须指定@WebService 或@WebServiceProvider 注释。 不能同时提供这两种注释。 此注释适用于客户机/服务器SEI 或JavaBeans 端点的服务器端点实现类。 ? 如果注释通过endpointInterface属性引用了某个SEI,那么还必须使用@WebService 注释来注释该SEI。 ? 请参阅适用于使用@WebService 注释的类的方法的规则,以了解更多信息 ?注释目标:类型 ?属性: - name wsdl:portType的名称。缺省值为Java 类或接口的非限定名称。(字符串)- targetNamespace 指定从Web Service 生成的WSDL 和XML 元素的XML 名称空间。缺省值为从包 含该Web Service 的包名映射的名称空间。(字符串) - serviceName 指定Web Service 的服务名称:wsdl:service。缺省值为Java 类的简单名称 + Service。(字符串) - endpointInterface 指定用于定义服务的抽象Web Service 约定的服务端点接口的限定名。如果指定了此 限定名,那么会使用该服务端点接口来确定抽象WSDL 约定。(字符串) - portName wsdl:portName。缺省值为https://www.doczj.com/doc/339023931.html,+Port。(字符串)

Webservice接口开发

Webservice接口开发 Author:Geloin

目录 1 准备工作 (1) 2 服务器端 (1) 2.1 主程序 (1) 2.2 services.xml (2) 2.3 传值方式 (3) 2.4 打包 (4) 2.5 发布 (6) 3 客户端 (8) 3.1 导入包 (8) 3.2 示例代码 (8) 3.3 代码解析 (10) 3.3.1 设定服务器地址 (10) 3.3.2 设定action (10) 3.3.3 设定要调用的方法名 (11) 3.3.4 设定客户端控件 (11) 3.3.5 设定命名空间 (11) 3.3.6 设定需要传送的值 (11) 3.3.7 设定返回数据类型 (11) 3.3.8 获取返回结果 (12)

1准备工作 至https://www.doczj.com/doc/339023931.html,/axis2/下载axis2的bin及war包,分别解压之,在环境变量中添加AXIS2_HOM,将axis2.war放置到tomcat/webapps目录下,启动tomcat,用浏览器打开http://localhost:8080/axis2,如下图所示: 2服务器端 2.1主程序 服务器端可以是任何一个程序,例如下面的例子: public class Test { // 此程序返回一个字符串 public String test1(String arg) { return arg + “测试”; } // 此程序返回一个一维数组 public String[] test2(String arg) { String[] result = new String[]{arg}; return result;

Eclipse下WebService学习

Eclipse下WebService学习 文档作者:weichaoduo 日期:2006.7.7

1.准备工作 收集相关资料,下载并安装必备的工具。由于以前对WebService学习不是很重视,因此对WebService还不是很熟悉,不过我还是对它有些印象的,因为以前我曾经使用Delphi 和https://www.doczj.com/doc/339023931.html,做过相关的例子。阅读几遍的相关资料后对有些抽象的概念还是有些模糊,但总体上认清了WebService的本质或者是用途吧。WebService其实就是向外部(跨语言甚至平台)公开一些函数方法等等内容,使外部能访问到所要发布的“服务”。几经周折终于完成了WebSerrvice环境的配置工作。 相关资料有: ●《Tomcat5.0.28下AXIS完全安装手册》 ●《详解怎样使用Axis开发Web Service的实例.》 ●《SOAP 是如何工作的》 ●《SOAP的协议规范》 ●《SOAP净化有线协议》 ●〈Web Services技術介紹〉 相关工具: ●Sun java JDK1.5 ●Apache Tomcat5.0/5.5 ●SUN JWSDP开发包 ●Axis开发包 ●Eeclipse集成开发环境 ●Eclipse插件—Workshop Studio ●Netbeans5.0 安装环境步骤省略。(其实直接下载JDK5。0+Tomcat5.0(最好是SUN公司的jwsdp-1_4-windows-i586.exe) + Workshop Studio就可以了)

2.初探Java中的WebService 首先按着资料上的例子做,利用JWS方法,建立一个温度转换的Java函数,然后发布出来,并最终调用它。步骤如下: (1)打开Eclipse配置好相关的环境,新建立一个”动态Web应用程序”—>新建立一个类 在该类中写入温度转换函数。如下列图: 图2.1 建立新的”动态Web应用程序“

webservice四种发布方式及客户端调用

WebService 四种发布方式总结 Author:yczhang 1.CXF方式 CXF与spring搭建webservice是目前最流行的方式,但是传闻cxf与jdk1.5有些不兼容,我没有遇到过,我遇到的问题是cxf与was6.1.1不兼容,表现在cxf必须的jar包“wsdl4j-1.6.2.jar”报错,报的错为:https://www.doczj.com/doc/339023931.html,ng.IncompatibleClassChangeError,明显的jar包不兼容问题,很是头痛,后来查找资料找到解决办法是,将上述jar包新建一个was共享库,可以解决,但是客户周经理不想用此种方式,因为需要修改was,于是改用了axis2方式,下文会介绍。该问题在此处做个记录,以后使用cxf与was的时候需要注意!!! 使用cxf+spring搭建WebService: 第一步,添加jar包。此处需要注意,不同环境(tomcat、was)jar也不一定相同,例如我本地cxf+spring只需要如下jar包: 而泰康的was环境则需要如下jar包:

明显的多了很多,原因应该是服务器jar包池的不同。根据错误提示缺什么补什么就可以了,注意jar包勿重复。 第二步,配置web.xml文件,如下(重要的地方已标记): contextConfigLocation classpath:/applicationContext.xml org.springframework.web.context.ContextLoaderListener encodingFilter org.springframework.web.filter.CharacterEncodingFil ter encoding UTF-8 encodingFilter /* CXFServlet org.apache.cxf.transport.servlet.CXFServlet 1 CXFServlet /webservice/* 上述标记的地方,第一处是spring配置文件路径;第二出是wsdl地址内容;

android调用WebService接口详解

Android调用WebService WebService是一种基于SOAP协议的远程调用标准,通过webservice可以将不同操作系统平台、不同语言、不同技术整合到一块。在Android SDK中并没有提供调用WebService的库,因此,需要使用第三方的SDK来调用WebService。PC版本的WEbservice客户端库非常丰富,例如Axis2,CXF等,但这些开发包对于Android系统过于庞大,也未必很容易移植到Android系统中。因此,这些开发包并不是在我们的考虑范围内。适合手机的WebService客户端的SDK有一些,比较常用的有Ksoap2,可以从https://www.doczj.com/doc/339023931.html,/p/ksoap2-android/downloads/list进行下载;将下载的ksoap2-android-assembly-2.4-jar-with-dependencies.jar包复制到Eclipse工程的lib目录中,当然也可以放在其他的目录里。同时在Eclipse工程中引用这个jar包。 具体调用调用webservice的方法为: (1)指定webservice的命名空间和调用的方法名,如: SoapObject request =new SoapObject(http://service,”getName”); SoapObject类的第一个参数表示WebService的命名空间,可以从WSDL文档中找到WebService的命名空间。第二个参数表示要调用的WebService方法名。 (2)设置调用方法的参数值,如果没有参数,可以省略,设置方法的参数值的代码如下: Request.addProperty(“param1”,”value”); Request.addProperty(“param2”,”value”); 要注意的是,addProperty方法的第1个参数虽然表示调用方法的参数名,但该参数值并不一定与服务端的WebService类中的方法参数名一致,只要设置参数的顺序一致即可。 (3)生成调用Webservice方法的SOAP请求信息。该信息由SoapSerializationEnvelope对象描述,代码为: SoapSerializationEnvelope envelope=new SoapSerializationEnvelope(SoapEnvelope.VER11); Envelope.bodyOut = request; 创建SoapSerializationEnvelope对象时需要通过SoapSerializationEnvelope类的构造方法设置SOAP协议的版本号。该版本号需要根据服务端WebService的版本号设置。在创建SoapSerializationEnvelope对象后,不要忘了设置SOAPSoapSerializationEnvelope类的bodyOut属性,该属性的值就是在第一步创建的SoapObject对象。 (4)创建HttpTransportsSE对象。通过HttpTransportsSE类的构造方法可以指定WebService的WSDL文档的URL: HttpTransportSE ht=new HttpTransportSE(“http://192.168.18.17:80 /axis2/service/SearchNewsService?wsdl”); (5)使用call方法调用WebService方法,代码: ht.call(null,envelope);

NET调用WebService服务的方法详解!

本文实例讲述了https://www.doczj.com/doc/339023931.html,调用WebService服务的方法。分享给大家供大家参考,具体如下: 一、WebService:WebService是以独立于平台的方式,通过标准的Web协议,可以由程序访问的应用程序逻辑单元。 (1)应用程序逻辑单元:web服务包括一些应用程序逻辑单元或者代码。这些代码可以完成运算任务,可以完成数据库查询,可以完成计算机程序能够完成的任何工作。 (2)可由程序访问:当前大多是web站点都是通过浏览器由人工访问的,web服务可以由计算机程序来访问。 (3)标准的we协议:Web服务的所有协议都是基于一组标准的Web协议,如HTTP、XML、SOAP、WSDl、UDDI等 (4)平台独立性:web服务可以在任何平台上实现。因为标准协议不是由单个供应商专用的,它由大多数主要供应商支持。 SOAP(Simple Object Access Protocol,简单对象访问协议)协议:是用于交换XML编码信息的轻量级协议,SOAP协议是HTTP和XML协议的组合。 WSDL(Web Service Description Language,Web服务描述语言)是用XML文档来描述Web 服务的标准,是Web服务的接口定义语言。 二、创建https://www.doczj.com/doc/339023931.html, WEB服务 建立Web服务就是把一些信息或逻辑对其他计算机和客户公开,进一步说,就是从支持SOAP通信的类中建立一个或多个方法。 创建Web服务的步骤:(VS2008) 首先,新建一个网站。选择文件-------->新建--------->网站,打开“新建网站”对话框,选择“https://www.doczj.com/doc/339023931.html, web服务”模板。确定后,创建成功。 创建好后,会生成Service.asmx,其代码隐藏文件Servece.cs位于App_Code文件中。Web服务文件都使用扩展名.asmx。 发现在VS2010中,创建web服务是先新建一个网站,在选择添加新项,然后选择web 服务。 三、使用https://www.doczj.com/doc/339023931.html, Web服务 (1)添加Web引用 1、新建网站,右键单击网站根目录,选择“添加Web引用”项。 2、在“添加Web引用”对话框中,在URl列表框中选择或者填入Web服务的URL。(.asmx 文件路径)然后在“添加Web引用”文本框中填入希望在应用程序中使用的添加Web引用名。

ESB部署WebService接口(统一用户和待办)

1 统一待办(WebService方式) 1.1 概述 门户系统做为用户访问各集成应用系统的统一入口,用户访问企业内部信息资源时只需要登录到门户系统,就可使用门户系统集成的各个应用,而待办做为各系统中用户需要处理的工作,门户系统需要提供收集建投内部应用系统中产生的待办信息,并且进行统一展现的功能,即统一待办功能。 统一待办应用业务涉及到的系统其中包括本期门户系统建设过程中所需集成的OA、WCM、EAM系统。 为保证门户系统接入各应用系统待办信息的规范性,现就各应用系统接入实现做统一要求,以确保门户系统统一待办功能实现的规范性、重用性及安全性。不满足本技术方案提供的接入规则的相关应用系统,应参考本文档完成对应用系统改造后方可进行门户系统统一待办接入工作。 统一待办实现共分为以下部分: 系统待办信息获取 系统待办信息展示 系统待办信息处理 1.2 待办信息获取 设计思路:应用系统通过门户系统提供的webservice接口向门户系统统一待办系统库写入代表信息,如下图

数据获取设计示意图 步骤如下: 1.应用系统需获得最新的待办信息。 2.应用系统通过门户接口,将获得的最新待办信息发送到门户系统。 3.统一待办系统将应用系统提供的待办信息展示给用户。 4.应用系统通过调用集成接口后获得信息,可以判断发送信息操作是否正常。 1.3 待办信息展示 设计思路:应用系统将最新的待办信息发送到统一待办系统中,并最终展示到门户首页上的待办栏目上,如下图 用户 待办栏目页面 待办集中展示设计示意图 场景如下:

在所有的待办类标题前加上”请办理”,待阅类标题前加上”请审阅”。此外,如果信息是未办或者未阅,用红色表示 1.4 待办信息处理 设计思路:用户点击门户系统上“待办栏目”里的一条待办时,弹出一个新页面,首先同应用系统实现SSO,然后跳转到应用系统的待办页面,完成待办处理后,由应用系统调用门户接口通知门户系统,并关闭弹出的待办处理页面,门户系统负责即时刷新门户待办页。如下图: 待办信息集中处理设计示意图

XMLWebService完全实例详细解析

XMLWebService完全实例详细解析 首先,我们必须了解什么是webservice.就概念上来说,可能比较复杂,不过我们可以有个宏观的了解:webservice就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据. webservice传递的数据只能是序列化的数据,典型的就是xml数据,这里我们也只讨论XML数据的传输. 有了一些对XML webservice的初步了解后,我们将切入正题,即是用一个具体的webservice事例的形式来讲解具体的webservice用法,用具体的事例来讲解一个概念我想怎么也要比单纯的说理能让人容易理解吧. 这里,我们将以一个简单的分布式课件搜索系统为例来讲解.使用VS2003为编译环境,C#为语言,SqlServcer2000为数据库.(这个例子来源于一位网上朋友的文章的启发,觉得很能代表webservice的特点,就按那个想法做了这么个系统来示例了) 首先,明确我们要做什么.我们需要一个对客户的接口,也就是个站点,我们把它称做ServiceGatherSite,它是何种形式都无所谓,甚至它本身并不需要数据库,它只是提供给用户一个查询的接口,真正的服务,普通用户是不接触到的.然后,这里我们还需要若干个提供服务的站点,我们可以称它们为资源站,这里为简单起见,假设有两个资源站,分别叫WebSiteA,WebSiteB,它们可以是不对外公布的,只是为了丰富查询数据而存在.最后,是我们最需要关注的东西---资源站提供给ServiceGatherSite的服务.两个资源站,就有两个服务,我们称为SiteAService和 SiteBService.两个服务间没有任何关系,内部提供的方法也完全没关联,只是需要把方法如何使用告诉ServiceGatherSite,意思是,服务只提供查询接口,返回的数据如何处理,服务本身并不管,全由使用服务的站点分配. 写了这么多,算是简要的介绍了下有关XML webservice的概念和我们这个例子的结构,下篇文章,我们将开始真正进入代码的设计阶段. 上篇文章介绍了些webservice的基本特性和我们例子的结构,这篇文章我们将开始具体的代码编写工作.

WebService接口代码样例说明

WS接口代码样例 Java代码调用样例 参见WSTest_for_Java.rar附件,该附件为Eclipse工程代码。接口调用参见https://www.doczj.com/doc/339023931.html,info.smsmonitor.Test C代码调用样例 参见WSTest_for_c.tar附件,该附件为标准C工程代码。 附录 Webservice消息发送接口报文样例: TaskID-003761653 8613301261178 106557503 1 This is test message 1 00:00-23:59

webservice接口开发

Eclipse 关于接口系统的开发 我们做接口服务端: 小知识: 接口分为:服务端与客户端 服务端:即提供者,是为调用者提供数据的一方; 客户端:即调用者,是调用接口的一方; <一> 服务端的创建 步骤1. 在eclipse新建一个普通工程,例如:新建一个web project 工程。 步骤2.创建完成后,在刚才新建的工程里面,加入我们需要实现的类,和接口。在实现类里面编写客户端传入参数后,需要的相关信息。 例如: Public String sayHello(String word) { Return word; } 步骤3. 进入服务端代码的自动生成阶段,我们选中刚才编写的实现类或是创建的工程,右键。选择,new→project…→other→,如下图,选择web service 服务端。点击next

步骤4.根据下图,通过选择实现类,点击完成。自动生成服务端了。

步骤5 .前4步骤已经完成了webservice的服务端,并已经自动启动好了,我们进行如下测试,访问下自动产生的wsdl文件是否能访问到: 例如:访问wsdl地址示例 http://10.1.159.28:8082/ICTS/services/GetWorkflowListDaoImp?wsdl 其中:GetWorkflowListDaoImp 为自己创建的实现类名称 <二>客户端的创建,测试我们完成的服务端接口:

步骤1. 创建一个普通的web project 工程 步骤2. 创建完成后,选中,我们创建的工程,右键→,new→other→,创建web service cliet 客户端,完成后,点击finish。完成 步骤3。我们通过客户端进行调用,测试一下服务端是否正常。通过如下示例地址:http://10.1.159.28:8082/test1/sampleGetWorkflowListDaoImpProxy/TestClient.jsp, 这是客户端为我们自动建立的测试页面,我们只需输入参数,就可以进行测试了。界面如下:

常用的webservice接口

商业和贸易: 1、股票行情数据WEB 服务(支持香港、深圳、上海基金、债券和股票;支持多股票同时查询) Endpoint:https://www.doczj.com/doc/339023931.html,/WebServices/StockInfoWS.asmx Disco:https://www.doczj.com/doc/339023931.html,/WebServices/StockInfoWS.asmx?disco WSDL:https://www.doczj.com/doc/339023931.html,/WebServices/StockInfoWS.asmx?wsdl 支持香港股票、深圳、上海封闭式基金、债券和股票;支持多股票同时查询。数据即时更新。此中国股票行情数据WEB 服务仅作为用户获取信息之目的,并不构成投资建议。支持使用| 符号分割的多股票查询。 2、中国开放式基金数据WEB 服务 Endpoint:https://www.doczj.com/doc/339023931.html,/WebServices/ChinaOpenFundWS.asmx Disco:https://www.doczj.com/doc/339023931.html,/WebServices/ChinaOpenFundWS.asmx?disco WSDL:https://www.doczj.com/doc/339023931.html,/WebServices/ChinaOpenFundWS.asmx?wsdl 中国开放式基金数据WEB 服务,数据每天15:30以后及时更新。输出数据包括:证券代码、证券简称、单位净值、累计单位净值、前单位净值、净值涨跌额、净值增长率(%)、净值日期。只有商业用户可获得此中国开放式基金数据Web Services的全部功能,若有需要测试、开发和使用请QQ:8698053 或联系我们 3、中国股票行情分时走势预览缩略图WEB 服务 Endpoint: https://www.doczj.com/doc/339023931.html,/webservices/ChinaStockSmallImageWS.asmx Disco: https://www.doczj.com/doc/339023931.html,/webservices/ChinaStockSmallImageWS.asmx?disco WSDL: https://www.doczj.com/doc/339023931.html,/webservices/ChinaStockSmallImageWS.asmx?wsdl 中国股票行情分时走势预览缩略图WEB 服务(支持深圳和上海股市的全部基金、债券和股票),数据即时更新。返回数据:2种大小可选择的股票GIF分时走势预览缩略图字节数组和直接输出该预览缩略图。 4、外汇-人民币即时报价WEB 服务 Endpoint: https://www.doczj.com/doc/339023931.html,/WebServices/ForexRmbRateWebService.asmx Disco:https://www.doczj.com/doc/339023931.html,/WebServices/ForexRmbRateWebService.asmx?disco

Java RPC 原生实现之WebService详解

Java RPC 原生实现之WebService 一WebService释义 WebService是一种跨语言和跨操作系统的系统间交互标准。 WebService采用SOAP协议封装数据、HTTP协议传输数据、WSDL 描述服务发布的XML格式。 二Java实现 JavaSE6内置支持WebService,可以直接用来实现远程调用,服务端通过@WebService来标记对外暴露的服务实现类,通过调用Endpoint.publish发布到指定的服务地址上。话不多说,直接上代码更直观。

服务接口: 注意:接口上一定要加@WebService注释,否则会报如下异常,端点接口没有Web服务注释。 服务实现类(document风格): 发布服务有两种SOAPBinding风格,SOAPBinding.style.DOCUMENT 和SOAPBinding.style.RPC,默认的是DOCUMENT。我们先以默认的风格来实现。

@WebService注解属性释义: endpointInterface:服务接口, 指定做SEI(Service EndPoint Interface)服务端点接口。 name:指定XML Web Service的名称。默认情况下,该值是实现XML Web Service的类的名称,wsdl:portType 的名称。缺省值为Java 类或接口的非限定名称。 serviceName:对外发布的服务名,指定Web Service 的服务名称:wsdl:service。缺省值为Java 类的简单名称+ Service。(字符串)。 targetNamespace:指定名称空间,默认使用接口实现类的包名反缀。 portName:wsdl:portName。缺省值为https://www.doczj.com/doc/339023931.html,+Port。

Webservice的应用与开发试卷

南京工业大学WebService的应用与开发试题(A)卷班级学号姓名 一、判断题(正确的打勾,错误的打叉,每题2分) 1.SOAP(Simple Object Access Protocol)协议是一个基于Xml的协议。它描述了数据类型的消 息格式以及一整套串行化规则,包括结构化类型和数组。(o) 2.客户端与Xml Web服务进行异步通信,向服务端发出服务请求的方法与接收web服务返回 的结构在同一线程中(e) 3.基于消息的体系的分布式应用中,可以使用异步消息处理也可以使用同步消息处理(o) 4.Web服务中使用SOAP表示数据的优点是SOAP提供了一种所有平台都支持的中间表示方 式,客户端只要将SOAP类型转换为自身平台可以理解的类型即可(o) 5.分布式应用程序节点越多,单点失败的可能性越大,整个系统发生故障的可能性越大(o) 6.Apache CXF为java WebService的一个框架,可以用它提供的命令行工具wsdl2java生成客 户端的代理类(o) 7.Xml DTD提供了一种避免元素名冲突的方法(e) 8.所有Xml文件只有一个根元素且不分大小写(e) 9.每个Xml文档分为两个部分:序言和文档元素。(o) 10.都是WSDL文档的关键元素。( e ) 11.XML Web服务的交互可以使用Internet协议中所有的协议( e ) 12.对于Web服务的请求可以穿越防火墙( o ) 13.ajax可以跨域访问Web服务( o ) 14.元素在WSDL中用于描述操作的引用输入/输出消息( o ) 15.元素在WSDL中用于描述交互中已经被定义了类型的数据( o ) 二、选择题(单、多项选择,每题2分) 1.Web Service需要以下哪些技术、协议的支持(ABCD ) A.HTTP B.SOAP C.XML D. T CP/IP 2.下列选项中,哪个是XML合法的元素名(A ) A.TOM

webservice接口开发

Microsoft .NET体系结构中非常强调Web Service,构建Web Service接口对.NET Framework开发工具有很大的吸引力,因此很多讲建立Web Service机制的文章都是使用.NET Framework开发工具的。 在这篇文章中我们将谈论下面几个方面的问题 1、客户端怎样和Web Service通信的 2、使用已存在的Web Service创建代理对象 3、创建客户端。这包括: Web 浏览器客户端 Windows应用程序客户端 WAP客户端 最好的学习方法是建立一个基于真实世界的实例。我们将使用一个已存在的Web Service,这个Web Service从纳斯达克获得股票价格,客户端有一个简单的接口,该接口的外观和感觉集中了建立接口的多数语句。 客户端描述 三种客户端都接受客户输入的同一股票代码,如果请求成功,将显示公司名和股票价格,如果代码不可用,将显示一个错误信息。客户端都设置有"Get Quote" 和"Reset"按钮以初始化用户的请求。 开发中的注意事项 我使用visual https://www.doczj.com/doc/339023931.html,作为我的集成开发环境,beta版没有结合.NET Mobile Web,因此,我们需要使用文本编辑器创建wap客户端,下一个版本的visual https://www.doczj.com/doc/339023931.html, 将整合入.NET Mobile Web 。 客户端怎样与Web Service通讯 我们先复习一下Web Service的功能,在我得上一篇文章中曾展示一幅图(如图一),a点的用户将通过Internet执行远程调用调用b点web 服务器上的东西,这次通讯由SOAP和HTTP完成。

基于TA+3webservice开发文档

Cxf WebService 整合Ta+3 1、需导入的jar包: 2、Web.xml配置: CXFServlet org.apache.cxf.transport.servlet.CXFServlet 1 CXFServlet /services/* 3、在config/bs下面建一个spring-cxf.xml,配置发布webservice

相关主题
文本预览
相关文档 最新文档