How to use Axis2 codegen ANT task

Apache Axis2 code generator tool provides a very useful custom ANT task. All of the command line code generation options are available with the ANT task as well.
Lets see how a simple client side code generation is done using the ANT task.

Pre-requisites:
Install Apache Axis2 -1.3 or higher
Install Apache ANT-1.7 or higher

Step 1

Create a directory and start to create a build.xml inside that as given below. (eg:- C:\temp\build.xml)

<project name="CodegenExample" default="codegen" basedir=".">

<path id="axis2.classpath">
<fileset dir="C:\axis2\axis2-1.4\lib">
<include name="**/*.jar" />
</fileset>
</path>

<target name="codegen">

<taskdef name="axis2-wsdl2java"
classname="org.apache.axis2.tool.ant.AntCodegenTask"
classpathref="axis2.classpath"/>

<axis2-wsdl2java
wsdlfilename="C:\test\your.wsdl"
output="C:\output" />
</target>

</project>

If you are familiar with ANT, you should be able to understand this simple build script easily. We use the path referenced as "axis2.classpath" to add Axis2 library jars which are placed at AXIS2_HOME/lib (In our example, C:\Axis2\Axis2-1.4\lib)

Axis2 codegen ant task is implemented by the org.apache.axis2.tool.ant.AntCodegenTask class. Therefore we refer to that inside a taskdef as given in "taskdef name="axis2-wsdl2java"

wsdlfilename attribute is equivalent to the -uri option in wsdl2 java command line tool and output is similar to -o option.

Replace the values of wsdlfilename according to your wsdl location.

Step 2
Open a command prompt and go to the directory where you saved the above build.xml.
Type 'ant'

The generated stub classes will be saved in the specified out put directory.

Comments

yuvakumarr said…
Hi
Thanks for your nice blog with tips on axis2. I was trying to generate stub classes for mscrm wsdl, using axis2, and followed your sample build.xml. I am getting the following exception...

C:\TEMP\axistest\build.xml:17: org.apache.axis2.wsdl.codegen.CodeGenerationExcep
tion: java.lang.RuntimeException: java.lang.reflect.InvocationTargetException

Could you pl suggest what am I doing wrong here.

Regards

Yuva
July 25, 2008 at 12:38 PM
Charitha said…
Hi Yuva,
Thanks for your feedback.
Were you able to generate code successfully with wsdl2java.bat tool?
It seems the error is related to your WSDL. if possible, please post your wsdl to uoccharitha@gmail.com

regards
Charitha
July 27, 2008 at 9:32 PM
yuvakumarr said…
Hi Charitha,

thanks for your reply. No, I am not able to generate the code. I will post the wsdl (2 files) to the email id you have given.

thanks for your help.

Regards

Yuva
July 28, 2008 at 9:19 AM
yuvakumarr said…
Hi Charitha,

By mistake, I have specified as 2 wsdl files instead of one file. I have sent one WSDL file.

Regards
yuva
July 28, 2008 at 9:30 AM
Charitha said…
Helo Yuva,
Your wsdl has the following message;
<wsdl:message name="DeleteSoapIn">
<wsdl:part name="entityName" element="tns:entityName" />
<wsdl:part name="id" element="tns:id" /&ht;
</wsdl:message>

As you can see, there are two parts used in this message.
In document style if there are more than one part for the message then
the part to be used should be specified in the binding section.
So, you should modify bindings according to this rule.
e.g:-
<wsdl:input>
<soap:body part="
entityName" use="literal"/>
<soap:header message="tns:DeleteCallerId" part="CallerId" use="literal"/>
</wsdl:input>
July 29, 2008 at 9:24 PM
yuvakumarr said…
Thanks. I will verify / fix the issue. thanks for your help.

Regards

Yuva
July 31, 2008 at 12:06 PM
Anonymous said…
God bless you!I really agree with your opinions.Also,there are some new fashion things here,gillette razor blades.gillette mach3 razor bladesfor men.As for ladies,gillette venus razor blades must the best gift for you in summer,gillette fusion blades are all the best choice for you.
http://gilletterazor.blog.drecom.jp
http://www.getablog.net/ColumbiaJackets
http://crystal888.edublogs.org
http://blog.qlep.com/blog.php/gillette
http://chinaclothes.net
June 16, 2009 at 9:37 PM
Unknown said…
Hello,

I use the org.apache.axis2.tool.ant.AntCodegenTask to produce the server and client side of my service. Everything worked fine with SUN's JDK.

But when I tried to change to IBM's JDK(Java(TM) SE Runtime Environment (build pwi3260sr8fp1-20100624_01(SR8 FP1))) it does not create some of the getters/setters of my objects and build breaks.

Have you ever faced such a problem?

Thanks
February 11, 2011 at 2:20 AM
Post a Comment

Popular posts from this blog

WSO2 Stratos - Introducing WSO2 middleware Platform as a Service (PaaS)

Image
Yesterday we released our newest integrated cloud middleware platform, WSO2 Stratos . It is now online and ready for use! For the past few years, WSO2 has been doing many releases based on revolutionary Carbon platform , which helped to consistently improve the platform with introducing latest state-of-art technologies. The initial releases of Carbon product platform intended to improve the features of the individual products. For example, a lot of core features were introduced to WSO2 ESB, WSAS, Governance Registry etc.. Then we focused on ease of integration and more component based model. We introduced Equinox based provisioning model to build your SOA platform by picking and choosing the components as and when you need. Then, the core product platform has been enhanced to support multi-tenancy. With the multi-tenant supported architecture at hand, our brilliant development team was able to introduce the first ever comprehensive middleware PaaS. Why is this so important? Now, WSO2 C...
Read more

Common mistakes to avoid in WSO2 ESB - 1 - "org.apache.axis2.AxisFault: The system cannot infer the transport information from the URL"

In the next few weeks, you could expect a series of blog posts from me which explain the remedies to avoid some common mistakes which we do when working with WSO2 ESB . This is the first of many. During the initial rounds of testing your integration solution or even in production systems, you may have come across the following error. org.apache.axis2.AxisFault: The system cannot infer the transport information from the URL .... Some of you may have struggled hours figuring out a solution to address this issue. Let me explain this error in detail and possible causes of this. So, next time when you see this error in your WSO2 ESB setup, you will not have to spend time unnecessarily googling everywhere. There can be many different causes of this error. I have observed  four main reasons. Cause 1 This is the simplest cause. Suppose, you have a proxy service similar to the following. <proxy xmlns="http://ws.apache.org/ns/synapse" name="MistakesTest...
Read more

Working with HTTP multipart requests in soapUI

Image
You can use HTTP request test step in soapUI to submit messages with various Content-Types.  In this post, we will have a quick look into the multipart/form-data requests in soapUI. multipart/form-data requests usually come into action when you do HTML form submissions with file attachments. For example, have a look at the following HTML form post. <form action="http://localhost:8090/CKFileUploadApp/UploadServlet" method="post" enctype="multipart/form-data"> <input type="file" name="file"> <input type="text" name="paramName"> <input type="submit" name="Submit" value="Upload File"> </form> In the forms like above, we have file upload option as a form input where we can upload a file along with the form submission. In that case, the request's HTTP content type will be multipart/form-data. How can we simulate such a request using soapUI...
Read more