WebServic

本章内容摘抄至   虫师 整理的【soapUI 学习文档】

第一节、WebService 基础

WebService它是一种构建应用程序的普遍模型,可以在任何支持网络通信的操作系统中实施运行;它是一种新的web 应用程序分支,是自包含、自描述、模块 化的应用,可以发布、定位、通过web 调用。

Web Service 是一个应用组件,它逻辑性的为其他应用程序提供数据与服务.各应用程序通过网络协议和规定的一些标准数据格式(Http,XML,Soap)来访问Web Service,通过WebService 内部执行得到所需结果.

Web Service 可以执行从简单的请求到复杂商务处理的任何功能。一旦部署以后,其他Web Service 应用程序可以发现并调用它部署的服务。

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
在构建和使用Web Service 时,主要用到以下几个关键的技术和规则:
1.XML:描述数据的标准方法.
2.SOAP:表示信息交换的协议.
3.WSDL:Web 服务描述语言.
4.UDDI 通用描述、发现与集成,它是一种独立于平台的,基于XML 语言的用于在互联网上描述商务的协议http://www.webxml.com.cn/zh_cn/index.aspx 这个网站中有不少免费的WebService 可用  

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
1,什么是 Web Service ?
Web Service 就是一个网络组件(一个可以通过网络访问的程序)。它有一个或多个端口(Port),这些端口用于接收客户端的请求,并返回响应请求和响应的 都是一种基于XML 的消息。 不过这种消息遵循特定的格式(SOAP )。

2,怎样调用 Web Service?
   可能这样说不太准确,应该是“怎样调用Web Service 中定义的操作 ”每个Web Service 都有一个描述文件(WSDL ),它描述 一个 Web Service 的如下方面:

  (1)服务的端口(接收SOAP 消息的端口)
  (2)服务提供的操作
  (3)操作的输入输出格式的定义(通过XMLSchema 定义输入输出格式)

   有了Web Service 的描述文件(WSDL ),我们就知道怎样调用这个Web Service 中定义的操作了。

  (1)通过服务提供的操作找到你想调用的操作

  (2)找到这个操作的输入格式的定义(XMLSchema ),按照这种输入格式构造一个SOAP 消息

  (3)将这个SOAP 消息发送到服务的指定端口
  (4)准备接收一个从Web Service 服务器返回的 SOAP 响应吧 !
3, Web Service服务器
一个Web Service 服务器,本质上和一个Web 服务器是相同的。它主要做下面这些事:

--> 监听网络端口(监听服务端口)
--> 接收客户端请求(接收SOAP 请求)
--> 解析客户端请求(解析SOAP 消息,将SOAP 消息转换为数据对象)
--> 调用业务逻辑 (调用Web Service 实现类的特定操作,参数是由SOAP 消息转换而来的数据对象)
--> 生成响应 (将返回值转换为SOAP 消息)
--> 返回响应 (返回SOAP 响应)
==========================================================================================
XML
什么是 XML?
· XML 指可扩展标记语言(EXtensible Markup Language)
· XML 是一种标记语言,很类似 HTML
· XML 的设计宗旨是传输数据,而非显示数据
· XML 标签没有被预定义。您需要自行定义标签。
· XML 被设计为具有自我描述性。
· XML 是 W3C 的推荐标准
XML 与 HTML 的主要差异
  XML 不是 HTML 的替代。
  XML 和 HTML 为不同的目的而设计:
  XML 被设计为传输和存储数据,其焦点是数据的内容。
  HTML 被设计用来显示数据,其焦点是数据的外观。
  HTML 旨在显示信息,而 XML 旨在传输信息。
没有任何行为的 XML。XML 是不作为的。也许这有点难以理解,但是 XML 不会做任何事情。XML 被设计用来结构化、存储以及传输信息。

