ejb3 第12讲 --开发EJB容器模型的WEB服务

 

JAX-WS

　　JAX-WS规范是一组XML web services的JAVA API。JAX-WS允许开发者可以选择RPC-oriented或者message-oriented 来实现自己的web services。
　　在 JAX-WS中，一个远程调用可以转换为一个基于XML的协议例如SOAP。在使用JAX-WS过程中，开发者不需要编写任何生成和处理SOAP消息的代码。JAX-WS的运行时实现会将这些API的调用转换成为对于SOAP消息。
　　在服务器端，用户只需要通过Java语言定义远程调用所需要实现的接口SEI (service endpoint interface)，并提供相关的实现，通过调用JAX-WS的服务发布接口就可以将其发布为WebService接口。
　　在客户端，用户可以通过JAX-WS的API创建一个代理（用本地对象来替代远程的服务）来实现对于远程服务器端的调用。
　　通过web service所提供的互操作环境，我们可以用JAX-WS轻松实现JAVA平台与其他编程环境(.net等)的互操作。
　　JAX-WS与JAX-RPC之间的关系
　　Sun最开始的web services的实现是JAX-RPC 1.1 (JSR 101)。这个实现是基于Java的RPC,并不完全支持schema规范，同时没有对Binding和Parsing定义标准的实现。
　　JAX-WS2.0 (JSR 224)是Sun新的web services协议栈，是一个完全基于标准的实现。在binding层，使用的是the Java Architecture for XML Binding (JAXB, JSR 222)，在parsing层，使用的是the Streaming API for XML (StAX, JSR 173)，同时它还完全支持schema规范。

 

 

目的：使用ejb3 的 @WebService  注解开发一个webservice服务端，然后使用JAX-WS 技术完成客户端代码的生成和调用

 

 

 

webservice 服务器端的开发：

 

 

 

 

  步骤1： 写一个webservice 需要传输的对象

 

package cn.com.xinli.bean;

import java.io.Serializable;

public class Order implements Serializable
{
	String orderid;
	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;
	}
}

 

 

  步骤2： 定义webservice服务器端需要暴漏的方法

 

package cn.com.xinli.service;

import java.util.List;

import cn.com.xinli.bean.Order;

public interface OrderService
{
	public String getUserName(String name);
	public Order getOrder(String id);
	public List<Order> getOrders();
}

 

  步骤3： 定义暴漏方法的实现

 

 

package cn.com.xinli.service.impl;

import java.util.ArrayList;
import java.util.List;

import javax.ejb.Remote;
import javax.ejb.Stateless;
import javax.jws.WebMethod;
import javax.jws.WebService;

import cn.com.xinli.bean.Order;
import cn.com.xinli.service.OrderService;


/*使用这个注解，就可以这个会话bean中的方法暴漏成webservice方法
 * 如果你只想暴漏其中的某些方法，你可以再想对外暴漏的方法上
 * 加上@WebMethod 注解，那么没有这个注解的方法就不会暴漏
 * 成webservice方法了 
 * targetNamespace 命名空间 也就是wsdl中的 targetNamespace
 * name 端点接口的名称 也就是wsdl中的portType name
 * serviceName 服务的名称
 * 不修改上面的3个属性也没关系，就是你发布的wsdl的可读性差
 * */
@WebService(targetNamespace="http://xinli.com.cn",name="OrderService",
		serviceName="OrderServiceBean")
/*声明为无状态的会话bean 声明远程接口*/
@Stateless
@Remote(OrderService.class)
public class OrderServiceBean implements OrderService
{
	
	public Order getOrder(String orderid)
	{
		Order order=new Order();
		order.setOrderid(orderid);
		order.setName("亮亮娃");
		return order;
	}

	public List<Order> getOrders()
	{
		List<Order> persons=new ArrayList<Order>();
		Order order1=new Order();
		order1.setOrderid("001");
		order1.setName("huxl");
		
		Order order2=new Order();
		order2.setOrderid("002");
		order2.setName("ryp");
		
		persons.add(order1);
		persons.add(order2);
		return persons;
		
	}

	public String getUserName(String name)
	{
		return name;
	}

}

 

 

  步骤4： ant 打包

 

