Apache CXF Writing a service with Spring notes

sunny03

　　This example will lead you through creating your first service with Spring. You'll learn how to:

    * Set up your build for CXF

    * Writing a simple JAX-WS service 【设计与开发 JAX-WS 2.0 Web 服务】


    * Set up the HTTP transport


具体参考 http://cxf.apache.org/docs/writing-a-service-with-spring.html



可以采用以下两种方法之一开发 Web 服务：

* 契约优先：从 WSDL 契约着手，生成 Java 类来实现服务。

* 代码优先：从 Java 类着手，使用 Annotation 来生成 WSDL 文件和 Java 接口。
[Developing a Service-Java First Development]


JAX-WS2.0 入门
  (JAX-WS : Java API for XML Web Services)

接口定义：

@WebService(name = "UserService",targetNamespace = Constants.WS_NAMESPACE)
public interface UserWebService {
@WebResult(name = "user")
public UserDTO getUser(@WebParam(name = "userId") Integer userId);
}
　　* @WebService 必须，(name="UserService")可选，配置Service的名称，默认为类名。targetNamespace可选，默认为 http:// package的倒序，可在一个自己的Constants里定义统一的namespace. 如http://www.iteye.com

* 默认接口的所有方法均输出为WebService。

* @WebResult 可选，配置方法的返回值在WSDL的名称,CXF默认为result。

* @WebParam 可选，配置参数在WSDL的名称，CX比较笨F默认为arg0,arg1....

* @WebMethod 可选，有一个方法有此注释，则其他无注释的方法非WebService。


接口实现：

@WebService(endpointInterface = "com.javaeye.test.ws.user.UserWebService",targetNamespace = Constants.WS_NAMESPACE)
public class UserWebServiceImp
　　* @WebService(endpointInterface="")  必须，指定实现的接口。
　　* 在ServiceImpl中，最好命名@ServiceName 和 @PortName，否则默认以此类名来命名Service，如UserWebServiceImp，比较难看。

小结：

    接口与实现类都需要@WebService(targetNamespace = Constants.WS_NAMESPACE),接口还需要属性name,实现需要属性endpointInterface。

    CXF不会自动反射方法的参数名，每个方法的参数都需要重新标注。
　　JAXB2.0入门
 
(JAXB : Java Architecture  for XML Binding)


@XmlType(name = "User")
public class UserDTO {
}
　　* JAXB的智能化较高，基本上不需要手工映射。

* 默认的@XmlAccessorType(XmlAccessType.PUBLIC_MEMBER )根据公共getter/setter与公共属性反射

  (XmlAccessType.PROPERTY根据getter/setter反射，XmlAccessType.FIELD 根据成员变量反射)

* 如果有需要注释@XMLElement，@XMLAttribute，需配合XmlAccessorType定义，默认的PUBLIC_MEMBER，需要在getter/setter上定义，如果要写在成员变量上定义，则XmlAccessType改为FIELD。

* 用@XmlType定义 DTO名，否则名称默认小写。@XmlType(name = "User") 指定WSDL上的类型名称。

* @XmlTransient 可以注释某个字段，取消该字段的反射。
　　其他：
　　JAX-RPC 2.0 renamed to JAX-WS 2.0


jnn 写道

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规范。
　　引自：JAX-WS