This task explains how to develop a service endpoint interface if you are developing a Web service from a JavaBeans implementation.
Before you begin
You need to set up a Web services development and unmanaged client run-time environment and access an existing Java bean Web archive (WAR) file.Why and when to perform this task
This task is a required step in developing a Web service from a Java bean.
The service endpoint interface defines the methods for particular 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 Java API for XML-based remote procedure call (JAX-RPC) specification, which is available through Web services: Resources for learning.
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:Steps for this task
Result
You have developed a service endpoint interface that you can use to develop Web services.Example
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); }
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.Related tasks
Developing a Web service from a Java bean
Related reference
Artifacts used to develop Web services