本文指导你如何根据请求和测试用例来创建你的第一个soapUI工程。文中例子主要用到amazon.com提供的web服务。
soapUI入门非常容易,但要想更深入的掌握soapUI的功能,还需要对下面的概念和技术有较好的了解:
l WSDL – 基本概念(服务、端口、绑定、端口类型),相关的xml-schema
l SOAP – 基本概念,相关的WSDL(绑定、等等),不同的编码类型(soap-encoded/literal)和消息类型 (document/rpc)
l XML与XML相关的技术 – Xpath、XML Schema、命名空间、等等
可以在W3C找到相关的规范;在W3Schools和 找到相关的教程。zvon.org
安装、运行soapUI
根据下面的步骤来安装、运行soapUI:
l 从站点top page,通过Java WebStart可以在线安装最新的版本
l 从站点sourceforge,下载安装soapUI的Windows版本,该版本包括了需要的Java运行环境(JRE1.5)。如果你不确定你的系统已经安装了合适的JRE,或者你想有开始菜单并且以后可以卸载,可以用该版本安装
l 从站点sourceforge,下载二进制发布物(例如:”soapui-1.7.5-bin.zip”),手工解压缩,运行bin目录下面的soapui.bat或者soapui.sh脚本(你的系统需要安装好java环境)
无论上面的那种安装方式,soapUI将会以一个空的工作空间开始。
创建、导入工程
安装并运行soapUI之后,你就可以创建第一个soapUI工程了。
l 右击左侧导航面板中的工作空间节点,选择”New WSDL Project”
l 在工程被保存前,应该填写工程名字和相应的本地WSDL文件
l 上面的内容填写好之后,将会帮你在工作空间创建一个空的工程
如果不是通过在线方式安装的,在下载文件的根目录有个例子工程;选择”Import Project”,找到sample-soapui-project.xml。
可以从用户指南获得更多关于工程的内容。
工程添加Web服务
现在可以为工程增加一个接口(WebService PortTypes)。
l 右击工程节点,选择” Add WSDL from URL”
l 输入WSDL接口的url:
http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl
增加amazon的Web服务,选择”OK”按钮
l soapUI会提示你是否为每个操作创建一个默认的请求,通常选择”Yes”按钮
l soapUI为amazon的端口类型” AWSECommerceServicePortType”创建了一个SOAP/Http绑定,并且为每一个操作创建了一个节点。
可以从用户指南获得更多关于接口的内容。
操作请求
上面操作已经增加了amazon Web服务,接下来可以执行请求了。在上面增加接口的时候,已经根据WSDL的Schema定义为每一个操作创建了默认请求。
l 展开接口下面的任何一个操作节点,能够看到创建的”Request 1” 节点
l 双击请求节点,在soapUI的右侧会出现请求编辑器(参照下图)
l 请求编辑器分为三部分
Ø 顶部的工具栏,包含一组请求相关的动作、操作
Ø 左边是请求区域
Ø 右边是响应区域
l soapUI默认生成的请求中,”?”表示需要被替换的内容。根据需要,可以替换或者删除掉这些值。通过按下工具栏最左边的按钮(绿色箭头)来发送一个请求
l 请求会在后台执行,响应内容会出现在编辑器的右边
可以从用户指南获得更多关于请求的内容。