webService CXF框架

CXF 框架 是一种 基于servlet 技术 的 SOA项目要有 jdk 和servlet

webService注解 :

Web Service 元数据注释（ JSR 181 ）

@WebService

 

1 、 serviceName ： 对外发布的服务名，指定 Web Service 的服务名称： wsdl:service 。缺省值为 Java 类的简单名称 +Service 。（字符串）

2 、 endpointInterface ： 服务接口全路径 , 指定做 SEI （ Service EndPoint Interface ）服务端点接口

3 、 name ：此属性的值包含 XML Web Service 的名称。在默认情况下，该值是实现 XML Web Service 的类的名称， wsdl:portType 的名称。缺省值为 Java 类或接口的非限定名称。（字符串 )

4 、 portName ：   wsdl:portName 。缺省值为 WebService.name+Port 。

5 、 targetNamespace ：指定你想要的名称空间，认是使用接口实现类的包名的反缀

6 、 wsdlLocation ：指定用于定义 Web Service 的 WSDL 文档的 Web 地址。 Web 地址可以是相对路径或绝对路径。（字符串）

注意：实现类上可以不添加 Webservice 注解  

 

@WebMethod

注释表示作为一项 Web Service 操作的方法，将此注释应用于客户机或服务器服务端点接口（ SEI ）上的方法，或者应用于 JavaBeans 端点的服务器端点实现类。

要点：

仅支持在使用 @WebService 注释来注释的类上使用 @WebMethod 注释

1 、 operationName ：指定与此方法相匹配的 wsdl:operation 的名称。缺省值为 Java 方法的名称。（字符串）

2 、 action ：定义此操作的行为。对于 SOAP 绑定，此值将确定 SOAPAction 头的值。缺省值为 Java 方法的名称。（字符串）

3 、 exclude ：指定是否从 Web Service 中排除某一方法。缺省值为 false 。（布尔值）  

 

@Oneway

注释将一个方法表示为只有输入消息而没有输出消息的 Web Service 单向操作。

将此注释应用于客户机或服务器服务端点接口（ SEI ）上的方法，或者应用于 JavaBeans 端点的服务器端点实现类  

 

@WebParam

注释用于定制从单个参数至 Web Service 消息部件和 XML 元素的映射。

将此注释应用于客户机或服务器服务端点接口（ SEI ）上的方法，或者应用于 JavaBeans 端点的服务器端点实现类。

1 、 name ：参数的名称。如果操作是远程过程调用（ RPC ）类型并且未指定 partName 属性，那么这是用于表示参数的 wsdl:part 属性的名称。

如果操作是文档类型或者参数映射至某个头，那么 -name 是用于表示该参数的 XML 元素的局部名称。如果操作是文档类型、

参数类型为 BARE 并且方式为 OUT 或 INOUT ，那么必须指定此属性。（字符串）   

2 、 partName ：定义用于表示此参数的 wsdl:part 属性的名称。仅当操作类型为 RPC 或者操作是文档类型并且参数类型为 BARE 时才使用此参数。（字符串）

3 、 targetNamespace ：指定参数的 XML 元素的 XML 名称空间。当属性映射至 XML 元素时，仅应用于文档绑定。缺省值为 Web Service 的 targetNamespace 。（字符串）

4 、 mode ：此值表示此方法的参数流的方向。有效值为 IN 、 INOUT 和 OUT 。（字符串）

5 、 header ：指定参数是在消息头还是消息体中。缺省值为 false 。（布尔值）

@WebResult

 

注释用于定制从返回值至 WSDL 部件或 XML 元素的映射。将此注释应用于客户机或服务器服务端点接口（ SEI ）上的方法，或者应用于 JavaBeans 端点的服务器端点实现类。

1 、 name ：当返回值列示在 WSDL 文件中并且在连接上的消息中找到该返回值时，指定该返回值的名称。对于 RPC 绑定，这是用于表示返回值的 wsdl:part 属性的名称。对于文档绑定， -name 参数是用于表示返回值的 XML 元素的局部名。对于 RPC 和 DOCUMENT/WRAPPED 绑定，缺省值为 return 。对于 DOCUMENT/BARE 绑定，缺省值为方法名 + Response 。（字符串）

2 、 targetNamespace ：指定返回值的 XML 名称空间。仅当操作类型为 RPC 或者操作是文档类型并且参数类型为 BARE 时才使用此参数。（字符串）

3 、 header ：指定头中是否附带结果。缺省值为 false 。（布尔值）

4 、 partName ：指定 RPC 或 DOCUMENT/BARE 操作的结果的部件名称。缺省值为 @WebResult.name 。（字符串）

@HandlerChain

 

注释用于使 Web Service 与外部定义的处理程序链相关联。只能通过对 SEI 或实现类使用 @HandlerChain 注释来配置服务器端的处理程序。

