Skip to main content

Creating a JAX-WS Web Service and Client using Eclipse Indigo

Creating a JAX-WS Web Service and corresponding client is a very trivial task. However I faced various problems while doing the same mainly while creating a client for the web service. This was mainly because the contents I found on the Internet were in a distributed manner. So I thought of creating a tutorial which binds all the concepts at one place.

So this tutorial does not teaches indepth concepts of web services. Instead it guides as how to create a Web Service and a seperate client.

Software Requirements:
1. Eclipse Indigo.

Note: To download Eclipse Indigo follow the link Then select 'Eclipse IDE for Java EE Developers'.

We will proceed with the creation of web service and client in following two steps:
1. Creating Web Service
2. Creating client to consume web service.

1. Creating Web Service:
Creating of a JAX-WS web service is not a very tough task. We simply create a class(normal Java class) and define certain methods in the class, rest of the work is done by Eclipse IDE, which converts this Java class in to a web service.

Now we will create a class "" that will be later converted to a web service.
a. Select 'File->New->Dynamic Web Project'.
b. In the window displayed below enter Project Name as MyService and press Next.

d. Now press Next then Finish.
e. MyService project will be displayed in the project explorer as displayed below:

f. Under the src folder add a package servicePkg.
g. Under the servicePkg add a class
h. The project structure will be as shown below:
i. Add following code to class

Now we are done with creating our class. This simple class will act as the base of our web service.

Converting a Java Class to web service:
Now we will convert the created above into a web service.:

a. Select 'File-> New -> Other...'
b. In the wizard mentioned below select Web Services -> Web Service
Click Next

c. Following page will appear.
d. Under Configuration section select hyperlink Service project: MyService (under this hyperlink we will define the project that is to be converted to a web service. Initially some garbage project may be displayed, we need to convert it to MyService). Following window will appear:

e. Under 'Service Project' select our project MyService and press OK.
f. Press Next again Next. Following window will appear:
press Start server, wait till server starts. After server starts click Next then Finish.

g. Check the structure of project under 'Project Explorer' section. Under WebContent a folder wsdl is created that contains a file named MyService.wsdl (this MyService.wsdl file will be used later to create client).

Now we are done creating out web service

2. Creating Client:
Client creation is again a simple task. Client is a simple java class that calls the methods of web service, but client is not aware that the methods it is calling are executed at some other location. To client it seems that the methods are executed locally. In order to do so there is need of some proxy and stub class. But it is not our burden as these things are done automatically by Eclipse IDE.

Steps to create Client:
a. Select 'File -> New -> Project'
b. On the Select a wizard window select Java Project

c. Select Next. On Create a Java Project enter project name as MyClient

d. Select Next then Finish
e. Select File -> New -> Other
f. On Select a Wizard window select Web Services -> Web Service Client
click Next
g.  On Web Services window select Browse
h.  Again select Browse
i. Select MyService.wsdl under project MyService
select OK
j. Again select OK
k. Again on Web Services  window select hyperlink Client project: MyClient (This option is used to declare as to which project is used as client for the web service.)
select MyClient under client project dropdown and press OK

l. Select Next then Finish
m. Check the structure of MyClient project under Project Explorer section. All the necessary stub and proxy classes are added to the client.

o. Now we need to create a class that calls the service methods. Add clientPkg under src folder.
p. Add class under clientPkg

q. Add following code to

now our client creation is complete.
To run client right click project MyClient and select RunAs -> 3 Java Application
You will see the output Hello - message from client


  1. Replies
    1. @THE PRINCE: Thanks for your feedback... :)

  2. This comment has been removed by the author.

    1. This is great. Your tutorial helped me a lot!!!

    2. @Jash: Thanx for your feedback...I am glad it helped you :)


Post a Comment

Popular posts from this blog

Using R Programming Language inside Java


This tutorial walks you through using R programming language inside a java program. R is a powerful programming language for Machine Learning and Data Mining. It contains implementation of various Machine Learning algorithms. Recently i had a situation where i was supposed to use these machine learning algorithms inside my java program. I searched the web but the stuff i found was not of much help. Thus i thought of putting the same in the form of this tutorial.

This tutorial is not intended to teach you R language. It is only to help you integrate R to Java and then to use R functions inside a Java program.

Following things are needed to be pre-configured on your system to use R in Java program:

1. R workbench: R has got a console known as RGui where R commands/programs could be executed. To install RGui simply go to and download the 'Download R 3.0.2 for Windows(52 megabytes, 32/64 bit)'. Simply double click the e…

Accessing R script from Java

R is powerful language for statistical analysis and Machine Learning. Java is best suited to develop enterprise applications. Integrating both could lead to developing powerful analytic applications. In this tutorial we are going to call a R script from java, then pass the parameters from java to R and fetch back the results from R to Java.

Problem Statement: In this tutorial we have a csv file 'data.csv' having 4 columns and we need to calculate mean of few user defined columns. To calculate the mean we will be using and then we will pass the calculated mean back to Java.

 1. You should know how to integrate R with Java. For that you could consult the tutorial

Code Files:
We will be needing following files:
1. data.csv: file having data that will be used in R script.
2. config.R: this file contains the configuration (vector having column index) to be used in 'test.R'.

Uploading a binary file to RESTful web service in java using Jersey


Recently I had a situation where I was supposed to upload a binary file to a server side RESTful web service created in Jersey. I faced a lot of trouble in doing so because always one or the other part of the hood was not working properly. The following post gives a step by step process as how to create a RESTful service that accepts uploaded binary files.

1. A running RESTful service based on Jersey.
2. An HTML page with file upload component.
3. Tomcat 7 as web server.
4. Eclipse indigo.

Note: Let us suppose that tomcat is running on same machine on which the HTML client is present. So we will be using the base domain URL as 'http://localhost:8080/'. If your service and client are located on different instances of tomcat then replace the localhost part of the URL with the IP address of the machine on which the REST service is running.

Step 1 (Eclipse setup):
a. Create a 'Dynamic Web Project' in eclipse indigo. Let us say that this project is named …