<?xml version="1.0" encoding="UTF-8"?>
<project name="Ejb3Webservice" basedir=".">

	
    <property name="src.dir" value="${basedir}"/>
	<property environment="env"/>
    <property name="jboss.home" value="${env.JBOSS_HOME}"/>
    <property name="jboss.server.config" value="default"/>
    <property name="build.dir" value="${basedir}\build"/>
	
	
	<path id="master-classpath" description="设置编译路径">
		<fileset file="${jboss.home}\client\*.jar"/>
	</path>
	
	 <target name="prepare" description="创建class文件目录">
	      
	 	<delete dir="${build.dir}"/>
	 	<mkdir dir="${build.dir}"/>
	 </target>
	
	<target name="compile" depends="prepare" description="编译">
		<!--只编译以cn开头的-->
	    	<javac srcdir="${src.dir}" destdir="${build.dir}" includes="cn/**">
	    		<classpath refid="master-classpath"/>
	    	</javac>
	 </target>
	
	
	<target name="ejbjar" description="创建ejb发布包" depends="compile">
		    <jar jarfile="${basedir}\${ant.project.name}.jar">
		    	<fileset dir="${build.dir}"/>
		    	<include name="**/*.class"/>
		    
		    </jar>
    </target>
	
	<target name="deploy" description="发布">
				<copy file="${basedir}\${ant.project.name}.jar" todir="${jboss.home}\server\${jboss.server.config}\deploy"/>
		</target>
		
		<target name="undeploy" description="卸载ejb">
					<delete file="${basedir}\${ant.project.name}.jar" todir="${jboss.home}\server\${jboss.server.config}\deploy"/>
		</target>
	
    
</project>

 

 

步骤5：验证输入 http://localhost:8080/jbossws/   找到 View a list of deployed services  点击可以看到你发的webservice的wsdl文件

<!--li><a href="depends" mce_href="/admin/blogs/440338/depends">View installed dependencies</a></li-->

 

webservice 客户端的开发：

 

 

 

步骤1： 建立一个空的项目，从 https://jax-ws.dev.java.net/2.1.7/ 下载 jax-ws,使用  java -jar JAXWS2.1.7-20090419.jar，解压缩后会有lib ，讲lib下的 jar包加到classpath下

 

步骤2：使用ant 从服务器的wsdl 生成本地调用框架

 

<?xml version="1.0" encoding="UTF-8"?>
<project name = "WSClient"  default="wsclient" basedir =".">
<property name = "src.dir" value = "${basedir}/src"/>
<path id="build.classpath" description="设置类路径">
  <fileset dir="${basedir}/lib">
   <include name="*.jar"></include>
  </fileset>
 </path>

<target name = "wsclient" description ="生成webservice客户端代码">
	<taskdef name = "wsimport" classname ="com.sun.tools.ws.ant.WsImport" classpathref="build.classpath"/>
	<wsimport wsdl="http://127.0.0.1:8080/Ejb3Webservice/OrderServiceBean?wsdl"
	sourcedestdir="${src.dir}" package="cn.com.xinli.ws.client" keep="true"
	verbose ="true" destdir="${basedir}/bin"/>
	</target> 
</project>

 

步骤3：使用junit4 写单元测试

 

 

package junit.test;


import java.util.List;

import org.junit.BeforeClass;
import org.junit.Test;

import cn.com.xinli.ws.client.Order;
import cn.com.xinli.ws.client.OrderService;
import cn.com.xinli.ws.client.OrderServiceBean;

public class WSTest
{

	@BeforeClass
	public static void setUpBeforeClass() throws Exception
	{
	}
	@Test
	public void getUserName()
	{
		OrderServiceBean orderServiceBean=new OrderServiceBean();
		/*得到端点接口*/
		OrderService orderService=orderServiceBean.getOrderServicePort();
		System.out.println(orderService.getUserName("晓亮"));
	}
	@Test
	public void getOrder()
	{
		OrderServiceBean orderServiceBean=new OrderServiceBean();
		/*得到端点接口*/
		OrderService orderService=orderServiceBean.getOrderServicePort();
		System.out.println(orderService.getOrder("1").getOrderid());
		System.out.println(orderService.getOrder("1").getName());
	}
	@Test
	public void getOrders()
	{
		OrderServiceBean orderServiceBean=new OrderServiceBean();
		/*得到端点接口*/
		OrderService orderService=orderServiceBean.getOrderServicePort();
		List<Order> orderList=orderService.getOrders();
		for(Order order:orderList)
		{
			System.out.println(order.getOrderid());
			System.out.println(order.getName());
		}
	}
}

 

 

 

验证： 保证服务器的wsdl 能正确访问,调用单元测试用例 ok！