JDeveloper's WSDL Editor - how to get better clues

Recently, I have been helping customers with broken WSDL files. I decided it would be valuable to others as well. Here are my 2 tips.

  • JDeveloper Editor

    • As you can see in the screen shoot below, you can get usefull hint from the WSDL editor in JDeveloper 10g R3:

    1. Switch the Editor view from Design to Source.

    2. If there is any syntax error, you will see some orange or red on the right side of the screen.

    3. If you mouse-over the lines that are underline in orange or red, you will see the pop-up window with some information describing the syntax error. In this case, there is something wrong with the <include> element.


    WSDL Editor

    Once you have the first hint, you are on the right path to solve your problem. The next step is to compare the broken WSDL with other valid samples. It becomes easier to figure out that the include element need to be wrapped and is not in the expected namespace.
      <wsdl:types>
        <schema xmlns="http://www.w3.org/2001/XMLSchema"
         targetNamespace="http://ws.cegetel.com/unautrens">
          <import namespace="http://vs.cegetel.com" schemaLocation="./test1.xsd"/>
        </schema>
      </wsdl:types>
    Finding that include should be replace with import may be a little harder to figure out, at first.

  • WSA ant task analyze

    • Another powerfull tool in your toolbox is the analyze task. Here is a very simple ant script that can be used, within JDeveloper:

      <project name="otn" basedir="." xmlns:o="antlib:oracle">
          property file="build.properties"/>
        <target name="check-wsdl">
          <o:analyze wsdl="./src/test.wsdl"/>
        </target>
      </project>

    The error message, when you execute the target 'check-wsdl' will give you another hint:
    model error: element "{http://vs.cegetel.com}creerContracSimp" not found.
    'creerContracSimp' is defined in test1.xsd but is not found by the WSDL processor. This is the second hint that guide you toward the invalid include element.

With the two tools combined, you are in good hands.

Hope you will find this usefull.
-ecco

Comments

Post a Comment

Popular posts from this blog

Changing the version of JDK used by JDeveloper

I have recently learned a quick and lazy way to change the version of the JDK used to run JDeveloper 10g R3. I am sure there is an option somewhere in the configuration screen to do the same, which I couldn't find... While JDeveloper is not running, locate the embedded JDK on disk and rename (or delete) that directory. For me, it was C:\opt\jdev\jdk. Once it's done, restart and you will by asked to locate the version of the JDK you want to use. It's another step to get going with JAVA on Vista. -ecco
Read more

Connection reset from a WCF Web Service

Here is an error message you may see, when calling WCF Web Services from java: IOException retrieving the response: java.net.SocketException: Connection reset As it may not be obvious the first time you see it, this may save you some time. One reason for this behaviour is when the WCF endpint is expecting to see wsa:Action SOAP header in the request. To find out if you are facing this case, you have to look inside the WSDL, and search for the policy that describes the contract for your endpoint. <wsp:Policy wsu:Id="CustomBinding_Echo1_policy">   <wsp:ExactlyOne>     <wsp:All>       <wsaw:UsingAddressing/>     </wsp:All>   </wsp:ExactlyOne> </wsp:Policy> To make this a concrete example, here is a sample WSDL . To find the policy, you will need to follow the import as the policy are not always advertized in the top-level document. Here is how the import looks:   <wsdl:import namespace="http://example.org/" location="h
Read more

unexpected null value for literal data

There is a challenge that is hard to overcome at first; making sense of error messages. You can always Google with the text of the error, “unexpected null value for literal data” and hope to be lucky . If you are using Oracle Application Server 10.1.3.0, here is the explaination for the message and two ways out. The Exception: unexpected null value for literal data at oracle.j2ee.ws.common.util.exception.JAXRPCExceptionBase.<init>(JAXRPCExceptionBase.java:52) at oracle.j2ee.ws.common.encoding.SerializationException.<init>(SerializationException.java:26) ... The relevant schema: <complexType name="Customer"> <sequence> <element name="address" type="tns:Address"/> <element name="firstName" type="string"/> <element name="lastName" type="string"/> </sequence> </complexType> A sample code that will cause this exception: public void testServ() throw
Read more