基于JAX-WS的Web Service服务端/客户端 ；JAX-WS + Spring 开发webservice

一、基于JAX-WS的Web Service服务端/客户端

下面描述的是在main函数中使用JAX-WS的Web Service的方法，不是在web工程里访问，在web工程里访问，参加第二节。

JAX-WS简介：

JAX_RPC(Java API for XML-Based RPC)允许Java应用程序可以通过已知的描述信息调用一个基于Java的Web服务，描述信息与Web服务的WSDL描述相一致

JAX-RPC2.0更名为JAX-WS2.0(Java API for XML-Based Web Services)

JAX-WS中，一个远程调用可以转换为一个基于XML的协议，如SOAP。开发者在使用JAX-WS的过程中，不需要编写任何生成、处理SOAP消息的代码，JAX-WS在运行时自动将API的调用转换为相应的SOAP消息

在服务器端，用户只需要通过Java语言定义远程调用所需实现的接口，并提供相应实现，通过调用JAX-WS的服务发布接口即可将其发布为WebService接口

在客户端，用户可以通过JAX-WS的API创建一个代理来实现对于远程服务器端的调用

JAX-WS服务端：

JAX-WS服务端采用注释描述WebService，不再依赖WebService描述文件

使用JDK1.6_45（JDK1.5中不包含所需类）

程序启动后，访问http://127.0.0.1:8888/Plus?wsdl即可查看自动生成的WSDL文件

小注：addr是随便定义的，只要保证ip和端口可用即可，例如可以改成如下形式

String addr = "http://127.1.1.1:8889/Plus1?wsdl"; 

客户端访问，根据该地址进行访问。

JAX-WS客户端：

package com.sean.client;

import java.net.URL;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;

import com.sean.server.Plus;

public class Client {
    public static void main(String[] args) throws Exception {
        QName serviceName = new QName("http://server.sean.com/", "PlusImplService");
        QName portName = new QName("http://server.sean.com/", "PlusImplPort");

        String addr = "http://127.0.0.1:8888/Plus?wsdl";
        URL url = new URL(addr);

        Service service = Service.create(url, serviceName);
        Plus plus = service.getPort(portName,Plus.class);
        //Plus plus = service.getPort(Plus.class);

        int result = plus.plus(1, 2);
        System.out.println("result:" + result);
    }
}

package com.sean.client;

import java.net.URL;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;

import com.sean.server.Plus;

public class Client {
	public static void main(String[] args) throws Exception {
		QName serviceName = new QName("http://server.sean.com/", "PlusImplService");
		QName portName = new QName("http://server.sean.com/", "PlusImplPort");
		
		String addr = "http://127.0.0.1:8888/Plus?wsdl";
		URL url = new URL(addr);
		
		Service service = Service.create(url, serviceName);
		Plus plus = service.getPort(portName,Plus.class);
		//Plus plus = service.getPort(Plus.class);
		
		int result = plus.plus(1, 2);
		System.out.println("result:" + result);
	}
}

使用Plus plus = service.getPort(Plus.class)方法时，客户端调用时报错：

