Show TOC

Mappings for URL Published in Services RegistryLocate this document in the navigation structure

Definition

To describe how the system generates external URLs for Web services, we can assume that a URL has two main parts:

  • The first part contains the URI scheme, the host name, and the port used.

  • The second part contains the path to the resource and optional parameters.

Example

We have the following WSDL URL: http://service.example.com:50000/ExampleService/Example?wsdl

  • The first part is: http://service.example.com:50000

  • The second part is: /ExampleService/Example?wsdl

The system generates the first part of external endpoint and WSDL URL published in Services Registry using the available mappings as described below.

Use

WSDL URL Published in Services Registry

Depending on the available mappings, the system generates external URL for Web services published in Services Registry in one of the following ways:

  • If there is WS HTTP Mapping marked as Services Registry publication relevant, then the first part of the external WSDL URL contains the values for virtual host and HTTP(S) port in the WS HTTP Mapping. The generated URL is in the following format: http(s)://[ws_virtual_host]:[ws_virtual_http(s)_port]

    The HTTPS variant applies only if the HTTPS transport protocol customization is chosen for the marked WS HTTP Mapping. In all other cases the valid variant is HTTP.

  • If there is no WS HTTP Mapping marked as Services Registry publication relevant and there is at least one Global HTTP Mapping, then the first part of the external WSDL URL contains the values for virtual host and port of the first found Global HTTP Mapping. The generated URL is in the following format: http(s)://[global_virtual_host]:[global_virtual_port]

    The transport protocol type of the Global HTTP Mapping determines whether the HTTP or HTTPS variant will be used.

  • If there is no WS HTTP Mapping marked as Services Registry publication relevant and there is no Global HTTP Mapping, then the first part of external WSDL URL is the same as the first part of the internal WSDL URL.

Endpoint URL Published in Services Registry

Depending on the available mappings, the system generates an external URL for Web service endpoints published in Services Registry in one of the following ways:

  • If there is WS HTTP Mapping marked as Services Registry publication relevant, then the first part of the external endpoint URL contains the values for the virtual host and HTTP(S) port in the WS HTTP Mapping. The generated URL is in the following format: http(s)://[ws_virtual_host]:[ws_virtual_http(s)_port]

  • If there is no WS HTTP Mapping marked as Services Registry publication relevant and there is at least one Global HTTP Mapping, then the first part of the external endpoint URL contains the values for virtual host and port of the first Global HTTP Mapping that is found. The generated URL is in the following format: http(s)://[global_virtual_host]:[global_virtual_port]

  • If there is no WS HTTP Mapping marked as Services Registry publication relevant and there is no Global HTTP Mapping, then the first part of external endpoint URL is the same as the first part of the internal endpoint URL.