下面是 John 写给 George 的便签,存储为 XML:
<note>
<to>George</to>
<from>John</from>
<heading>Reminder</heading>
<body>Don't forget the meeting!</body>
</note>
这个标签有标题以及留言。它也包含了发送者和接受者的信息。但是,这个 XML 文档仍然没有做任何事情。它仅仅是包装在 XML 标签中的纯粹的信息。我们需要编写软件或者程序,才能传送、接收和显示出这个文档。

XML 仅仅是纯文本
XML 没什么特别的。它仅仅是纯文本而已。有能力处理纯文本的软件都可以处理 XML。不过,能够读懂 XML 的应用程序可以有针对性地处理 XML 的标签。标签的功能性意义依赖于应用程序的特性。

通过 XML 您可以发明自己的标签
上例中的标签没有在任何 XML 标准中定义过(比如 <to> 和 <from>)。这些标签是由文档的创作者发明的。这是因为 XML 没有预定义的标签。在 HTML 中使用的标签(以及 HTML的结构)是预定义的。HTML 文档只使用在 HTML 标准中定义过的标签(比如 <p> 、<h1> 等等)。XML 允许创作者定义自己的标签和自己的文档结构。

XML 不是对 HTML 的替代
XML 是对 HTML 的补充。XML 不是对 HTML 的替代,理解这一点很重要。在大多数 web 应
用程序中,XML 用于传输数据,而 HTML 用于格式化并显示数据。

XML 应用于 web 开发的许多方面,常用于简化数据的存储和共享。

XML 把数据从 HTML 分离
如果你需要在 HTML 文档中显示动态数据,那么每当数据改变时将花费大量的时间来编
辑 HTML。通过 XML,数据能够存储在独立的 XML 文件中。这样你就可以专注于使用 HTML 进行布局和显示,并确保修改底层数据不再需要对 HTML 进行任何的改变。通过使用几行JavaScript,你就可以读取一个外部 XML 文件,然后更新 HTML 中的数据内容。

XML 简化数据共享
在真实的世界中,计算机系统和数据使用不兼容的格式来存储数据。XML 数据以纯文本
格式进行存储,因此提供了一种独立于软件和硬件的数据存储方法。这让创建不同应用程序可以共享的数据变得更加容易。

XML 简化数据传输
通过 XML,可以在不兼容的系统之间轻松地交换数据。对开发人员来说,其中一项最费
时的挑战一直是在因特网上的不兼容系统之间交换数据。由于可以通过各种不兼容的应用程序来读取数据,以 XML 交换数据降低了这种复杂性。

XML 简化平台的变更
升级到新的系统(硬件或软件平台),总是非常费时的。必须转换大量的数据,不兼容
的数据经常会丢失。XML 数据以文本格式存储。这使得 XML 在不损失数据的情况下,更容易扩展或升级到新的操作系统、新应用程序或新的浏览器。

XML 使您的数据更有用
由于 XML 独立于硬件、软件以及应用程序,XML 使您的数据更可用,也更有用。不同的
应用程序都能够访问您的数据,不仅仅在 HTML 页中,也可以从 XML 数据源中进行访问。通过 XML,您的数据可供各种阅读设备使用(手持的计算机、语音设备、新闻阅读器等),还可以供盲人或其他残障人士使用。

XML 用于创建新的 Internet 语言
很多新的 Internet 语言是通过 XML 创建的:
其中的例子包括:

  · XHTML - 最新的 HTML 版本
  · WSDL - 用于描述可用的 web service
  · WAP 和 WML - 用于手持设备的标记语言
  · RSS - 用于 RSS feed 的语言
  · RDF 和 OWL - 用于描述资源和本体
  · SMIL - 用于描述针针对 web 的多媒体
