Axis and Document/Literal web service

[JeanLouis Marechaux]

Hia ll,
Need some Axis specialist here.
Until now, I had to concentrate on Apache SoAP 2.3. With this SOAP implementation, the way to "simulate" a DocLit service is to have an object which signature is :
org.w3c.org.Element myMethod(org.w3c.org.Element myArg)
Now with Axis 1.1, what is supposed to be my signature ?
is it the same than in Apache SOAP or:
org.w3c.org.Document myMethod(org.w3c.org.Document myArg)
or something else..... ??
Lasse, Kyle, Others ??

[Balaji Loganathan]

please have a look at the example provided by axis http://cvs.apache.org/viewcvs/ws-axis/java/samples/encoding/ you can see this example files under the samples/encoding directory of Axis package

[JeanLouis Marechaux]

Thanks a lot Balaji but...
The service you mention (ElementService.wsdl) is a rpc/encoded (according to its wsdl)
I want to publish a Document/Literal service

[Balaji Loganathan]

Sorry I did not read your question properly.

[JeanLouis Marechaux]

Thanks anyway Balaji
Anyone could answer this question ?
Don't tell me there is no Axis users out there !!

[Balaji Loganathan]

Originally posted by Jean-Louis Marechaux:
Thanks anyway Balaji
Anyone could answer this question ?
Don't tell me there is no Axis users out there !!

Actually I have been using axis for few months and found its NOT really stable for DOC/LIT service, many other users were also file'n lot of bugs on axis doc/lit service BUT axis is best product for RPC and Message based service and also interoperable with may other soap implementations.

[Howard Kushner]

DOC/LIT works fine in WebSphere Studio Application Developer v5.1, but that is not, strictly speaking, AXIS, but an IBM derivative, so YMMV.

[JeanLouis Marechaux]

Originally posted by Howard Kushner:
DOC/LIT works fine in WebSphere Studio Application Developer v5.1, but that is not, strictly speaking, AXIS, but an IBM derivative, so YMMV.

WSAD 5.1 ??
I only have WSAD 5.01.
Is 5.1 an upgrade available for a long time ??
WSDA 5.0.x only uses Apache SOAP 2.3, not Axis-like stuff as far as I know.

BTW, what is the signature of an DOC/LIt Axis method ??
It was my former question you know (look at the first post here)

[Lasse Koskela]

public Element doSomething(Element input);

If you use java2wsdl, the following parameters specify that the output wsdl should be for document literal:

--style DOCUMENT
--use LITERAL

These parameters produce the following output for a simple service class with the above mentioned signature:

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="urn:MyDocLitService"
    xmlns:impl="urn:MyDocLitService" 
    xmlns:intf="urn:MyDocLitService"
    xmlns:apachesoap="http://xml.apache.org/xml-soap"
    xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    xmlns="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:types>
      <schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="urn:MyDocLitService">
         <element name="in0" type="apachesoap:Element"/>
         <element name="doSomethingReturn" type="apachesoap:Element"/>
      </schema>
   </wsdl:types>
   <wsdl:message name="doSomethingRequest">
      <wsdl:part name="in0" element="impl:in0"/>
   </wsdl:message>
   <wsdl:message name="doSomethingResponse">
      <wsdl:part name="doSomethingReturn" element="impl:doSomethingReturn"/>
   </wsdl:message>
   <wsdl:portType name="MyDocLitService">
      <wsdl:operation name="doSomething" parameterOrder="in0">
         <wsdl:input name="doSomethingRequest" message="impl:doSomethingRequest"/>
         <wsdl:output name="doSomethingResponse" message="impl:doSomethingResponse"/>
      </wsdl:operation>
   </wsdl:portType>
   <wsdl:binding name="MyDocLitServiceSoapBinding" type="impl:MyDocLitService">
      <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
      <wsdl:operation name="doSomething">
         <wsdlsoap:operation soapAction=""/>
         <wsdl:input name="doSomethingRequest">
            <wsdlsoap:body use="literal" namespace="urn:MyDocLitService"/>
         </wsdl:input>
         <wsdl:output name="doSomethingResponse">
            <wsdlsoap:body use="literal" namespace="urn:MyDocLitService"/>
         </wsdl:output>
      </wsdl:operation>
   </wsdl:binding>
   <wsdl:service name="MyDocLitServiceService">
      <wsdl:port name="MyDocLitService" binding="impl:MyDocLitServiceSoapBinding">
         <wsdlsoap:address location="http://localhost:8080/axis/services/MyDocLitService"/>
      </wsdl:port>
   </wsdl:service>