但是可以使用多种方法来配置客户端的处理程序。可以通过对生成的服务类或者 SEI 使用 @HandlerChain 注释来配置客户端的处理程序。此外，可以按程序在服务上注册您自己的 HandlerResolver 接口实现，或者按程序在绑定对象上设置处理程序链。

1 、 file ：指定处理程序链文件所在的位置。文件位置可以是采用外部格式的绝对 java.net.URL ，也可以是类文件中的相对路径。（字符串）

2 、 name ：指定配置文件中处理程序链的名称。

cxf框架的特点 :

1. Java 的 webService 实现本身就是一个很耗性能的实现方案（ xml 与 java 对象之间在服务端以及客户端的互转比较消耗性能）

 

2. 目前 java 主流的 webService 应用以 CXF 、 AXIS2 为主；

 

3. 通过网络渠道的了解 , 目前 CXF 的效率要比 AXIS2 高出至少 50% ；

 

4. 另外有一个 webService 的工具 metro 的效率比 CXF 高出 10% ；

 

5. CXF 的实现资料网上可以随便找出一大堆， metro 的资料相对少一些；

 

6. CXF 在 java 应用实现中已经很成熟，企业更倾向于用这样一个成熟的解决方案；

 

基于以上原因，我选择 CXF 来实现 webService 。

 

这是官网CXF的下载地址：

http://www.apache.org/dyn/closer.lua/cxf/3.2.1/apache-cxf-3.2.1.zip

。做个备忘，最少需要的jar包如下

antlr-2.7.7.jar

asm-5.2.jar

commons-codec-l.10.jar

commons-collections-3.2_2.jar

commons-lang3-3.6.jar

commons-text-l.l.jar

cxf-core-3.2.1.jar

cxf-rt-bindings-soap-3.2.1.jar

cxf-rt-databinding-jaxb-3.2.1.jar

cxf-rt-frontend-jaxws-3.2.1.jar

cxf-rt-frontend-simple-3.2.1.jar

cxf-rt-transports-http-3.2.1.jar

cxf-rt-transports-udp-3.2.1.jar

cxf-rt-ws-addr-3.2.1.jar

cxf-rt-ws-policy-3.2.1.jar

cxf-rt-wsdl-3.2.1.jar

neethi-3.1.0.jar

slf4j-api-1.7.25.jar

xmlschema-core-2.2.2.jar

 

常见 jar 包没有导入的错误总结

1 、 org.apache.catalina.LifecycleException: A child container failed during start

缺少： cxf-core-3.0.4.jar （最核心的包，不多说）

 

 

2 、 java.lang.ClassNotFoundException: org.apache.cxf.binding.soap.SoapBindingConfiguration

缺少： cxf-rt-bindings-soap-3.0.4.jar        （ soap 协议）

 

 

3 、 org.apache.cxf.jaxb.JAXBDataBinding ：

缺少： cxf-rt-databinding-jaxb-3.0.4.jar      

 

 

4 、加载 Application 文件时出现 Unable to locate Spring NamespaceHandler for XML schema namespace

     [http://cxf.apache.org/jaxws]

 

缺少： cxf-rt-frontend-jaxws-3.0.4.jar     （ frontend 前置的意思，你懂的）

 

5 、 org/apache/cxf/frontend/spring/ClientProxyFactoryBeanDefinitionParser 错误：

缺少： cxf-rt-frontend-simple-3.0.4.jar

 

 

6 、 class path resource [META-INF/cxf/cxf-servlet.xml] cannot be opened because it does not exist

缺少： cxf-rt-transports-http-3.0.4.jar

 

 

7 、 org.apache.cxf.BusException: No DestinationFactory was found for the namespace http://cxf.apache.org/transports/udp.

缺少： cxf-rt-transports-udp-3.0.4.jar

 

 

8 、 org.apache.cxf.ws.discovery.internal.WSDiscoveryServiceImpl startup

警告 : Could not start WS-Discovery Service.

javax.xml.ws.WebServiceException: java.lang.NullPointerException

不能初始化配置的 bean 服务，也就是运行到 <jaxws:server> 时出错

 

缺少： cxf-rt-ws-addr-3.0.4.jar

 

9 、 java.lang.ClassNotFoundException: org.apache.cxf.ws.policy.AssertionInfoMap

缺少： cxf-rt-ws-policy-3.0.4.jar        

 

 

10 、 java.lang.ClassNotFoundException: org.apache.cxf.wsdl.service.factory.ReflectionServiceFactoryBean

缺少： cxf-rt-wsdl-3.0.4.jar

 

11 、 java.lang.ClassNotFoundException: org.apache.neethi.AssertionBuilderFactory

缺少： neethi-3.0.3.jar

 

12 、 java.lang.ClassNotFoundException: org.slf4j.LoggerFactory

缺少： slf4j-api-1.7.9.jar

 

13 、 java.lang.ClassNotFoundException: org.apache.ws.commons.schema.resolver.URIResolver

缺少： xmlschema-core-2.2.1.jar