假如开发人员都是理性的
假如他们都是理性的,就让未来的应用程序使用 XML 来交换数据吧。
未来也许会出现某种字处理软件、电子表格程序以及数据库,它们可以使用纯XML
==============================================================================
WSDL
什么是 WSDL?
  · WSDL 指网络服务描述语言
  · WSDL 使用 XML 编写
  · WSDL 是一种 XML 文档
  · WSDL 用于描述网络服务
  · WSDL 也可用于定位网络服务
  · WSDL 还不是 W3C 标准
  WSDL 可描述网络服务(Web Services)
  WSDL 指网络服务描述语言 (Web Services Description Language)。
  WSDL 是一种使用 XML 编写的文档。这种文档可描述某个 Web service。它可规定服务的位置,以及此服务提供的操作(或方法)。

  WSDL 文档仅仅是一个简单的 XML 文档。它包含一系列描述某个 web service 的定义。

WSDL 文档结构
WSDL 文档是利用这些主要的元素来描述某个 web service 的:
元素 定义
<portType> web service 执行的操作
<message> web service 使用的消息
<types> web service 使用的数据类型
<binding> web service 使用的通信协议
一个 WSDL 文档的主要结构是类似这样的:
<definitions>
<types>
definition of types........
</types>
<message>
definition of a message....
</message>
<portType>
definition of a port.......
</portType>
<binding>
definition of a binding....
</binding>
</definitions>
PS:实际上以上的结构,可以用浏览器打开一个具体的 webservice 来看,比如以下查询
手机归属地的wsdl 格式的webservice
http://fy.webxml.com.cn/webservices/EnglishChinese.asmx?wsdl
WSDL 文档可包含其它的元素,比如 extension 元素,以及一个 service 元素,此元素可把
若干个 web services 的定义组合在一个单一的 WSDL 文档中。
WSDL 端口
<portType> 元素是最重要的 WSDL 元素。 它可描述一个 web service、可被执行的操
作,以及相关的消息。 可以把 <portType> 元素比作传统编程语言中的一个函数库(或一个
模块、或一个类)。
WSDL 消息
<message> 元素定义一个操作的数据元素。 每个消息均由一个或多个部件组成。可以把
这些部件比作传统编程语言中一个函数调用的参数。
WSDL types
<types> 元素定义 web service 使用的数据类型。 为了最大程度的平台中立性,WSDL
使用 XML Schema 语法来定义数据类型。
WSDL Bindings
<binding> 元素为每个端口定义消息格式和协议细节。
WSDL 实例
这是某个 WSDL 文档的简化的片段:
<message name="getTermRequest">
<part name="term" type="xs:string"/>
</message>
<message name="getTermResponse">
<part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
<operation name="getTerm">
<input message="getTermRequest"/>
<output message="getTermResponse"/>
</operation>
</portType>
在这个例子中,<portType> 元素把 "glossaryTerms" 定义为某个端口的名称,把
"getTerm" 定义为某个操作的名称。
操作 "getTerm" 拥有一个名为 "getTermRequest" 的输入消息,以及一个名为
"getTermResponse" 的输出消息。
<message> 元素可定义每个消息的部件,以及相关联的数据类型。
对比传统的编程,glossaryTerms 是一个函数库,而 "getTerm" 是带有输入参数 "getTermRequest" 和
返回参数 getTermResponse 的一个函数。

第二节、通过axis2 创建WebService 实例。


通过这一节的学习,更真切的感觉到了什么是webservice,我们怎样自己写一个简单的
webservice,这样,对我们后面利用soapUI 测试webservice 有帮助。如果你都不知道你测试的东西是什么,就直接测试,那似乎有点盲目。

· 开发webservice 工作准备
· 开发简单的webservice
· 利用tomcat+axis2 发布webservice
· 调用(测试)webservice
=========================开发WebService 的环境准备====================
使用axis2
----------------
axis2 是新一代的web service 开发工具,它会让你的web service 开发变得轻松,
快捷。下面让我们以一个实际的例子来体验一下。

首先,工欲善其事,必先利其器。就让我们先做好一些必备的准备工作吧。
1.下载axis2 的2 进制的包和war,现在的最新版本是1.4.1 发布时间是2008-8-25
地址分别是:http://apache.mirror.phpchina.com/ws/axis2/1_4_1/axis2-1.4.1-bin.zip
http://apache.mirror.phpchina.com/ws/axis2/1_4_1/axis2-1.4.1-war.zip
2.把下载后的war 放入tomcat 的webapps 目录里,然后启动tomcat,这样war 包就会自动
解压为目录axis2

