On Mon, 31 Oct 2005, Davanum Srinivas wrote: > Guy, > > Could you please file a JIRA enchancement request for #3 as it is > action-able? #1 and #2 will have to be on-going effort.
OK, will do. I'd be glad to help with the documentation but usually I don't have the insight to add anything useful. If I find any specific places to improve error reporting then I'll submit patches. > thanks, > dims > > On 10/31/05, Guy Rixon <[EMAIL PROTECTED]> wrote: > > Three suggestions for improving the Axis experience: > > > > 1. More effort to documentation. The Axis 1 documents aren't yet sufficient > > to > > deal with use in a real project. > > > > Just expanding some of the Javadoc comments would help. In fact, providing > > or > > expanding the package.html files would be good, and maybe more palatable > > than > > reworking the xdocs. :) > > > > If someone did want to work on the xdocs, the reference guide to WSDD would > > be > > a good place to start. > > > > 2. Improve the error reports. Currently, when Axis goes worng (more > > commonly, > > when it is misconfigured) the error reporting isn't sufficient to diagnose > > the > > problem. Alternatively, provide tools that can inspect the configuration of > > a > > deployed service and explain what's wrong. > > > > 3. Provide an alternative to the current WSDL2Java to write stubs that use > > an > > external seralizer/deserializer mechanism (Castor, XMLbeans, JAXB). In my > > experience with Axis, the stubs are the valuable part and the Axis > > XML-mapping > > is redundant (duplicates mapping code we already have) unstable (bean > > classes incompatible between Axis versions) and fragile. Hence the move to > > XMLBeans in Axis 2, I guess...but maybe Axis 1 could be cleaned up too? > > > > What I have in mind is a stub-generation tool that takes a WSDL contract, a > > Java interface defining the API of the stub and a file of class/element > > mappings. It would generate stubs for which the API is entirely defined by > > the > > author of the client, and which can be rebuild to the same contract in the > > next version of Axis 1; WSDL2Java can't provide this stability of interface. > > > > You could provide a separate tool for creating data-binding beans if one > > were > > needed. This could generate the beans that WSDL2Java currently produces. It > > would also need to generate the class/element mapping-file. > > > > Guy Rixon [EMAIL PROTECTED] > > Institute of Astronomy Tel: +44-1223-337542 > > Madingley Road, Cambridge, UK, CB3 0HA Fax: +44-1223-337523 > > > > > -- > Davanum Srinivas : http://wso2.com/blogs/ > Guy Rixon [EMAIL PROTECTED] Institute of Astronomy Tel: +44-1223-337542 Madingley Road, Cambridge, UK, CB3 0HA Fax: +44-1223-337523
