发布和使用WebService

如何才可以发布一个WebService呢?
 在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。
    JAX-WS是指Java Api for XML – WebService.

用Jdk1.6.0_21以后的版本发布一个WebService服务.
    与Web服务相关的类,都位于javax.jws.*包中。
    主要类有:
           @WebService - 它是一个注解,用在类上指定将此类发布成一个ws.
           Endpoint – 此类为端点服务类,它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。


1、在类上添加@WebService注解。
           这是jdk1.6提供的一个注解。它位于:javax.jws.*包中。


2、通过EndPoint(端点服务)发布一个webService。


        Endpoint也是jdk提供的一个专门用于发布服务的类,它的publish方法接收两个参数,一个是本地的服务地址,二是提供服务的类。它位于javax.xml.ws.*包中。
        static Endpoint.publish(String address, Object implementor)           在给定地址处针对指定的实现者对象创建并发布端点。
stop方法用于停止服务。
        EndPoint发布完成服务以后,将会独立的线程运行。所以,publish之后的代码,可以正常执行。


其他注意事项:
       给类添加上@WebService注解后,类中所有的非静态方法都将会对外公布。
       不支持静态方法,final方法。-
       如果希望某个方法(非static,非final)不对外公开,可以在方法上添加@WebMethod(exclude=true),阻止对外公开。
       如果一个类上,被添加了@WebService注解,则必须此类至少有一个可以公开的方法,否则将会启动失败。

package cn.itcast.ws;
 
import javax.jws.WebService;
import javax.xml.ws.BindingType;
import javax.xml.ws.Endpoint;
import javax.xml.ws.soap.SOAPBinding;
 
/**
 * 通过WebService将类标记为实现WebService
 */
// 必须加上这个注解
@WebService
public class HelloService {
 
	public String sayHi(String name, int age) {
		return "hi " + name;
	}
 
	public String sayHello(String name) {
		System.out.println("sayHello()..." + name);
		return "hello " + name;
	}
 
	public static void main(String[] args) {
 
		/**
		 * 参数1:服务的发布地址和访问路径 参数2:服务的实现者
		 */
		Endpoint.publish("http://192.168.1.101:6789/hello", new HelloService());
		// 这是一个阻塞方法,会启动一个子线程
 
		System.out.println("Server started...");// 主线程依然会输出:Server started
	}
 
}

运行HelloService.java的main方法,服务就启动了。

然后我们在浏览器地址栏输入:http://192.168.1.101:6789/hello?wsdl 就可以看到WebService的使用说明书:

wsimport是jdk自带的,可以根据wsdl文档生成客户端调用代码的工具.当然,无论服务器端的WebService是用什么语言写的,都将在客户端生成Java代码.服务器端用什么写的并不重要.
       wsimport.exe位于JAVA_HOME\bin目录下.
       常用参数为:
              -d<目录>  - 将生成.class文件。默认参数。
              -s<目录> - 将生成.java文件。
              -p<生成的新包名> -将生成的类,放于指定的包下。
              (wsdlurl) - http://server:port/service?wsdl,必须的参数。
       示例:
             C:/> wsimport –s . http://192.168.0.100/one?wsdl
       注意:-s不能分开,-s后面有个小点,用于指定源代码生成的目录。点即当前目录。

        如果使用了-s参数则会在目录下生成两份代码,一份为.class代码。一份为.java代码。
        .class代码,可以经过打包以后使用。.java代码可以直接Copy到我们的项目中运行。

3,然后就会在c盘自动生成客户端代码:

4,把所有的.class文件删除掉,然后新建一个工程表示客户端,把c盘下名为“cn”的文件夹拷贝到这个工程中:

5,在客户端的工程中新建一个类:Invoke.java,在这个类中调用服务

package cn.itcast.ws;
 
/**
 * 通过wsimport生成客户端代码调用WS
 * 
 * @author zhaoqx
 * 
 */
public class Invoke {
 
	public static void main(String[] args) {
 
		/**
		 * WSDL: 
		 */
		HelloServiceService hss = new HelloServiceService();// 拿到服务
 
		/**
		 * WSDL: 
		 */
		HelloService hs = hss.getHelloServicePort();// 拿到服务对应的类
 
		String ret = hs.sayHello("jack");// 调用类的方法
 
		System.out.println(ret);
		System.out.println(hs.getClass().getSimpleName());//通过这句的输入可以看出hs是一个代理对象。
 
	}
 
}

猜你喜欢

转载自blog.csdn.net/qq_34165535/article/details/81610536