前言
今天主要和大家分享搭建java版webservice,以及php调用webservice遇到的一些坑。博客内容大部分纯手打,纯亲测。
注:网上有很多使用Eclipse构建webservice的教程,不过配置较麻烦,而且最后可能还访问不了。因此,此博客采用MyEclipse搭建。需注意一点,MyEclipse10及以下的支持不了pattern库,因此发布的项目如果包含Pattern则无法支持,这也是博主换IDE的原因。
说明
开发环境:MyEclipse2014,JAX-WS构建(容易使用),Tomcat 7
何为WebService?
它是一种构建应用程序的普遍模型,可以在任何支持网络通信的操作系统中实施运行;它是一种新的web应用程序分支,是自包含、自描述、模块化的应用,可以发布、定位、通过web调用。 WebService 是一个应用组件,它逻辑性的为其他应用程序提供数据与服务.各应用程序通过网络协议和规定的一些标准数据格式(Http,XML,Soap)来访问 WebService ,通过 WebService 内部执行得到所需结果. WebService 可以执行从简单的请求到复杂商务处理的任何功能。一旦部署以后,其他 WebService 应用程序可以发现并调用它部署的服务。
关键的技术和规则
在构建和使用Web Service时,主要用到以下几个关键的技术和规则:
- XML:描述数据的标准方法.
- SOAP:表示信息交换的协议.
- WSDL:Web服务描述语言.
- UDDI:通用描述、发现与集成,它是一种独立于平台的,基于XML语言的用于在互联网上描述商务的协议.
XML
可扩展的标记语言(XML)是Web service平台中表示数据的基本格式。除了易于建立和易于分析外,XML主要的优点在于它既是平台无关的,又是厂商无关的。无关性是比技术优越性更重要的:软件厂商是不会选择一个由竞争对手所发明的技术的。
SOAP
SOAP是web service的标准通信协议,SOAP为simple object access protocoll的缩写,简单对象访问协议. 它是一种标准化的传输消息的XML消息格式。
WSDL
WSDL的全称是web service Description Language,是一种基于XML格式的关于web服务的描述语言。其主要目的在于web service的提供者将自己的web服务的所有相关内容,如所提供的服务的传输方式,服务方法接口,接口参数,服务路径等,生成相应的完全文档,发布给使用者。使用者可以通过这个WSDL文档,创建相应的SOAP请求消息,通过HTTP传递给webservice提供者;web服务在完成服务请求后,将SOAP返回消息传回请求者,服务请求者再根据WSDL文档将SOAP返回消息解析成自己能够理解的内容。
UDDI
将web service进行UDDI注册发布,UDDI是一种创建注册表服务的规范,以便大家将自己的web service进行注册发布供使用者查找.然而当服务提供者想将自己的web service向全世界公布,以便外部找到其服务时,那么服务提供者可以将自己的web service注册到相应的UDDI商用注册网站,目前全球有IBM等4家UDDI商用注册网站。因为WSDL文件中已经给定了web service的地址URI,外部可以直接通过WSDL提供的URI进行相应的web service调用。所以UDDI并不是一个必需的web service组件,服务方完全可以不进行UDDI的注册。
具体实例
(一) 开始搭建webservice
前提
首先安装好MyEclipse2014,保证jdk环境配置好了,有tomcat服务器(没有也没关系,MyEclipse自带MyEclipse Tomcat 7,亲测好用,默认端口为8080)。
- 创建发布webservice
- 配置Tomcat
- 部署项目并启动Tomcat服务器
- 添加JAX-WS库
- 测试webservice
编码
1. 创建发布webservice
新建Web Service Project
然后填好信息并next
然后接下来一直next,可选择生成web.xml.
这是刚新建的项目结构
2. 然后新建一类文件UserInfo.java
示例源码:
package com.yuan.webservice;
/**
*
* @author Joryun
*
*/
public class UserInfo {
public String GetUserInfo(){
return "源哥";
}
public String ParameterTest(String user, String pwd){
return user+":"+pwd;
}
}
3. 接下来发布web service
4. 选择从java类创建web service
5. 选择访问的java class
6. 生成WSDL(WSDL以上有介绍,不懂可以回去看)
7. 发布后的项目结构如下
(二) 配置Tomcat
前提
假定你需要使用自己本机Tomcat的情况下
过程
Window-Preferences-MyEclipse-Servers-Tomcat
配置好后Apply-OK.
部署项目并启动Tomcat服务器
部署此项目到服务器
选择完后Finish
接下来启动Tomcat服务器
服务器已启动的图例
添加JAX-WS库
在项目的构建路径中添加库文件
测试webservice
输入URL,出现图式效果即为发布成功.
http://localhost:8080/WebServiceDemo/UserInfoPort?wsdl
PHP调用webservice
说明
博主采用CI框架测试,但不用框架也一样。并且php项目文件发布到了xampp上,直接访问本地即可查看效果。
关于php调用webservice,亲测过两种方法:
1. 引入nusoap.php,调用call()方法
2. php5自带函数测试,classMap方式传值
1. 引入nusoap.php,调用call()方法
特别注意:以下两处圈红圈的是坑点,一开始测试的时候用的是webservice接口名的参数,即user,pwd.但实际上打印到网页上之后才发现参数是arg0和arg1。。。
2. php5自带函数测试,classMap方式传值
以下贴PHP实现源码:
<?php
header('Content-Type: text/html; charset=UTF-8');
/**
* Class Test
* Joryun
*
* 调用webservice测试类
*/
class Test extends CI_Controller
{
public function __construct()
{
parent::__construct();
}
public function index()
{
/**
* nusoap.php需在网上下载,并将该php文件包含进项目空间
* 引入nusoap.php,调用call()方法
*/
// require_once ("libs/nusoap.php");
//
// // Create the client instance
// $client = new nusoap_client('http://localhost:8080/WeixinDemo/UserInfoPort?wsdl', true);
// $client->soap_defencoding = 'utf-8';
// $client->decode_utf8 = false;
// $client->xml_encoding = 'utf-8';
//
// $param = array('arg0'=>'Joryun', 'arg1'=>'666666');//webservice参数数组
// $result = $client->call('ParameterTest', $param);//接口和参数
// print_r($result);
/**
* php5自带函数测试
* classMap方式传值
*/
$client = new SoapClient("http://localhost:8080/WeixinDemo/UserInfoPort?wsdl");
echo ("SOAP服务器提供的开放Function:");
echo '<pre>';
var_dump ( $client->__getFunctions () );//获取服务器上提供的方法
echo '</pre>';
echo '<br>';
echo ("SOAP服务器提供的Type:");
echo '<pre>';
var_dump ( $client->__getTypes () );//获取服务器上数据类型
echo '</pre>';
$object=new stdclass;
$object->arg0='Joryun';
$object->arg1='666666';
$result = $client->ParameterTest($object);
//$result=get_object_vars($result); //将object转换为array
var_dump($result);
}
}
?>
总结
好了,今天的教程就说到这里了<( ̄︶ ̄)>
当然了,之所以想分享是因为其中是有一些坑在,搞了一天多才搞定了。欢迎大家交流~~