Movatterモバイル変換

A Web Service Example:`helloservice`

This example demonstrates a simple web service that generates a response based oninformation received from the client.HelloServiceBean is a stateless session bean thatimplements a single method,sayHello. This method matches thesayHello method invoked bythe client described inA Simple JAX-WS Client.

The Web Service Endpoint Implementation Class

HelloServiceBean is the endpoint implementation class. The endpoint implementation class is typically the primaryprogramming artifact for enterprise bean web service endpoints. The web service endpoint implementationclass has the following requirements:

The class must be annotated with either thejavax.jws.WebService orjavax.jws.WebServiceProvider annotations.
The implementing class may explicitly reference an SEI through theendpointInterface element of the@WebService annotation, but is not required to do so. If noendpointInterface is specified in@WebService, an SEI is implicitly defined for the implementing class.
The business methods of the implementing class must be public, and must not be declaredstatic orfinal.
Business methods that are exposed to web service clients must be annotated withjavax.jws.WebMethod.
Business methods that are exposed to web service clients must have JAXB-compatible parameters and return types. SeeDefault Data Type Bindings.
The implementing class must not be declaredfinal and must not beabstract.
The implementing class must have a default public constructor.
The endpoint class must be annotated@Stateless.
The implementing class must not define thefinalize method.
The implementing class may use thejavax.annotation.PostConstruct orjavax.annotation.PreDestroy annotations on its methods for life-cycle event callbacks.
The@PostConstruct method is called by the container before the implementing class begins responding to web service clients.
The@PreDestroy method is called by the container before the endpoint is removed from operation.

Stateless Session Bean Implementation Class

TheHelloServiceBean class implements thesayHello method, which is annotated@WebMethod. The sourcecode for theHelloServiceBean class follows:

package com.sun.tutorial.javaee.ejb;import javax.ejb.Stateless;import javax.jws.WebMethod;import javax.jws.WebService;@Stateless@WebServicepublic class HelloServiceBean {    private String message = "Hello, ";    public void HelloServiceBean() {}    @WebMethod    public String sayHello(String name) {        return message + name + ".";    }}

Building, Packaging, Deploying, and Testing the`helloservice` Example

You can build, package, and deploy thehelloservice example using either NetBeans IDEor Ant. You can then use the Admin Console to test the webservice endpoint methods.

Building, Packaging, and Deploying the`helloservice` Example Using NetBeans IDE

Follow these instructions to build, package, and deploy thehelloservice example toyour Application Server instance using NetBeans IDE.

In NetBeans IDE, select File→Open Project.
In the Open Project dialog, navigate totut-install/javaeetutorial5/examples/ejb/.
Select thehelloservice folder.
Select the Open as Main Project and Open Required Projects check boxes.
Click Open Project.
In the Projects tab, right-click thehelloservice project and select Undeploy and Deploy.

This builds and packages to application intohelloservice.ear, located intut-install/javaeetutorial5/examples/ejb/helloservice/dist, and deploys thisear file to your Application Server instance.

Building, Packaging, and Deploying the`helloservice` Example Using Ant

Follow these instructions to build, package, and deploy thehelloservice example toyour Application Server instance using Ant.

In a terminal window, go to thetut-install/javaeetutorial5/examples/ejb/helloservice/ directory.
To buildhelloservice, type the following command:
```
ant
```
This runs thedefault task, which compiles the source files and packages the application into a JAR file located attut-install/examples/ejb/helloservice/dist/helloservice.jar.
To deployhelloservice, type the following command:
```
ant deploy
```
Upon deployment, the Application Server generates additional artifacts required for web service invocation, including the WSDL file.

Testing the Service without a Client

The Application Server Admin Console allows you to test the methods ofa web service endpoint. To test thesayHello method ofHelloServiceBean, do thefollowing:

Open the Admin Console by opening the following URL in a web browser:
```
http://localhost:4848/
```
Enter the admin username and password to log in to the Admin Console.
Click Web Services in the left pane of the Admin Console.
Clickhelloservice.
Click Test.
Under Methods, enter a name as the parameter to thesayHello method.
Click thesayHello button.
This will take you to thesayHello Method invocation page.
Under Method returned, you’ll see the response from the endpoint.

Movatterモバイル変換

The Java EE 5 Tutorial

A Web Service Example:helloservice