服务端使用services.xml进行开发,客户端有三种方式进行开发。 【1】环境准备 将axis2.war解压开,将conf,lib(去掉txt),modules,service 四个文件夹复制到已有项目的WEB-INF下。 将lib中的jar
服务端使用services.xml进行开发,客户端有三种方式进行开发。
【1】环境准备
将axis2.war解压开,将conf,lib(去掉txt),modules,service 四个文件夹复制到已有项目的WEB-INF下。
将lib中的jar Add BuildPath。
【2】开发接口与实现类
接口类如下:
package com.web.Axis2.service;
public interface MyService {
public String sayHello(String name);
}
实现类如下:
package com.web.Axis2.service.impl;
import com.web.Axis2.service.MyService;
public class MyServiceImpl implements MyService{
@Override
public String sayHello(String name) {
System.out.println("this is service "+name);
return "hello "+name;
}
}
【3】配置services.xml
在services文件下新建一个文件夹(任意取名),再新建META-INF文件夹,最后再新增services.xml,接口信息就写在这里面。
具体路径:WEB-INF/services/myservice/META-INF/services.xml 。
【4】发布项目,测试服务端
【5】编写客户端
这里有三种方式:
① 使用wsdl文件(或wsdl的url)生成Stub,进行客户端研发;
② 使用RPC方式,进行service远程调用;
③ 使用document方式。
这里使用第二种方式,更便捷,不用生成Stub。
第二种方式客户端代码如下:
package com.web.client;
import javax.xml.namespace.QName;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;
public class Client {
public static void main(String[] args) {
String url="http://localhost:8080/Axis2/services/AxisService?wsdl";
//调用的方法名
String method="sayHello";
RPCServiceClient serviceClient;
try {
serviceClient = new RPCServiceClient();
Options options = serviceClient.getOptions();
EndpointReference targetEPR = new EndpointReference(url);
options.setTo(targetEPR);
// 在创建QName对象时,QName类的构造方法的第一个参数表示WSDL文件的命名空间名,也就是<wsdl:definitions>元素的targetNamespace属性值
QName opAddEntry = new QName("http://impl.service.Axis2.web.com",method);
Object[] opAddEntryArgs = new Object[] {"Tom"};
Class[] classes = new Class[] {String.class };
// 返回参数类型,这个和axis1有点区别
// invokeBlocking方法有三个参数,其中第一个参数的类型是QName对象,表示要调用的方法名;
// 第二个参数表示要调用的WebService方法的参数值,参数类型为Object[];
// 第三个参数表示WebService方法的返回值类型的Class对象,参数类型为Class[]。
// 当方法没有参数时,invokeBlocking方法的第二个参数值不能是null,而要使用new Object[]{}
// 如果被调用的WebService方法没有返回值,应使用RPCServiceClient类的invokeRobust方法,
// 该方法只有两个参数,它们的含义与invokeBlocking方法的前两个参数的含义相同
Object[] result=serviceClient.invokeBlocking(opAddEntry,opAddEntryArgs, classes);
System.out.println(result[0].toString());
} catch (AxisFault e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
另外一个例子可以参考:Client调用(Axis2-RPC)
【5】测试webservice
客户端输出结果如下:
服务端输出结果如下:
客户端测试结果如下:
服务端测试结果如下:
【6】第三种Client调用方式(document)
客户端代码如下:
package com.web.client;
import java.util.Iterator;
import org.apache.axiom.om.OMAbstractFactory;
import org.apache.axiom.om.OMElement;
import org.apache.axiom.om.OMFactory;
import org.apache.axiom.om.OMNamespace;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.client.ServiceClient;
public class Client2 {
/** * document方式 * @param args */
public static void main(String[] args) {
try {
String url="http://localhost:8080/Axis2/services/AxisService?wsdl";
Options options = new Options();
// 指定调用WebService的URL
EndpointReference targetEPR = new EndpointReference(url);
options.setTo(targetEPR);
options.setAction("http://impl.service.Axis2.web.com/sayHello");
ServiceClient sender = new ServiceClient();
sender.setOptions(options);
OMFactory fac = OMAbstractFactory.getOMFactory();
// targetNameSpace
String tns = "http://impl.service.Axis2.web.com";
OMNamespace omNs = fac.createOMNamespace(tns, "");
// 接口的方法
OMElement method = fac.createOMElement("sayHello", omNs);
//方法的参数
OMElement name = fac.createOMElement("name", omNs);
//设置参数值
name.setText("Jane");
method.addChild(name);
method.build();
OMElement result = sender.sendReceive(method);
System.out.println(result);
System.out.println("****************************************************************************************************************");
Iterator in = result.getChildElements();
while(in.hasNext()){
OMElement om = (OMElement)in.next();
System.out.println(om.getText());
}
} catch (AxisFault axisFault) {
axisFault.printStackTrace();
}
}
}
另外一个例子可以参考: Client调用(Axis2-Document)
【7】第一种Client调用方式(Stub)
配置axis2环境变量(或在DOS下进入axis2bin路径)
AXIS2_HOME=D:\Java_Tomcat_MySQL_jdk_zip\axis2-1.7.6
Path: % AXIS2_HOME%\bin
执行命令如下:
wsdl2java -uri http://localhost:8080/Axis2/services/AxisService?wsdl -p com.web.client -s -o stub
会在bin目录下生成stub文件夹:
将Stub拷入项目,进行使用;客户端代码如下:
package com.web.client;
import com.web.client.AxisServiceStub.SayHello;
import com.web.client.AxisServiceStub.SayHelloResponse;
public class Client3 {
/** * Stub方式 * @param args * @throws Exception */
public static void main(String[] args) throws Exception {
try{
AxisServiceStub stub = new AxisServiceStub();
SayHello sayHello = new SayHello();
sayHello.setName("Janus");
SayHelloResponse res = stub.sayHello(sayHello);
String result = res.get_return();
System.out.println(result);
}catch(Exception ex){
ex.printStackTrace();
}
}
}
【8】关于wsdl2java说明
wsdl2java 用于根据WSDL生成相应的服务端和客户端代码的生成工具。
命令行格式为:
WSDL2Java [options] -uri <url or path> : A url or path to a WSDL
其中常用的options具体如下:
-o <path> : 指定生成代码的输出路径 -a : 生成异步模式的代码 -s : 生成同步模式的代码 -p <pkg> : 指定代码的package名称 -l <languange> : 使用的语言(Java/C) 默认是java -t : 为代码生成测试用例 -ss : 生成服务端代码 默认不生成 -sd : 生成服务描述文件 services.xml,仅与-ss一同使用 -d <databinding> : 指定databingding,例如,adb,xmlbean,jibx,jaxme and jaxbri -g : 生成服务端和客户端的代码 -pn <port_name> : 当WSDL中有多个port时,指定其中一个port -sn <serv_name> : 选择WSDL中的一个service -u : 展开data-binding的类 -r <path> : 为代码生成指定一个repository -ssi : 为服务端实现代码生成接口类 -S : 为生成的源码指定存储路径 -R : 为生成的resources指定存储路径 –noBuildXML : 输出中不生成build.xml文件
–noWSDL : 在resources目录中不生成WSDL文件
–noMessageReceiver : 不生成MessageReceiver类
可以直接指定输出路径到项目下:
wsdl2java -uri http://localhost:8080/Axis2/services/AxisService?wsdl -p com.web.client2 -s -o C:\Users\12746\eclipse\workspace2\Axis2Client\
生成的Stub如下所示: