+

Search Tips   |   Advanced Search

Configure endpoint URL information for HTTP bindings

Configure a service endpoint to connect JAX-WS and JAX-RPC web services clients to any web services among the components being assembled or to any external web services.

We can develop an HTTP accessible JAX-RPC or JAX-WS web service when we have an existing JavaBeans object to enable as a web service. See using HTTP to transport web services requests information.

Use either the administrative console or property files to configure and manage HTTP endpoint URL fragments.

This task describes using the administrative console to configure endpoint URL information for HTTP bindings.

We can specify HTTP URL prefixes for web services accessed through HTTP using the Provide HTTP endpoint URL information panel in the administrative console. The HTTP URL prefixes provide location specific information and are used to form complete endpoint URLs included within published WSDL files.

The Provide HTTP panel in the administrative console displays modules that contain JAX-WS and JAX-RPC web services. Use the Provide HTTP panel to provide URL information for both types of web services, however, the panel does not indicate which type of service that we are working with.


Configure prefixes with the administrative console

  1. Open the administrative console.

  2. Click Applications > Enterprise Applications > application_instance > Provide HTTP endpoint URL information.

  3. URL prefixes for the web service.

    In this step we specify the protocol (HTTP or HTTPS), as well as the host_name and port_number used in the endpoint URL. We can select a prefix from a predefined list, by selecting the default HTTP URL prefix, or we can use a custom HTTP URL prefix.

    1. Select Default HTTP URL prefix or Custom HTTP URL Prefix.

      If we select the default HTTP URL prefix, a list provides you with a choice of endpoint URL prefixes. The list is a combination of two sets of ports in the module: the virtual host ports and the application server ports. Use a prefix from this list if the application server of the web service is accessed directly. Select a value and also select the check box of the modules to use the prefix.

      To use a custom HTTP URL prefix, type the value in the field. Select the check box to use in the prefix.

      If we configure a custom HTTP URL prefix,, we must also configure the custom JVM property, com.ibm.ws.webservices.enableHTTPPrefix in the administrative console and set the value to true. We must restart the application server after this custom property has been defined so that this property is used by the system. Setting this custom JVM property is required so the custom HTTP endpoint prefix information is correctly displayed in the ?WSDL query that is returned from the browser and the URL field of the WSDL file that is returned to the client. If this custom property is not defined with the value of true, the custom HTTP URL prefix is not reflected in the WSDL file that the service returns to the client. To learn how to configure this custom JVM property, see the documentation on configuring additional HTTP transport properties using the JVM custom property panel in the administrative console.

      The com.ibm.ws.webservices.enableHTTPPrefix custom property applies to JAX-RPC web services applications only.

    2. Click Apply.

      The URL prefix, whether default or custom, is copied to the selected module HTTP URL prefix field.

    3. Click OK. The URL information is saved to your workspace.

We have specified the partial URL information used to form the target endpoint addresses in the WSDL files that are published using the Publish WSDL files panel.


What to do next

Configure any other URL endpoint information for Java Message Service (JMS) bindings and direct EJB access. Then publish the WSDL files to make the deployed web services application available to clients.


Subtopics

  • Use HTTP to transport web services requests for JAX-RPC applications
  • Use HTTP to transport web services requests for JAX-WS applications
  • Configure endpoint URL information for JMS bindings
  • Configure endpoint URL information to directly access enterprise beans
  • Configure additional HTTP transport properties using the JVM custom property panel in the administrative console
  • Work with web services endpoint URL fragment property files
  • HTTP transport custom properties for web services applications
  • Java virtual machine custom properties