You must develop a service endpoint interface if you are developing
a JAX-RPC Web service from a JavaBeans implementation.
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 the 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.
Use the javac commands.
Use the Linux and Unix platforms cited in Developing thin application client code.
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.