JAX-WS之旅（一）

JAX-WS之旅(一)

——作者：Angel

 

注意：

1>需要开发工具Eclipse

2>有注解编程的基础

3>JDK 需要1.6以上

4>附带完整源码

5>学习的时候建议和作者起相同的名称

6>测试环境 Window Xp

7>图片在附件中。

资源参考：

http://blog.csdn.net/chszs/article/details/5050756

 

 

目录

1. 什么是WebService. 1

2. 为什么需要WebService. 2

3. 主流WebService框架... 2

4． 利用JAX-WS开发Web服务... 2

 

 

1. 什么是WebService

Web Service 是有企业发布的完成其特定商务需求的在线应用服务，其他公司或者应用软件可以能够通过Internet来访问这项在线服务。

更多资源访问：http://baike.baidu.com/view/837392.htm

 

2. 为什么需要WebService

我们知道如果我们要把一个桌面程序发布成web程序的话，在以前并不是一件很简单的事情，当然在最早的时候有一项分布式开发技术RMI技术就实现了桌面程序web化。现在使用WebService就能够很简单的解决这个问题。其次使用WebService能够让两门语言进行通信，也就是说，你可以服务端是Java语言，而客户端是其他语言，比如Rubby语言。

当然以上只是简单的说明，如果要连接更多的webService还需要您自己细心的体会。

 

3. 主流WebService框架

   Axis2——全称Apache EXtensible Interaction System 即阿帕奇可扩展交互系统。

   JAX-WS——Java API for XML Web Services (JAX-WS)是Java程序设计语言一个用来创建Web服务的API。

等等。

更多资源：http://wenku.baidu.com/view/5d0ceef5f61fb7360b4c65c9.html

 

4． 利用JAX-WS开发Web服务

   接下来将以一个实例讲解JAX-WS。

在讲解之前我们大体了解下要开发一个JAX-WS的步骤：

（1）编写能够发布成webservice的接口

（2）实现接口，并指定客户端访问的WSDL（Web Service Description Language）服务名

（3）发布服务

（4）编写客户端访问

第一步：启动工具

打开开发工具Eclipse，这一步对于编程人员都是very easy的一件事件，直接过。

 

第二步：新建工程(演示工程名为WebService)

新建一个 Java Project.相信能够学习WebService这项技术的人，这个应该不是问题。为了照顾一些部分家人，我们还是稍微讲讲，会的家人这步可以跳过。

【菜单栏】--【File】--【New】--【Project】--【Java Project】

--【Next】输入【Project name】--【Finish】。

这样我们就创建了一个工程。

图示：

完成的效果图：

 

第三步：建包（演示包为webservice）

   在刚才建立的工程建立包结构。

操作如下：

点击工程src目录【右键】--【New】--【package】--【输入包名】--【Finish】。

 

第四步：新建接口(演示接口名为IMyServer)

在刚才建立的包下新建一个接口。

代码如下：

package webservice;

import javax.jws.WebService;

/**

 * 接口类

 * @author Administrator

 *

 */

@WebService //此代码说明该接口可以进行Web化

public interface IMyServer {

   

    /**

     * 在接口里有一个获取作者姓名的方法

     * @param name:姓名

     * @return:String

     */

    public String getMyName(String name);

   

}

注：此接口和我们平时写接口是一样的，只是增加了一条

@WebService这样的代码，这条代码的主要作用是允许我们这个接口交给WebService进行管理。

 

第五步：实现接口（演示实现类名为MyServerImpl）

让我们写一个实现我们刚才接口的类，写法和我们平时的大差不差。

代码如下：

package webservice;

 

import javax.jws.WebService;

 

//以下这句代码的作用是：定义客户端访问的WSDL服务名

@WebService(endpointInterface = "webservice.IMyServer")

public class MyServerImpl implements IMyServer{

 

    @Override

    public String getMyName(String name) {

       // TODO Auto-generated method stub

       System.out.println("Called by the client");

       return "Hello,"+name+",I'm happy to learn webservice with you.";

    }

   

}

注意：这个实现类比一般实现类多了以下代码：

@WebService(endpointInterface = "webservice.IMyServer")

这句代码作用是：定义客户端访问的WSDL服务名

webservice是包名,IMyServer是接口。

 

现在的文件目录结构如下：

 

 

第六步：发布服务（演示名为：PublishServer）

我们需要将我们的类进行发布。

代码如下：

package webservice;

 

import javax.xml.ws.Endpoint;

 

/**

 * 此类的作用是：发布我们要让客户端访问的类

 * @author Administrator

 *

 */

public class PublishServer {

    /**

     * 启动程序

     * @param args

     */

    public static void main(String[] args) {

       /*

        * 参数说明：

        * 第一个参数http:127.0.0.1:2011

        * 这是url地址，需要指定端口

        *

        * 第二个参数 new MyServerImpl()

        * 这个就是我们要让客户端访问的实现类

        *不能是接口（嘎嘎，接口也不允许 new呀。）

        */

       Endpoint.publish("http://127.0.0.1:2011/myweb", new MyServerImpl());

       System.out.println("The Server is started.");

    }

}

文件目录结构图：

 

 

让我们运行PublishServer

运行成功之后控制台显示：

 

这表示发布成功了，我们可以打开浏览器进行访问（因为是web，所以网页当然能访问了，嘎嘎）

【打开浏览器】--在地址栏输入

【http://127.0.0.1:2011/myweb?wsdl】

效果图：

 

至此说明以上操作基本上是没有问题了。

 

第七步：编写客户端程序（演示名为MyClient）

用浏览器访问并不是我们的最终目的，我们是希望通过Java代码去访问服务器。那么接下来让我们编写一下客户端程序。

代码如下：

package webservice;

 

import java.net.MalformedURLException;

import java.net.URL;

 

import javax.xml.namespace.QName;

import javax.xml.ws.Service;

 

public class MyClient {

 

    /**

     * 启动程序

     * @param args

     * @throws MalformedURLException

     */

    public static void main(String[] args) throws MalformedURLException {

       //服务URL

       URL url = new URL("http://127.0.0.1:2011/myweb");

      

       /*

        * 参数说明：

        * 第一参数： http://webservice/

        * 服务的URI

        *

        * 第二个参数：MyServerImplService

        * 在WSDL发布的服务名，这个名称是你的   实现类 连接上 Service

        *

        */

       QName qname = new QName("http://webservice/","MyServerImplService");

      

       //创建服务

       Service service = Service.create(url, qname);

      

       //提取服务端口

       IMyServer myServer = service.getPort(IMyServer.class);

      

       //调用方法

       System.out.println(myServer.getMyName("林祥纤"));

    }

 

}

文件目录结构：

 

 

运行MyClient:

Dos窗口显示接口：

 

 

注意：服务端不可关闭。

 

伸伸懒腰，终于可以闭灯休息了。

先告一小段落吧。

源码附上