Exception in thread "main" javax.xml.ws.WebServiceException: Undefined port type: {http://server.sean.com/}Plus  

Exception in thread "main" javax.xml.ws.WebServiceException: Undefined port type: {http://server.sean.com/}Plus

解决方式一：

如客户端示例，将Plus plus = service.getPort(Plus.class)修改为Plus plus = service.getPort(portName,Plus.class)

解决方式二：

修改PlusImpl类的@WebService标记修改为@WebService(endpointInterface="com.sean.server.Plus")

参考资料：

http://blog.csdn.net/a19881029/article/details/32101373

http://ethan163.iteye.com/blog/1779194

http://www.micmiu.com/soa/webservice/jdk6-webservice-doc-rpc/

------------------------------------------------------------------------------------------------------------------------------

二、JAX-WS + Spring 开发webservice

 

jax-ws的开发大概分为两种，分别如下：

第一种：使用独立的端口（指端口可以在spring中自定义配置）

　　首先说第一种方式，这种方式不需要添加额外的jar包，他使用的是JDK自带的JWS来实现的。

web.xml文件配置：不需要额外配置，只需要配置spring相关的配置即可。

    JAXWSExample
    
    
    
        contextConfigLocation
        classpath:conf/applicationContext*.xml
    
    
    
        org.springframework.web.context.ContextLoaderListener
    
    
    
        org.springframework.web.util.Log4jConfigListener
    
       
    
        org.springframework.web.util.IntrospectorCleanupListener
    

applicationContext-jaxws.xml

java  Code

package com.example.ws;

import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

import org.springframework.stereotype.Service;

// spring注解使用
@Service("exampleService")
// webservice地址使用
@WebService(serviceName="example")
// 防止jdk版本问题
@SOAPBinding(style=Style.RPC)
public class ExampleService {
    // dependency dao/service
    //@Autowired
    //private IBaseDao baseDao;

    
    @WebMethod
    public String example1 (String request){
        System.out.println(request);
        String response= request + "hello";
        return response;
    }
}

java代码中方法写的比较简单，也可以将输入参数和输出参数写为对象，这个根据需求来定。

以上就是第一种方法的实现方式，本地访问地址直接是：http://localhost:8088/example?wsdl

 小注：wsdl访问的方法：

  http://ip地址:服务器端口号/serviceName?wsdl

其中ip地址:服务器端口号：是在 中配置的（即localhost:8088），

serviceName在程序中配置（即@WebService(serviceName="example")。

第二种方式： 使用servlet方式，该方式使用服务器端口

　　此种方式的话需要依赖于jax-ws 2.2中的jar文件，另外还需要下载额外的jaxws-spring-1.8.jar和xbean-spring-3.0.jar

　　

web.xml，需要配置servlet

    
        index.jsp
    

　　

    
        org.springframework.web.context.ContextLoaderListener
    
　　
    
        contextConfigLocation
        classpath:conf/applicationContext*.xml
    
　　

　　
    
        JaxWsServlet
        com.sun.xml.ws.transport.http.servlet.WSSpringServlet
    
    
        JaxWsServlet
        /services/*
    

 

applicationContext-jaxws.xml，与之前不同之处在于，需要xml头需要增加wss的声明

 xmlns:wss="http://jax-ws.dev.java.net/spring/servlet"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd
    http://jax-ws.dev.java.net/spring/core
    http://jax-ws.dev.java.net/spring/core.xsd
    http://jax-ws.dev.java.net/spring/servlet
    http://jax-ws.dev.java.net/spring/servlet.xsd">
　　
　　
    
    
    

　　
    /services/add">
        
            
        
        
    

 

java Code 

package com.example.ws;

import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

import org.springframework.stereotype.Service;


@Service("exampleService")
// 只有此处与方法一不同
@WebService
@SOAPBinding(style=Style.RPC)
public class ExampleService {

    @WebMethod
    public String example1(String request){
        System.out.println(request);
        String response = request+ "hello";
        return response;
    }
}

 小注：

此种方式的本地请求地址为：http://localhost:8080/JAXWsExample2/services/add?wsdl

　　　　　　　　　　　　   http://ip地址:服务器端口号/ 项目应用名/servlet定义地址?wsdl

 参考资料：

http://www.cnblogs.com/mengzw/p/4040976.html

http://www.cnblogs.com/Johness/p/3824850.html

http://blog.csdn.net/lalicw/article/details/8897466

https://jax-ws-commons.java.net/spring/

http://www.mkyong.com/webservices/jax-ws/jax-ws-spring-integration-example/（maven工程配置）

（jax-ws webservice注解详解，参考以下资料）

http://wenku.baidu.com/link?url=cMKeybJvkAA_t5kaXmlPYm0J7I0mggnNLj4bXp0QGtpcpQbohMP275zd15IgBWobETDuaQUIYAaQV1OFyqY2qhyfCLiYClvcedVIlC2_hGa

---------------------------------------------------------------------------------------------

三、web工程下，客户端调用webservice的方法

1、服务端代码如下：

@WebService

public interface IMyService {  

    public int add(int a,int b);   

    public int minus(int a,int b);

}

 

@Service

@WebService(serviceName="myService")

@SOAPBinding(style = Style.DOCUMENT)

public class MyServiceImpl implements IMyService {

    public int add(int a, int b) {

       System.out.println(a+"+"+b+"="+(a+b));

       return a+b;

    }

 

    public int minus(int a, int b) {

       System.out.println(a+"-"+b+"="+(a-b));

       return a-b;

    }

}

2. spring配置文件如下：

3. 客户端方法，首先需要生成客户端的java代码，其次是调用

3.1 用wsimport命令生成客户端java代码

在JDK中也提供了相应的工具来根据wsdl生成客户端代码这就是wsimport，可以通过wsimport -help来查看相应的参数。这里采用了以下几个参数

-verbose 显示编译的信息  

-p 指定客户端package的名称

-keep 生成客户端的源文件和编译好的class文件，即导出客户端的class文件的同时，也导出源代码java文件

-d表示输出的目录，目录必须事先存在，否则导出失败

 

上例中：wsimport -verbose -p cn.cpic.koala.module.demo.webservice.client.myService -keep -d d: http://127.1.1.10:8089/myService?wsdl

生成的目录结构如下：

3.2 客户端调用

将生成的客户端java代码，拷贝到工程的src下，然后调用里面的方法，如下所示：

MyService test = new MyService();
MyServiceImpl a = test.getMyServiceImplPort();
a.add(1, 2);
a.minus(6, 1);

转载于:https://www.cnblogs.com/beautifulFuture/p/4599885.html