</wsdl:definitions>

When changing the parameters to DOCUMENT and ENCODED, the output is

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="urn:MyDocLitService"
    xmlns:impl="urn:MyDocLitService" xmlns:intf="urn:MyDocLitService"
    xmlns:apachesoap="http://xml.apache.org/xml-soap"
    xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    xmlns="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:message name="doSomethingRequest">
      <wsdl:part name="in0" type="apachesoap:Element"/>
   </wsdl:message>
   <wsdl:message name="doSomethingResponse">
      <wsdl:part name="doSomethingReturn" type="apachesoap:Element"/>
   </wsdl:message>
   <wsdl:portType name="MyDocLitService">
      <wsdl:operation name="doSomething" parameterOrder="in0">
         <wsdl:input name="doSomethingRequest" message="impl:doSomethingRequest"/>
         <wsdl:output name="doSomethingResponse" message="impl:doSomethingResponse"/>
      </wsdl:operation>
   </wsdl:portType>
   <wsdl:binding name="MyDocLitServiceSoapBinding" type="impl:MyDocLitService">
      <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
      <wsdl:operation name="doSomething">
         <wsdlsoap:operation soapAction=""/>
         <wsdl:input name="doSomethingRequest">
            <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:MyDocLitService"/>
         </wsdl:input>
         <wsdl:output name="doSomethingResponse">
            <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:MyDocLitService"/>
         </wsdl:output>
      </wsdl:operation>
   </wsdl:binding>
   <wsdl:service name="MyDocLitServiceService">
      <wsdl:port name="MyDocLitService" binding="impl:MyDocLitServiceSoapBinding">
         <wsdlsoap:address location="http://localhost:8080/axis/services/MyDocLitService"/>
      </wsdl:port>
   </wsdl:service>
</wsdl:definitions>

Not much difference...
[ October 31, 2003: Message edited by: Lasse Koskela ]

[Howard Kushner]

Originally posted by Jean-Louis Marechaux:

WSAD 5.1 ??
I only have WSAD 5.01.
Is 5.1 an upgrade available for a long time ??
WSDA 5.0.x only uses Apache SOAP 2.3, not Axis-like stuff as far as I know.

I have had v5.1 since early August. If you're 5.0.1 then you gotta at least go 5.0.2, I would say, but that's still Apache SOAP... yawn.
To me the Apache SOAP was okay for the time being, but ever since I read Steve Graham's book I have been yearning for Axis... so now IBM has something that I really like and will be getting better and better!

[JeanLouis Marechaux]

Thanks a lot guys.
What would be my (professional) life without the JavaRanchers :roll:
So the signature with Axis is the same than with Apache Soap (which is a good news for me !)
Lasse, why do you want to change from DOC/LITERAL to DOC/ENCODED ???
Is there any technical reason for that, because it is not recommended by the WS-I Basic Profile !
[ November 03, 2003: Message edited by: Jean-Louis Marechaux ]

[Lasse Koskela]

Originally posted by Jean-Louis Marechaux:
Lasse, why do you want to change from DOC/LITERAL to DOC/ENCODED ???
Is there any technical reason for that, because it is not recommended by the WS-I Basic Profile !

I don't. I probably included both document styles because of a magnetic storm in the sun...

[JeanLouis Marechaux]

Originally posted by Lasse Koskela:

I don't. I probably included both document styles because of a magnetic storm in the sun...

[Lasse Koskela]

I also generated two other variants using the WRAPPED style (just to see what the heck it is...) but for some reason, I didn't post those. Apparently the storm didn't last that long