Return-Path: 
 <axis-user-return-28012-apmail-ws-axis-user-archive=ws.apache.org@ws.apache.org>
Delivered-To: apmail-ws-axis-user-archive@www.apache.org
Received: (qmail 55301 invoked from network); 26 Oct 2004 22:37:22 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur-2.apache.org with SMTP; 26 Oct 2004 22:37:22 -0000
Received: (qmail 43352 invoked by uid 500); 26 Oct 2004 22:35:36 -0000
Delivered-To: apmail-ws-axis-user-archive@ws.apache.org
Received: (qmail 43091 invoked by uid 500); 26 Oct 2004 22:35:34 -0000
Mailing-List: contact axis-user-help@ws.apache.org; run by ezmlm
Precedence: bulk
Reply-To: axis-user@ws.apache.org
list-help: <mailto:axis-user-help@ws.apache.org>
list-unsubscribe: <mailto:axis-user-unsubscribe@ws.apache.org>
list-post: <mailto:axis-user@xml.apache.org>
Delivered-To: mailing list axis-user@ws.apache.org
Received: (qmail 42974 invoked by uid 99); 26 Oct 2004 22:35:31 -0000
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=
X-Spam-Check-By: apache.org
Received-SPF: neutral (hermes.apache.org: local policy)
Received: from [192.215.81.75] (HELO relay2.san1.attens.com) (192.215.81.75)
  by apache.org (qpsmtpd/0.28) with ESMTP; Tue, 26 Oct 2004 15:35:29 -0700
Received: from ATMX31 (1380host149.starwoodbroadband.com [12.151.124.149])
	by relay2.san1.attens.com (8.11.6/8.9.3) with ESMTP id i9QMYbB08623
	for <axis-user@ws.apache.org>; Tue, 26 Oct 2004 22:34:37 GMT
Message-Id: <200410262234.i9QMYbB08623@relay2.san1.attens.com>
From: "Anne Thomas Manes" <anne@manes.net>
To: <axis-user@ws.apache.org>
Subject: RE: WSDL2Java does not generate custom exception
Date: Tue, 26 Oct 2004 18:35:02 -0400
MIME-Version: 1.0
Content-Type: text/plain;
	charset="US-ASCII"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Office Outlook, Build 11.0.5510
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1409
Thread-Index: AcS6p/egOK2h3RBwT3+wh7Lxlv+JxABAuUSQ
In-Reply-To: <1098717671.417d19e7f293f@webmail.spansurf.com>
X-Virus-Checked: Checked
X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N

Note, though, that fault messages MUST be defined as document/literal rather
than rpc/encoded, per the WSDL 1.1 specification [1]: 

<wsdlExcerpt>
3.6 soap:fault
The soap:fault element specifies the contents of the contents of the SOAP
Fault Details element. It is patterned after the soap:body element (see
section 3.5).

<definitions .... >
    <binding .... >
        <operation .... >
           <fault>*
               <soap:fault name="nmtoken" use="literal|encoded"
                                 encodingStyle="uri-list"? namespace="uri"?>
           </fault>
        </operation>
    </binding>
</definitions>

The name attribute relates the soap:fault to the wsdl:fault defined for the
operation.

The fault message MUST have a single part. The use, encodingStyle and
namespace attributes are all used in the same way as with soap:body (see
section 3.5), only style="document" is assumed since faults do not contain
parameters.
</wsdlexcerpt>

Also see WS-I Basic Profile [2]:

<wsiExcerpt>
4.4.2 Bindings and Faults
There are several interpretations for how wsdl:part elements that describe
soapbind:fault, soapbind:header, and soapbind:headerfault may be defined. 

R2205 A wsdl:binding in a DESCRIPTION MUST refer, in each of its
soapbind:header, soapbind:headerfault and soapbind:fault elements, only to
wsdl:part element(s) that have been defined using the element attribute. 

Because faults and headers do not contain parameters, soapbind:fault,
soapbind:header and soapbind:headerfault assume, per WSDL 1.1, that the
value of the style attribute is "document". R2204 requires that all
wsdl:part elements with a style attribute whose value is "document" that are
bound to soapbind:body be defined using the element attribute. This
requirement does the same for soapbind:fault, soapbind:header and
soapbind:headerfault elements.
</wsiExcerpt>

