Simon Says - Top 10 tips on interop

If you don't have the time to watch msdntv, here they are:
  • #10 - no empty array (or arrays with un-initialized elements to be more precise)
    Person[] getPeoples() { return new Person[10]; }
  • #9 - package name (don't use equal test when comparing complexType - result in class cast or compiler error)
  • #8 - test for null ; don't use ==. instead use isNull()
  • #7 - no null for Date (System.DateTime does not have a null).
    It's supported in indigo but don't use.
  • #6 - date comparaison (use compareTo)
  • #5 - use a trace tool (console, proxy)
  • #4 - code so that you can change port number.
  • #3 - Unit Test (another good practice)
  • #2 - use doc/literal (WS-I recommend doc/literal, WS-I allow rpc/literal, niche market)
  • #1 - use XSD first (but still use your WS platform or toolkit for the WSDL from code).

A few comments I have :

  • #5 - I'll even go further on this one - Mindreef's SOAPscope rules !!!
  • #4 - this is just good practice, not an interop tip.
  • #3 - And make sure that you do not rely on default values in the unit test;
    0 + 0 = 0 or 1 - 1 = 0 are not good candidates for unit test.
  • #2 - ws-i.org does not recommend doc/literal over rpc/literal; Microsoft does.
  • #1 - what do we do with xsd:dateTime, based on #7 ?

-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