Constructing URLs

In this manual, the URL path to a specific WSA instance is referred to as wsa-root-url. When you install the WSA, the installation procedure prompts you for a wsa-root-url value for the sample WSA instance (wsa1). Thereafter, every time you create a new WSA instance you must provide a new wsa-root-url value for that instance. The value is stored in the wsaUrl property in ubroker.properties.

Table 13. Syntax
http[s]://host:port[/web-server-context]/wsa-webapp-context/wsa-instance

Note: If the WSA URL host is named localhost, it must be changed to the name of the host machine when Web services are deployed for network access.

In the previous syntax, use the optional element, /web-server-context, if the WSA runs in a Java container that runs in a separate Web server. Omit the optional element if the WSA runs in a Java container that runs stand-alone.

In order to create a WSA instance, you need to construct the URL for the wsa-root-url. The URL components in the syntaxes each describe a specific part of the WSA instance configuration, as shown in the following table.

Table 14. URL components
This URL component . . .	Which is specified in . . .	Names . . .
web-server-context	The Web server configuration file	The connection between the Java container and the Web server (if any)
wsa-webapp-context	The Java container configuration file	A particular Web application within the Java container context
wsa-instance	The WSA Web application descriptor file	A unique WSA instance

Typically, web-server-context, wsa-webapp-context, and wsa-instance are assigned aliases (actual values) by providers—the people who are responsible for the hardware and software in the OpenEdge WSA environment. Aliases typically do not consist of physical names related to the system or to file paths, but rather names meaningful to providers.

For example, consider the sample Web service system elements and aliases in the following table.

Table 15. Sample aliases for URL components
URL component	Sample alias
web-server-context	bedrock
wsa-webapp-context	quarry
wsa-instance	fred

The WSA running in the context of the Java container running in the context of a separate Web server has the following URL:

http://servicehost:80/bedrock/quarry/fred

The WSA running in the context of the Java container running stand-alone has the following URL:

http://servicehost:8080/quarry/fred

Any URL subpaths specified by the client that lie beyond wsa-root-url are delivered to the WSA instance for it to interpret and use. For example, to access the WSDL documents associated with a particular WSA instance, append the /wsdl subpath to wsa-root-url, as shown in bold:

http://servicehost:80/bedrock/quarry/fred/wsdl

Given this URL, an HTTP message travels through the Web server, through the Java container, then to the WSA instance, fred. Then, the WSA instance is passed the relative path, /wsdl, which tells it to perform a WSDL-related operation.