|Home > Documentation > Developing > Tutorials > Developing Web services > Developing a JAX-WS EJB Stateless Session Bean Web Service|
This tutorial will take you through the steps required in developing, deploying and testing a EJB Stateless Session Bean Web Service in Apache Geronimo. After completing this tutorial you should be able to understand how to develop simple JAX-WS compliant EJB web services in Apache Geronimo using Eclipse development environment.
It is highly recommended that you go through the Developing a JAX-WS POJO Web Service tutorial before jumping into this. We will be using the same sample from the tutorial to develop a EJB Web Service.
Client development is excluded from this tutorial because there is no difference in creating a client for EJB Stateless Session Bean Web Service and a POJO Web Service.
You can refer to Developing a JAX-WS POJO Web Service tutorial for further knowledge about how to develop a client for Web Services.
To run this tutorial, as a minimum you will be required to have installed the following prerequisite software.
Geronimo version 2.1.x, Java 1.5 runtime, and Eclipse Ganymede are used is used in this tutorial but other versions can be used instead (e.g., Geronimo version 2.2, Java 1.6, Eclipse Europa)
Details on installing eclipse are provided in the Development environment section. This tutorial will take you through the following steps:
Changing Service Location
If you want to change the service location to any custom URL you want, make sure that the check box Generate Deployment Descriptor is selected.
This completes the configuration of Eclipse for application development.
To deploy the Converter EJB Service, we are going to create a remote interface and a stateless session bean that implements the interface. The steps required are as follows:
A little observation
If you have already gone through the Developing a JAX-WS POJO Web Service tutorial, you might have observed that there's not much difference between an EJB Web Service and POJO Web Service except for the EJB specific annotations.
This completes the development of the Web Service Implementation code.
Geronimo default location
If you are comfortable with the location that Geronimo deploys the EJB Web Service, you can skip this section and go to the Deploy and Test Section below.
If ejb-jar.xml is not present, create a XML file and name it as ejb-jar.xml
This completes the setting up of Deployment descriptor and Deployment Plan.
Now, we will look into the steps involved in deploying and testing our web service without any clients.
Errors at Deploy time
If you see any errors at deploy time like Unable to read WSDL file null, simply ignore them.
If you have followed the steps to deploy the service onto custom location, go to the url http://localhost:8080/CUSTOM_URL
Using Web Service Explorer in Eclipse
You can also use Web Services Explorer present in Eclipse to rapidly test your web service without developing a client.
To know how to use Web Services Explorer in Eclipse, one can refer to the Developing a JAX-WS POJO Web Service#Using Web Services Explorer in Eclipse