Configuring a service endpoint is necessary to connect Web service
clients to any Web services among the components being assembled or to any
external Web services.
Before you begin
You can develop an HTTP accessible Java API for XML-based remote procedure
call (JAX-RPC) or Java API for XML Web Services (JAX-WS) Web service when
you already have a JavaBean object to enable as a Web service. For additional
information, see the using HTTP to transport Web services requests documentation.
About this task
You can specify HTTP URL prefixes for Web services that are accessed
through HTTP by 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 that are included within published
WSDL files.
To configure these
prefixes with the administrative console:
Procedure
- Open the administrative console.
- Click Applications > Enterprise Applications > application_instance > Provide
HTTP endpoint URL information.
- Specify the URL prefixes for the Web service.
In
this step you specify the protocol (HTTP or HTTPS), as well as the host_name and port_number used
in the endpoint URL. You can select a prefix from a predefined list, by selecting
the default HTTP URL prefix, or you can use a custom HTTP URL prefix.
- Select Default HTTP URL prefix or Custom HTTP URL
Prefix.
If you 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.
If you want to use a custom HTTP
URL prefix, type the value in the field. Select the check box to use in the
prefix.
If you configure a custom HTTP URL prefix, , you must also configure
the custom JVM property, com.ibm.ws.webservices.enableHTTPPrefix in
the administrative console and set the value to true. You
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.
- Click Apply.
The URL prefix, whether default
or custom, is copied to the selected module HTTP URL prefix field.
- Click OK. The URL information is saved to
your workspace.
Results
You have specified the partial URL information that is 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 Enterprise JavaBeans (EJB) access. Then publish
the WSDL files to make the deployed Web services application available to
clients.