在浏览器中输入http://localhost:7890/axis2/ ,如果一切正常你会看到下面的画面 (这东西,我以前就弄过,所以基本很快就搞定了)

3.就开始准备一下axis2 的eclispe 的插件了。axis2 的eclispe 插件分为2 个,一个是帮助我们生成aar 文件的,另一个是帮我们用wsdl 文件生成stub 代码的。

下载地址是 :

  http://www.apache.org/dyn/mirrors/mirrors.cgi/ws/axis2/tools/1_4_1/axis2-eclipse-service-archiver-wizard.zip

  http://www.apache.org/dyn/mirrors/mirrors.cgi/ws/axis2/tools/1_4_1/axis2-eclipse-codegen-wizard.zip

下 载完2 个压缩文件后,可以直接把解压后的文件拷贝到plugins 目录中,也可以在links目录中写文件路径的方式来安装插件,安装完插件后,打开 eclipse,在package explorer中点击右键--->选择new---->other 如果安装正确你会看到

(这个地方只有有点要说明:就是加压后的文件不能直接放,注意到解压后目录是
axis2-eclipse-service-archiver-wizardAxis2_Service_Archiver_1.3.0,
我们要放的是Axis2_Service_Archiver_1.3.0 这个文件夹,而不是上一层文件夹,刚开始我
直接解决,拖过去的,原来拖的是 axis2-eclipse-service-archiver-wizard,重启eclipse怎么也找不到插件,找了很久的原因才发现)这样我们的准备工作就好了哦。

========================开发一个简单的WebService============================
开发、发布自己的webservice
1. 首先自己写一个java 类
代码如下:
public class HelloWorld {
/**
* 简单的测试方法
*
*/
public String simpleMethod(String name) {
return name + " Say this is a Simple method ^-^";
}
}
这里特别注意,刚开始,编辑好后要保存,eclipse 会自动的编辑成.class 文件,需要把存
放.class 文件的目录记住,我这里是
C:Documents and SettingsAdministratorworkspacejunit_study 这个后面发布的时候
用的到。(原文中没有详细说明这个)
在eclispe 的package Explorer 中点击右键,在菜单中选择新建--->other...----->Axis2
Service Archiver
点击next 之后进入了选择 wsdl 文件,这里我们选择skip wsdl
点击next 之后,进入的是选择jar 文件的页面,这里我们没有外部的jar,所以点击next
直接跳过这个页面。
点击next 之后,进入的是选择xml 页面,这里我们选择的是自动生成xml,也就是勾选
Generate the service xml automatically 这一项
5. 点击next 之后,进入的是生成xml 文件的页面,在service name 里填写这个服务所
起的名字,这里我起名为MyWebserver,然后在class name 中
填写要发布的类,这里一定要写全路径,写好后就可以点击load 按钮,
如果一切ok 的话,你会看到如下画面
点击next 后,进入的是输出artiver 文件的页面,先要在output File location 中选择
要输出的路径,
在output File Name 中输入artiver 文件的名称。我起的名字是my_service (这里输
入的filename 只是一个文件名而已,无其他什么意义)


============================发布WebService===============================
这样,在我的桌面上就生成了一个my_service.aar 文件,将其放入到
Tomcat6.0webappsaxis2WEB-INFservices 中,打开http://localhost:7890/axis2/services/listServices

点击上面的HelloWorld 连接,就打开了如下的页面原来如此,这下我就知道soapUI 可以上场了。

=============================测试WebService============================

PS:原文中的三其实就是说的用java 来调用我们刚才发布的webservice,我只是用了soapUI
来调用了而已。

 

原文地址:https://www.cnblogs.com/majunBK/p/11912888.html