You must develop a service endpoint interface if you are
developing a JAX-RPC Web service from a JavaBeans™ implementation.
Before you begin
You need to set up a development environment for Web services
and access an existing Java™ bean
Web archive (WAR) file. See the setting up a development environment
for Web services information.
About this task
This task is a required step in developing a JAX-RPC Web
service from a Java bean.
The service endpoint
interface defines the methods for particular Java API
for XML-based RPC (JAX-RPC) Web services. The JavaBeans implementation
must implement methods with the same signature as the methods on the
service endpoint interface. A number of restrictions apply on which
types to use as parameters and results of service endpoint interface
methods. These restrictions are documented in the JAX-RPC specification.
You
can also create a service endpoint interface by using assembly tools.
Develop
a service endpoint interface for a JavaBeans implementation
by following the actions listed:
Procedure
- Create a Java interface
that contains the methods to include in the service endpoint interface.
If you start with an existing Java interface,
remove any methods that do not conform to the JAX-RPC specification.
- Compile the interface.
Use the name of the
service endpoint interface class in the javac command for the
class to compile.
Ensure the j2ee.jar file
is in your class path to compile the interface. The JAR file is located
in the app_server_root/dev/JavaEE directory path.
Results
You have developed a service endpoint interface that you can
use to develop Web services.
Example
The following example depicts the AddressBook interface:
package addr;
public interface AddressBook {
/**
* Retrieve an entry from the AddressBook.
*
*@param name the name of the entry to look up.
*@return the AddressBook entry matching name or null if none.
*@throws java.rmi.RemoteException if communications failure.
*/
public addr.Address getAddressFromName(java.lang.String name);
}
Use the AddressBook interface to create the service
endpoint interface:
- Make a copy of the AddressBook.java interface and name it AddressBook_SEI.java.
Use this copy as a template for the service endpoint interface.
- Compile the interface.
What to do next
Continue to gather the artifacts that are required to develop
a Web service, including the Web Services Description Language (WSDL)
file. You need to develop a WSDL file because it is the engine of
a Web service. Without a WSDL file, you do not have a Web service.
See the developing a WSDL file for JAX-RPC applications information.