Show TOC

Mappings for Host and PortLocate 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: /foo/bar/ExampleService/Example?wsdl

The system generates the first part of external endpoint and WSDL URL using the available mappings as described below. The external URLs are included in WSDL and WSIL outputs.

Use

WSDL URL Queried via HTTP(S)

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

  • If there is no WS HTTP Mapping for the host and there is no Global HTTP Mapping for the port, then the first part of the external WSDL URL is the same as the first part of internal WSDL URL.

  • If there is WS HTTP Mapping for the host, 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]

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

Endpoint URL queries via HTTP(S)

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

  • If there is no WS HTTP Mapping for the host, there is no Global HTTP Mapping for the port, and there is no other Global HTTP Mapping, then the first part of the external endpoint URL is the same as the first part of internal endpoint URL.

  • If there is WS HTTP Mapping for the host, then the first part of the external endpoint 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]

  • If there is no WS HTTP Mapping for the host and there is Global HTTP Mapping for the port, then the first part of the external endpoint URL contains the values for virtual host and port in the Global HTTP Mapping. The generated URL is in the following format: http(s)://[global_virtual_host]:[global_virtual_port]

  • If there is no WS HTTP Mapping for the host, there is no Global HTTP Mapping for the port, 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 in the Global HTTP Mapping. The generated URL is in the following format: http(s)://[global_virtual_host]:[global_virtual_port]