Implementing web services applications from existing WSDL files with JAX-RPC

You can develop a web service with an existing Web Services Description Language (WSDL) file using the Java™ API for XML-based RPC (JAX-RPC) programming model.

Before you begin

最佳作法 最佳作法: IBM® WebSphere® Application Server 支援 Java API for XML 型 Web 服務 (JAX-WS) 程式設計模型和 Java API for XML 型 RPC (JAX-RPC) 程式設計模型。JAX-WS 是延伸 JAX-RPC 程式設計模型所提供之基礎的下一代 Web 服務程式設計模型。 當使用策略性 JAX-WS 程式設計模型時,透過支援標準型註釋模型,簡化了 Web 服務和用戶端的開發工作。 雖然仍支援 JAX-RPC 程式設計模型和應用程式,但請利用易於實作的 JAX-WS 程式設計模型來開發新的 Web 服務應用程式和用戶端。best-practices

Locate the WSDL file that defines the web service that you want to implement. You can develop a WSDL or obtain one from an existing web service through email, downloading or a Uniform Resource Locator (URL).

About this task

To develop web services based on the JAX-RPC programming model, you can use a bottom-up development approach starting from existing JavaBeans or enterprise beans or you can use a top-down development approach starting with an existing Web Services Description Language (WSDL) file. This task describes the steps when using the top-down development approach.

When developing a JAX-RPC web service starting from an existing WSDL file, create the JavaBeans or enterprise bean and artifacts that enable the bean as web services and assemble all artifacts that are required for the web service, and deploy the application onto the application server.

Considerations when using JavaBeans

JavaBeans exposed as JAX-RPC web services are supported only over an HTTP transport.

Considerations when using enterprise beans
  • The enterprise bean must be a stateless session bean.
  • Enterprise beans that are exposed as JAX-RPC web services must be packaged in EJB 2.1 or in EJB 3.0 or higher modules.
  • For JAX-RPC web services using EJB 2.1 style endpoints, the Web service method parameters must be one of the supported JAX-RPC types. These requirements are documented in the JAX-RPC specification.
  • JAX-RPC web services using enterprise beans are supported over an HTTP or Java Message Service (JMS) transport.
最佳作法 最佳作法: It is a best practice to use EJB 2.1 style enterprise beans with JAX-RPC applications. bprac

Procedure

  1. Set up a development environment for web services. You do not have to set up a development environment if you are using Rational® Application Developer.
  2. Develop the Java artifacts from a WSDL file. You need to create the deployment descriptor templates and bindings that are configured to map the service implementation to the JavaBeans or enterprise beans implementation.
  3. Complete the implementation of your web service application.
  4. Configure the webservices.xml deployment descriptor. For JAX-RPC web services, configure the webservices.xml deployment descriptor so that the application server can process the incoming web services requests.
  5. Configure the ibm-webservices-bnd.xmi deployment descriptor. Configure the ibm-webservices-bnd.xml deployment descriptor so that the application server can process the incoming web services requests.
  6. Assemble the artifacts for your web service.

    Use assembly tools provided with the application server to assemble your Java-based web services modules.

    If you have assembled an Enterprise Archive (EAR) file that contains enterprise beans modules that contain Web services, use the endptEnabler command-line tool or an assembly tool before deployment to produce a web services endpoint WAR file. This tool is also used to specify whether the web services are exposed using SOAP over Java Message Service (JMS) or SOAP over HTTP.

  7. Deploy the EAR file into the application server. You can now deploy the EAR file that has been configured and enabled for JAX-RPC web services onto the application server.

Results

You have developed a JAX-RPC web service application by starting with an existing WSDL file.

What to do next

After you deploy the EAR file, test the web service to make sure that it works with the application server.


指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: July 9, 2016 11:18
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_devwbsjaxrpcwsdl
檔名:twbs_devwbsjaxrpcwsdl.html