JAVA的 WebService规范 JAX-WS实现例子

Web 服务分为Server、Client 两部分，Server 公开Web 服务，Client 调用Web 服务，JAX-WS 的服务端、客户端双方传输数据使用的SOAP 消息格式封装数据，在后面我们会看到其实SOAP 信封内包装的就是一段XML 代码。

I.服务端示例：
我们先看一个服务器端示例：
(1.)公开Web 服务的接口IHelloService：

package JASWS;


import javax.jws.WebService;


@WebService
public interface IHelloService {
Customer selectMaxAgeStudent(Customer c1, Customer c2);
Customer selectMaxLongNameStudent(Customer c1, Customer c2);
}

我们看到这个接口很简单，仅仅是使用类级别注解@WebService 就标注了这个接口的方法将公开为Web 服务，使用了这个注解的接口的所有方法都将公开为Web 服务的操作，如果你想屏蔽某个方法，可以使用方法注解@Method 的exclude=true。我们也通常把公开为Web服务的接口叫做SEI（Service EndPoint Interface）服务端点接口。

(2.)实现类HelloServiceImpl：

package JASWS;


import javax.jws.WebService;


@WebService
public class HelloServiceImpl implements IHelloService {

@Override
public Customer selectMaxAgeStudent(Customer c1, Customer c2) {
  if (c1.getBirthday().getTime() > c2.getBirthday().getTime())
     return c2;
  else
     return c1;
}

@Override
public Customer selectMaxLongNameStudent(Customer c1, Customer c2)
{
  if (c1.getName().length() > c2.getName().length())
     return c1;
  else
     return c2;
}
}

这个实现类没有任何特殊之处，但是如果你的实现类还实现了其他的接口，那么你需要在实现类上使用@WebService 注解的endpointInterface 属性指定那个接口是SEI（全类名）。

(3.)Customer 类：

package JASWS;


import java.util.Date;
import javax.xml.bind.annotation.XmlRootElement;


@XmlRootElement(name = "Customer")
public class Customer {
private long id;
private String name;
private Date birthday;

public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}

public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}

public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
}

这个类是公开为Web 服务的接口中的参数类型和返回值，因此你需要使用JAXB 注解告诉CXF 如何在XML和Java Object 之间处理，因为前面说过SOAP 消息格式包装的是一段XML代码，那么无论是服务器端还是客户端在接收到SOAP 消息时都需要将XML 转化为JavaObject，在发送SOAP 消息时需要将Java Object 转化为XML。

JAXB（Java Architecture for XML Binding) 是一个业界的标准，是一项可以根据XML Schema产生Java类的技术。该过程中，JAXB也提供了将XML实例文档反向生成Java对象树的方法，并能将Java对象树的内容重新写到XML实例文档。从另一方面来讲，JAXB提供了快速而简便的方法将XML模式绑定到Java表示，从而使得Java开发者在Java应用程序中能方便地结合XML数据和处理函数。

JDK中JAXB相关的重要Annotation：

@XmlType，将Java类或枚举类型映射到XML模式类型

@XmlAccessorType(XmlAccessType.FIELD) ，控制字段或属性的序列化。FIELD表示JAXB将自动绑定Java类中的每个非静态的（static）、非瞬态的（由@XmlTransient标注）字段到XML。其他值还有XmlAccessType.PROPERTY和XmlAccessType.NONE。

@XmlAccessorOrder，控制JAXB 绑定类中属性和字段的排序。

@XmlJavaTypeAdapter，使用定制的适配器（即扩展抽象类XmlAdapter并覆盖marshal()和unmarshal()方法），以序列化Java类为XML。

@XmlElementWrapper ，对于数组或集合（即包含多个元素的成员变量），生成一个包装该数组或集合的XML元素（称为包装器）。

@XmlRootElement，将Java类或枚举类型映射到XML元素。

@XmlElement，将Java类的一个属性映射到与属性同名的一个XML元素。

@XmlAttribute，将Java类的一个属性映射到与属性同名的一个XML属性。

其他&#x