[1] http://www.w3.org/TR/wsdl#_soap:fault 
[2]
http://www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-24.html#Bindings_and_F
aults 

- Anne

-----Original Message-----
From: smcardle@spansurf.com [mailto:smcardle@spansurf.com] 
Sent: Monday, October 25, 2004 11:21 AM
To: axis-user@ws.apache.org
Subject: Re: WSDL2Java does not generate custom exception

OK

First define your exception as a complex type as follows:

  <complexType name="SystemFailureException">
	<sequence>
  	  <element name="sourceException" nillable="true"
type="xsd:anyType"/>
	</sequence>
  </complexType>

Next define the message as follows:

  <message name="SystemFailureException">
	<part name="fault" type="ex1:SystemFailureException"/>
  </message>

N.B. The part name attribute is "fault"

Next define the operation in the portType section of your WSDL as follows:

<operation name="getChargeForProductMigrationOrder">
  <input message="tns:getChargeForProductMigrationOrderRequest"/>
  <output message="tns:getChargeForProductMigrationOrderResponse"/>
  <fault message="tns:SystemFailureException"
name="SystemFailureException"/>
</operation>


Lastly in the binding section define the operation as follows:

  <operation name="getChargeForProductMigrationOrder">
	<soap:operation soapAction="urn:getChargeForProductMigrationOrder"/>
	<input>
	  <soap:body
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
namespace="urn:ESelfcareSoap" use="encoded"/>
	</input>
	<output>
 	  <soap:body
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
namespace="urn:ESelfcareSoap" use="encoded"/>
	</output>
	<fault name="SystemFailureException">
	  <soap:fault
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
namespace="urn:SystemFailureException" use="encoded"/>
	</fault>
</operation>

Pay attention to the name spaces'

This will then generate the Impl class with the correct throws clauses and 
these exceptions will be accessable directly within the client. These 
exceptions do not have to implement the Axis Fault.

Hope this helps

Steve

Quoting Los Morales <moraleslos@hotmail.com>:

> Hi,
> 
> I have a question on how Axis 1.1 generates a user-defined fault through
the
> 
> WSDL2Java tool.  I have defined a schema for an exception I want to return

> whenever something wrong happens during Web Service processing.  In my 
> custom WSDL, I specified this exception in the message, portType and
binding
> 
> definitions.  When I use the WSDL2Java tool to generate the server-side 
> skeleton, I do not see this exception in any throws clause or defined 
> anywhere except in the deploy.wsdd file.  The Exception class gets
generated
> 
> properly from the schema but does not look like Axis knows how to put this

> into the service.  I have attached portions of my code below.  Any advice 
> would be appreciated.  Thanks!
> 
> -los
> 
> #### Schema ####
> ....
>     <xsd:element name="ProcessingFault" type="ProcessingProblemType"/>
> 
>     <xsd:complexType name="ProcessingProblemType">
>         <xsd:sequence>
>             <xsd:element name="exceptionMessage" type="xsd:string" 
> minOccurs="0"/>
> 	</xsd:sequence>
>     </xsd:complexType>
> ....
> ##############
> 
> ### WSDL ####
> 
> <!-- message definitions -->
> ....
>     <message name="DownloadError">
> 	<part name="error" element="fault:ProcessingFault"/>
>     </message>
> 
> <!-- port type definitions -->
>     <portType name="DownloadPortType">
>         <operation name="downloadPrograms">
>          ....
> 	    <fault name="ProcessingProblemMessage"
message="tns:DownloadError"/>
>         </operation>
>     </portType>
> 
> 
> <!-- binding definitions -->
> ...
>     <fault name="ProcessingProblemMessage">
> 	    <soap:fault name="ProcessingProblemMessage" use="literal"/>
> 	</fault>
> 
> ############
> 
> _________________________________________________________________
> Get ready for school! Find articles, homework help and more in the Back to

> School Guide! http://special.msn.com/network/04backtoschool.armx
> 
>