javax.xml.ws

Annotation Type FaultAction

@Documented
 @Retention(value=RUNTIME)
 @Target(value=METHOD)
public @interface FaultAction

的 FaultAction注释是用在 Action注释允许WS-Addressing Action消息寻址与WSDL操作映射从异常类的 fault信息产权明确的关联。

在生成的WSDL操作映射为className班fault消息的wsam:Action属性值等于在FaultAction对应的值。对故障信息的wsam:Action值的精确计算，是指在JAX-WS规范算法。

例1：指定Action消息寻址的input产权明确的价值观，output和fault消息如果java方法抛出只有一个服务特定的异常。

@ webservice（targetNamespace =“http：/ /例子。COM /数字”）公共课addnumbersimpl {@行动（故障= {@ FaultAction（ClassName = addnumbersexception.class，值=“http：/ /例子。COM / faultaction”）}）public int addnumbers（int number1，int 2）把addnumbersexception {返回数+ 2；}}

生成的WSDL的样子：

 
        
        
        
      
        
      <定义>
       
         
       
         
         
         
   targetNamespace =”http://example.com/numbers”……
  
         
         
         
       
         
       <端口类型名称=“addnumbersporttype”> 
        <操作名称=“addnumbers”>
          … 
         <故障信息=“tns：addnumbersexception”name=“addnumbersexception”
           方便：行动=“http://example.com/faultaction” / >< /操作>< /端口类型>…< /定义> 
          
         
       
 
        
        
        
      
        
      

例2：下面是一个例子，说明如果Action消息寻址服务特定的例外性的显性价值是不存在的。

@ webservice（targetNamespace =“http：/ /例子。COM /数字”）公共课addnumbersimpl {public int addnumbers（int number1，int 2）把addnumbersexception {返回数+ 2；}}

生成的WSDL的样子：

 
        
        
        
      
        
      <定义>
       
         
       
         
         
         
   targetNamespace =”http://example.com/numbers”……
  
         
         
         
       
         
       <端口类型名称=“addnumbersporttype”> 
        <操作名称=“addnumbers”>
          … 
         <故障信息=“tns：addnumbersfault”name=“invalidnumbers”
           方便：行动=“http://example.com/numbers/addnumbersporttype/addnumbers/fault/addnumbersexception” / >< /操作>< /端口类型>…< /定义> 
          
         
       
 
        
        
        
      
        
      

例3：下面是一个例子，说明如何指定Action消息寻址属性如果java方法抛出一个以上的特定服务异常明确的价值观。

@ webservice（targetNamespace =“http：/ /例子。COM /数字”）公共课addnumbersimpl {@行动（故障= {@ FaultAction（ClassName = addnumbersexception.class，值=“http：/ /例子。COM / addfaultaction”），@ FaultAction（ClassName = TooBigNumbersException.class，值=“http：/ /例子。COM / toobigfaultaction”）}）public int addnumbers（int number1，int 2）把addnumbersexception，toobignumbersexception {返回数+ 2；}}

生成的WSDL的样子：

 
        
        
        
      
        
      <定义>
       
         
       
         
         
         
   targetNamespace =”http://example.com/numbers”……
  
         
         
         
       
         
       <端口类型名称=“addnumbersporttype”> 
        <操作名称=“addnumbers”>
          … 
         <故障信息=“tns：addnumbersfault”name=“addnumbersexception”
           方便：行动=“http://example.com/addfaultaction” / > 
          <故障信息=“tns：toobignumbersfault”name=“toobignumbersexception”
            方便：行动=“http://example.com/toobigfaultaction” / >< /操作>< /端口类型>…< /定义> 
           
          
         
       
 
        
        
        
      
        
      

从以下版本开始：

JAX-WS 2.1

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
类<? extends 异常>	className 异常类的名称

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	value Web服务寻址 Action消息寻址属性值为例外

Element Detail

className

public abstract 类<? extends 异常> className

异常类的名称

value

public abstract String value

Web服务寻址 Action消息寻址属性值为例外

Default:

“”