Page History

...

Create a Stateless Session EJB Project
- Select File ->New->Project-> New --> Project
- In the popup window, select EJB ->EJB -> EJB Project and then click Next
- Type jaxws-converterejb as the Project Name and click Next..
- The default option should work for Geronimo, so click Next
- Here also default options will work, but the service and wsdl file will be located at the URL specified by the annotations
  
  Tip
  title 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.
- Modify the Group Id to org.apache.geronimo.samples.jaxws and the artifact id to jaxws-converterejb.
- Click Finish

...

Right click on ejbModule and select New ->Package-> Package
Name the package to org.apache.geronimo.samples.jaxws and click Finish
Right click on the new package and select New -->Interface> Interface
Name the interface as Converter and use the org.apache.geronimo.samples.jaxws package, then click Finish

Add the following code to the Converter class:

Code Block

title	Converter.java
borderStyle	solid


package org.apache.geronimo.samples.jaxws;

import java.math.BigDecimal;

import javax.ejb.Remote;
import javax.jws.WebService;

@Remote
@WebService(name = "ConverterPortType",
            targetNamespace = "http://jaxws.samples.geronimo.apache.org")
public interface Converter {

	public BigDecimal dollarToRupees(BigDecimal dollars);

	public BigDecimal rupeesToEuro(BigDecimal rupees);
}

Right click on the new package and select New -->Class> Class
Name the class as ConverterBean and use the org.apache.geronimo.samples.jaxws package, then click Finish

Add the following code to the ConverterBean class:

Code Block

title	ConverterBean.java
borderStyle	solid


package org.apache.geronimo.samples.jaxws;

import java.math.BigDecimal;
import javax.ejb.*;
import javax.jws.WebService;

@Stateless
@WebService(serviceName = "Converter",
            portName = "ConverterPort",
            endpointInterface = "org.apache.geronimo.samples.jaxws.Converter",
            targetNamespace = "http://jaxws.samples.geronimo.apache.org")
public class ConverterBean implements Converter {
	private BigDecimal rupeeRate = new BigDecimal("40.58");
	private BigDecimal euroRate = new BigDecimal("0.018368");

	public BigDecimal dollarToRupees(BigDecimal dollars) {
		BigDecimal result = dollars.multiply(rupeeRate);
		return result.setScale(2, BigDecimal.ROUND_UP);
	}

	public BigDecimal rupeesToEuro(BigDecimal rupees) {
		BigDecimal result = rupees.multiply(euroRate);
		return result.setScale(2, BigDecimal.ROUND_UP);
	}
}

...

Tip

title	Geronimo default location

If you are comfortable with the location that Geronimo deploys the EJB Web Service, you can skip this section and got go to the Deploy and Test Section below.

Expand the META-INF directory present under ejbModule and add the following code to ejb-jar.xml Add the following code to
Tip
title ejb-jar.xml
If ejb-jar.xml is not present, create a XML file and name it as

...

ejb-jar.xml

Code Block

title	ejb-jar.xml
borderStyle	solid


<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd">
	<display-name>jaxws-converterejb</display-name>
	<enterprise-beans>
		<session>
			<ejb-name>jaxws-converterejb</ejb-name>
			<service-endpoint>org.apache.geronimo.samples.jaxws.Converter</service-endpoint>
			<ejb-class>org.apache.geronimo.samples.jaxws.ConverterBean</ejb-class>
			<session-type>Stateless</session-type>
			<transaction-type>Container</transaction-type>
		</session>
	</enterprise-beans>
</ejb-jar>

Also add the following code to the openejb-jar.xml present at the same location.

Code Block

title	openejb-jar.xml
borderStyle	solid


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns4:openejb-jar xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector-1.2"
xmlns:ns2="http://geronimo.apache.org/xml/ns/deployment-1.2" 
xmlns:ns3="http://geronimo.apache.org/xml/ns/naming-1.2" 
xmlns:ns4="http://openejb.apache.org/xml/ns/openejb-jar-2.2" 
xmlns:ns5="http://openejb.apache.org/xml/ns/pkgen-2.1" 
xmlns:ns6="http://geronimo.apache.org/xml/ns/j2ee/application-2.0" 
xmlns:ns7="http://geronimo.apache.org/xml/ns/security-2.0" 
xmlns:ns8="http://geronimo.apache.org/xml/ns/j2ee/web-2.0.1" 
xmlns:ns9="http://java.sun.com/xml/ns/persistence" 
xmlns:ns10="http://geronimo.apache.org/xml/ns/j2ee/application-client-2.0">
    <ns2:environment>
        <ns2:moduleId>
            <ns2:groupId>org.apache.geronimo.samples.jaxws</ns2:groupId>
            <ns2:artifactId>jaxws-converterejb</ns2:artifactId>
            <ns2:version>1.0</ns2:version>
            <ns2:type>car</ns2:type>
        </ns2:moduleId>
    </ns2:environment>
    <ns4:enterprise-beans>
    	<ns4:session>
			<ns4:ejb-name>jaxws-converterejb</ns4:ejb-name>
			<ns4:web-service-address>ADD_CUSTOM_URL</ns4:web-service-address>
		</ns4:session>
	</ns4:enterprise-beans> 
</ns4:openejb-jar>

...

Right click on the Apache Geronimo Server Runtime present in the servers view and select Add or Remove Projects
In the popup dialog, select the jaxws-converterejb project and click Add
Make sure that jaxws-converterconverterejb is in the configured projects list and then click Finish
Wait for some time till the server status is changed to synchronized.
Info
title Errors at Deploy time
If you see any errors at deploy time like Unable to read WSDL file null, simply ignore them.

...

Once the application is deployed on to the server, Launch a browser and go to the following url.:

http://localhost:8080/Converter/ConverterPortType

Tip
title Custom location
If you have followed the steps to deploy the service onto custom location, go to the url http://localhost:8080/CUSTOM_URL^{Image Modified}

Now you should see the screen telling that service is located at the following URL:

Tip

title	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

Child pages

Versions Compared

Old Version 6

New Version 7

Key