webService 调用

原创于 2015-05-25 15:17:42 发布 · 356 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#webservice

web开发专栏收录该内容

1 篇文章

订阅专栏

本文介绍如何在Tomcat上部署WebService服务，包括创建接口类、实现类、配置sun-jaxws.xml及web.xml等步骤，并提供客户端调用示例。

tomcat下webService例子：

需要配置文件sun-jaxws.xml和web.xml(需要添加监听器和对应webService服务的servlet),首先文件目录结构如下：

每个webService需要一个接口类和实现类。本例子给一个HelloWorld实现方法。先定义接口类HelloWorld

package com.mkyong.ws;


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


//Service Endpoint Interface
@WebService
@SOAPBinding(style = Style.RPC)
public interface HelloWorld{
	
	@WebMethod String getHelloWorldAsString();
	
}

实现类HelloWorldImpl，代码如下：

</pre><pre name="code" class="html">package com.mkyong.ws;

import javax.jws.WebService;

//Service Implementation Bean

@WebService(endpointInterface = "com.mkyong.ws.HelloWorld")
public class HelloWorldImpl implements HelloWorld{

	@Override
	public String getHelloWorldAsString() {
		return "Hello World JAX-WS";
	}
}

sun-jaxws.xml配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<endpoints
  xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"
  version="2.0">
  <endpoint
      name="HelloWorld"
      implementation="com.mkyong.ws.HelloWorldImpl"
      url-pattern="/hello"/>
</endpoints>

web.xml配置如下（主要相关的是添加listener和servlet）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, 
Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_3.dtd">

<web-app>
    <listener>
        <listener-class>
        	com.sun.xml.ws.transport.http.servlet.WSServletContextListener
        </listener-class>
    </listener>
    <servlet>
        <servlet-name>hello</servlet-name>
        <servlet-class>
        	com.sun.xml.ws.transport.http.servlet.WSServlet
        </servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>hello</servlet-name>
        <url-pattern>/hello</url-pattern>
    </servlet-mapping>
    <session-config>
        <session-timeout>120</session-timeout>
    </session-config>
</web-app>

上面配置成功以后，启动tomcat，则成功生成webService服务，会产生一个http://localhost:8080/WebService/hello

服务调用主要基于soap协议，通过中间的xml格式来传递参数。

以上完成了WebService服务的生成。然后是客户端的调用，首先用过wsimport工具，依据wsdl文件生成相应的类文件，然后用这些类文件，就可以像调用本地的类一样调用WebService提供的方。该工具可以用于非Java的服务器，如：用C#编写的WebService，通过wsimport则生成Java的客户端实现。

在命令提示符中使用如下命令：wsimport -keep -p com.mkyong.ws.jax-ws http://localhost:8080/WebService/hello?wsdl

　　命令参数说明：

　　-d:生成客户端执行类的class文件的存放目录

　　-s:生成客户端执行类的源文件的存放目录

　　-p:定义生成类的包名