(八) 开发EJB容器模型的WEB服务

(8) 开发EJB容器模型的WEB服务

一：WEB服务(Web Service) ：

       Web 服务也是一种分布式技术，它与EJB最大的不同是，Web服务属于行业规范，可以跨平台及语言。而EJB属于java平台的规范，尽管理论上可以跨平台，但实现起来比较复杂，所以其应用范围局限在了java平台。看上去两者好像是互相竞争的关系，其实不是。它们两者的偏重点不一样，Web服务偏重的是这个系统对外提供什么功能，而EJB偏重的是如何使用一个个组件组装这些功能。就好比一个硬盘，它对外提供的是存储服务，这是web服务的关注点，对于怎样组装这个硬盘，怎样构造这些小零件，web服务并不关心，但这些却是EJB所关注的。

    JavaEE 为web service提供了两种不同的编程模型：EJB容器模型及Web容器模型，这里将以最新的JAX-WS2.x规范（Java API for XML-based Web Services）介绍webservice的开发。

  

二：

  建一个WebService的Eclipse项目，因为是EJB模型，所以要建一个无状态会话bean,然后把这个无状态会话bean发布为web service，

package cn.itm.bean; import java.io.Serializable; public class Order implements Serializable{ private String orderid; private String name; public String getOrderid() { return orderid; } public void setOrderid(String orderid) { this.orderid = orderid; } public String getName() { return name; } public void setName(String name) { this.name = name; } }
package cn.itm.service; import java.util.List; import cn.itm.bean.Order; public interface OrderService { public String getUserName(String name); public Order getOrder(String orderid); public List<Order> getOrders(); }接下来编写接口的实现类

OrderServiceBean.java

package cn.itm.service.impl; import java.util.ArrayList; import java.util.List; import javax.ejb.Remote; import javax.ejb.Stateless; import javax.jws.WebService; import cn.itm.bean.Order; import cn.itm.service.OrderService; @WebService(targetNamespace="http://ws.itcast.cn", name="OrderService", serviceName="OrderServiceBean" ) //无状态会话bean已经编写好了，现在要做的是把这个无状态bean里面的所有业务方法暴露为webservice方法， //如何做呢？ 比较简单。加注解。这样就可以把所有方法暴露为webservice方法 //有同学会问，如果我只想暴露其中的一些方法，那怎么办？ 在方法上面加注解@WebMethod @Stateless @Remote(OrderService.class) public class OrderServiceBean implements OrderService { // @WebMethod // 指定所要 暴露的方法。其他的方法就不会被 暴漏出来了。 public Order getOrder(String orderid) { Order order = new Order(); order.setOrderid(orderid); order.setName("学习webService"); return order; } @Override public List<Order> getOrders() { List<Order> persons = new ArrayList<Order>(); Order order1 = new Order(); order1.setOrderid("001"); order1.setName("小一"); Order order2 = new Order(); order2.setOrderid("002"); order2.setName("小二"); persons.add(order1); persons.add(order2); return persons; } @Override public String getUserName(String name) { return name; } }

       webservice 开发完后，就要对它进行打包发布。发布完后，进入JBoss的管理后台http://localhost:8080/jbossws，点击View a list of deployed services,查看发布的web服务,

这里的命名空间,服务名称,并未修改。

三：web服务开发完，就要开发web服务的客户端

WEB服务的客户端开发

开发步骤如下：
     1. 在应用的类路径下放入JAX-WS的jar文件(下载路径：https://jax-ws.dev.java.net) 。如果你使用的是JDK6，这一步可以省略，因为JDK6已经绑定了JAX-WS。目前JDK6绑定的JAX-WS版本是2.0。这意味着，当某些应用使用的JAX-WS版本高于2.0时，就有可能发生版本问题，这时，你需要升级JDK6中的JAX-WS版本，   

    方法如下：
    下载最高版本的JAX-WS，在产品lib目录中找到jaxws-api.jar和jaxb-api.jar ，把这两个文件copy到JDK6_HOME/jre/lib/endorsed目录下。

    如果有同学使用开发工具是myeclipse，这时应该把myeclipse所使用的jdk更改为你系统安装的jdk。
2. 利用Web Service客户端生成工具生成辅助类。
3. 第三步：借助辅助类调用web service。

  这里我们使用wsimport工具的Ant任务类生成辅助类

<?xml version="1.0" encoding="UTF-8"?> <project name="WSClient" default="wsclientgen" basedir="."> <property name="src.dir" value="${basedir}/src" /> <path id="build.classpath" description="设置类路径"> <fileset dir="${basedir}/lib"> <include name="*.jar"/> </fileset> </path> <target name="wsclientgen" description="生成webservice客户端辅助代码，执行后请刷新项目"> <taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport" classpathref="build.classpath"/> <wsimport wsdl="http://localhost:8080/WsHelloWorld/HelloWorldBean?wsdl" sourcedestdir="${src.dir}" package="com.foshanshop.ws.client" keep="true" verbose="true" destdir="${basedir}/bin"/> </target> </project>
新建一个Project,叫WSClient。
build.xml

<?xml version="1.0" encoding="UTF-8"?> <project name="WSClient" default="wsclientgen" basedir="."> <property name="src.dir" value="${basedir}/src" /> <path id="build.classpath" description="设置类路径"> <fileset dir="${basedir}/lib"> <include name="*.jar"/> </fileset> </path> <target name="wsclientgen" description="生成webservice客户端辅助代码，执行后请刷新项目"> <taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport" classpathref="build.classpath"/> <wsimport wsdl="http://127.0.0.1:8080/WebService/OrderServiceBean?wsdl" sourcedestdir="${src.dir}" package="cn.itcast.ws.client" keep="true" verbose="true" destdir="${basedir}/bin"/> </target> </project>

    执行Ant任务，会生成一大堆客户端Java代码文件,看图：
    那么怎么通过这些Java文件去调用web服务呢？
    建一个单元测试，在单元测试里面调用web服务


    然后执行单元测试方法，控制台上把返回值打印出来了。证明方法的调用是成功的。

    在开发Web Service的时候一定要注意：如果你们返回的是List类型的对象，应该采用泛型的形式来定义。这样的话，EJB容器内部才能对这种类型进行解析，并把它翻译成对应的XML类型。

WSTest.java

package junit.test; import org.jboss.remoting.samples.transporter.serialization.Order; import org.junit.BeforeClass; import org.junit.Test; import java.util.List; import cn.itcast.ws.client.OrderService; import cn.itcast.ws.client.OrderServiceBean; public class WSTest { @BeforeClass public static void setUpBeforeClass() throws Exception { } @Test public void getUserName(){ OrderServiceBean service = new OrderServiceBean(); OrderService orderService = service.getOrderServicePort(); System.out.println(orderService.getUserName("小明")); } @Test public void getOrder(){ OrderServiceBean service = new OrderServiceBean(); OrderService orderService = service.getOrderServicePort(); Order order = orderService.getOrder("999"); System.out.println(order.getOrderId() + "," + order.getName()); } @Test public void getOrders(){ OrderServiceBean service = new OrderServiceBean(); OrderService orderService = service.getOrderServicePort(); List<Order> orders = orderService.getOrders(); for(Order order : orders){ System.out.println(order.getOrderId() + "," + order.getName()); } } }

以下为：客户端开发成功效果。