java xml-remote procedure call
远程过程调用

jax-rpc
---------------------------------------
axis WebService
只需要拿到wsdl的URL地址就可以调用远程WebService

Jws(立即发布)
//使用这种方法发布WebService ，则只有在访问时才会动态生成wsdl。由于没有注册，所以这种方式不会显示在WebService列表中

首先写服务器端方法 建立一个Hello.jws 内容如下：
public class Hello{
public String axis(String message){
   return "it's "+message;
}
}

client端调用远程方法步骤

第一种方法：基于代理的方法调用

必须要提供一个VM参数给ServiceFactory
手工配置-Djavax.xml.rpc.ServiceFactory=org.apache.axis.client.ServiceFactory
或者使用程序代码配置 System.setProperty(ServiceFactory.SERVICEFACTORY_PROPERTY, "org.apache.axis.client.ServiceFactory");
首先要根据提供的WSDL的URL参数，创建一个service 对象实例。
建立一个和wsdl中提供的方法一一对应的代理接口（必须为接口，不能是类），这个接口要继承自java.rmi.Remote接口。
通过service对象返回一个实现了此接口的代理对象。
使用代理对象访问service远程方法

example：
//javax.xml.rpc.ServiceFactory
//需要配置虚拟机参数 可以手工配置-Djavax.xml.rpc.ServiceFactory=org.apache.axis.client.ServiceFactory 或者通过System.setProperty()
   System.setProperty(ServiceFactory.SERVICEFACTORY_PROPERTY, "org.apache.axis.client.ServiceFactory");
  

//生成service工厂
   ServiceFactory sf=ServiceFactory.newInstance()

-----------------
第二种反射的方法调用（更灵活）
这种方式比较灵活，所要调用的方法名是通过参数进行传递的。
  
   ServiceFactory sf=ServiceFactory.newInstance();
   Service service= sf.createService(new URL("http://localhost:8080/axis/Hello.jws?wsdl"),new QName("http://localhost:8080/axis/Hello.jws%22,%22HelloService"));
   //上面两步和第一种方式相同
   //使用service对象创建一个javax.xml.rpc.Call 的实例对象
   Call call=service.createCall(new QName("http://localhost:8080/axis/Hello.jws%22,%22Hello"));
   //通过Call.invoke() 远程调用方法，
   Object resultObj=call.invoke(new QName("http://localhost:8080/axis/Hello.jws%22,%22axis%22),new Object[]{"secondServiceDII call welcome"});
  
   System.out.println(resultObj);

第三种方法调用方式
通过WSDL2Java这一工具类根据所传的wsdl的uri生成java

运行 org.apache.axis.wsdl.gen.WSDL2Java 这个class文件需要配置参数
格式 java org.apache.axis.wsdl.WSDL2Java [options] WSDL-URI
如果使用Eclipse运行则非常简便 只需要配置参数运行即可
example:
   -p cn.itcast.stub http://localhost:8080/axis/Hello.jws?wsdl

这样运行后 生成的java文件会添加到当前工程的目录下，不过由于没有在sourse文件夹下所以在Eclipse中并不显示，需要手工调整下位置即可。

接下来只要再写两句简短的java代码即可完成对远程WebService方法的调用。
example：
   Hello_PortType helloInstanse=new HelloServiceLocator().getHello();
   //远程调用axis() 方法 并返回结果。
   String result=helloInstanse.axis(" thirdServiceStub");
   System.out.println(result);

--------------------
基于定制的WebService（这种在发布后就进行了注册）
简要步骤：写java类 -》写配置文件（可以自定义namespace）-》用adminclient处理下(参数为配置文件名)-》将方法类放到服务器classes目录下（必须包含与包名对应的目录）。

/************************************************************************************/
ri ：reference implement   参考实现

jax-ws api的动态调用
----------------------------
jdk 6 自带了jax-ws WebService 版本为2.0
我们也可以在网上下载2.X的 jar包 ，这个版本包含了一些jdk自带包所没有的功能。
soap消息的格式有四种

使用jdk 6自带的jax-ws访问 WebService 的几种方法

第一种方法
使用jdk提供的 wsimport.exe 自动生成客户端代码，或者也可以直接使用MyEclipse生成，然后调用即可。
但是使用这种生成源代码对服务器端wsdl的soap消息格式有要求，有的格式不支持

第二种方法
使用jdk自带的 javax.xml.ws.Service
创建Service对象进行调用。
   Service service=Service.create(URL,Qname);
   T obj=service.getPort(Qname,serviceEndpointInterface); //返回代理对象
   //之后就可以通过代理对象远程调用 WebService

创建jax-ws WebService
jax-ws WebService的创建使用到了java中的注解，
目前有两种配置创建方法：
1. 写好Service 接口和其实现类，实现类使用注解指明WebService的配置。
   然后在web.xml中注册此Service实现类。这样就可以去发布成为一个WebService了。
  
   注意：由于发布的是一个WebService工程，web.xml的配置中注册的是一个Service类，而不是servlet。所以只能使用包含WebService容器的服务器进行部署，如Jboss。象Tomcat这样的服务器由于只是一个Web container ，所以并不支持对非servlet的注册。

2. 通过sun提供的一个监听器WSServletContextListener，就可以把此service模拟成一个大servlet进行发布。
   这种方式主要是添加了两处配置而完成。配置添加/WEB-INF/sun-jaxws.xml文件 和配置web.xml文件 ，其具体配置内容可以参考 JAX-WS WebService API ，基本只需复制修改即可完成。

使用jax-ws创建 WebService 过程中注解释义（详细介绍还请看 API DOC,这里仅作简要介绍）：
@WebService   标记此类为WebService
@SOAPBinding
@Oneway    这一注解标记当前方法为单向的 ，即可以理解为没有返回值的方法。由于此注解的保留范围是RUNTIME，所以当部署WebService时就会检查，如果方法的定义不符和要求就会报出异常：com.sun.enterprise.deployment.backend.IASDeploymentException
@WebMethod  
   如果类中没有方法加此注解，则默认全部为webservice中的方法。否则只显示添加了此注解的方法。
@WebResult  
@WebParam 其对方法的参数进行注解。它总是在每一个参数前进行定义

使用jax-ws WebService 时，如果返回的对象为一个List，那么必须使用泛型才可以保留list中的对象类型信息。

Endpoint.publish("http://localhost:7070/Ebay%22,);//jdk1.6 带了一个小型的服务器，在这个上创建一个webservice ,这种方式仅供学习时使用
--------------------------

使用xfire WebService
主要步骤：导入必要的jar包 -》 建立service接口和实现类 -》配置service.xml(可以参考xfire doc) -》 在web.xml中配置xfire的注册映射（基本固定写法，可参考doc）
使用