Affects: Documentation (Ref Guide, User Guide, etc.) Complexity: High Help Desk Ticket Reference: https://access.redhat.com/jbossnetwork/restricted/caseDetail.html?caseId=1178003 project_key: SOA The documentation of the wise SOAPClient does not specify it's behaviour when the web service being called generates a SOAP fault. In actuality, the SOAPClient throws an ActionProcessingException with the SOAP fault as actual fault. This should at least be documented in the SOA-P programmers guide. It should also be mentioned that by default this error will not be returned when being called via SOAP ourselves (see below), and that there will be no redelivery when being called via JMS (since it's not a RuntimeException). This default behaviour does cause problems when using the SOAPClient within an ESB-published web service endpoint itself. Apparently the "faultTo" EPR doesn't get set for exposed web service end points (which might be intended, or a different defect). See https://access.redhat.com/jbossnetwork/restricted/caseDetail.html?caseId=1178003 for discussion.
This is a candidate for SOA 5.1.0. not committed. Investigate if we need to provide better documentation on how fault handling works.
I originally raised this issue, together with SOA-2188. Do let me know if/how I can help out with writing a bit of docs on the subject.
The behaviour of exception processing should already be documented in the programmers' guide, this task would just defer to that part.
Usability and customer sat is important, thus this is made a blocker for SOA 5.1.
Labels: Added: ESB_Programmers_Guide Complexity: Added: High
Writer: Added: Darrin
this might have already been done upstream - please check
Writer: Removed: Darrin Added: dlesage
Release Notes Docs Status: Added: Documented as Resolved Issue Release Notes Text: Added: https://issues.jboss.org/browse/SOA-2186 The ESB Programmers' Guide documentation on exception processing behaviour has been updated to reflect that the SOAPClient throws an ActionProcessingException when a web service that is being called generates a SOAP fault. Note that redelivery doe not occurs when the web service is called through the JMS. This is because it is not a RuntimeException.
Release Notes Text: Removed: https://issues.jboss.org/browse/SOA-2186 The ESB Programmers' Guide documentation on exception processing behaviour has been updated to reflect that the SOAPClient throws an ActionProcessingException when a web service that is being called generates a SOAP fault. Note that redelivery doe not occurs when the web service is called through the JMS. This is because it is not a RuntimeException. Added: https://issues.jboss.org/browse/SOA-2186 The ESB Programmers' Guide documentation on exception processing behaviour has been updated to reflect that the SOAPClient throws an ActionProcessingException when a web service that is being called generates a SOAP fault. Note that redelivery does not occurs when the web service is called through the JMS. This is because it is not a RuntimeException.
Release Notes Text: Removed: https://issues.jboss.org/browse/SOA-2186 The ESB Programmers' Guide documentation on exception processing behaviour has been updated to reflect that the SOAPClient throws an ActionProcessingException when a web service that is being called generates a SOAP fault. Note that redelivery does not occurs when the web service is called through the JMS. This is because it is not a RuntimeException. Added: https://issues.jboss.org/browse/SOA-2186 The ESB Programmers' Guide documentation on exception processing behaviour has been updated to reflect that the SOAPClient throws an ActionProcessingException when a web service that is being called generates a SOAP fault. Note that redelivery does not occur when the web service is called through the JMS. This is because it is not a RuntimeException.
Release Notes Text: Removed: https://issues.jboss.org/browse/SOA-2186 The ESB Programmers' Guide documentation on exception processing behaviour has been updated to reflect that the SOAPClient throws an ActionProcessingException when a web service that is being called generates a SOAP fault. Note that redelivery does not occur when the web service is called through the JMS. This is because it is not a RuntimeException. Added: https://issues.jboss.org/browse/SOA-2186 The ESB Programmers' Guide documentation on exception processing behaviour has been updated to reflect that the SOAPClient throws an ActionProcessingException when a web service that is being called generates a SOAP fault.