Class SolarQueryUrlHelper

Constructor.

Get the environment configuration.

Get a parameters object that can be used to hold URL variables.

Get a new configured with parameters of this instance.

This will look for the following parameters:

• nodeIds
• sourceIds

Get or set an environment parameter.

This is a shortcut for calling Util.Configuration#value on the environment object.

Get a URL for just the SolarNet host, without any path to be used for actual requests.

Calls the toRequestUrl() with hostUrl() as the argument.

Get a URL for just the SolarNet host, without any path.

This method constructs an absolute URL based on the following properties configured on this instance's Net.Environment:

1. If environment.useTls() returns true then use HTTPS as the protocol, otherwise HTTP.
2. Use host for the host name or IP address.
3. Use port for the port if available and not the standard 443 for HTTPS or 80 for HTTP.

Get a URL for just the SolarNet host using the WebSocket protocol, without any path.

This method constructs an absolute URL based on the following properties configured on this instance's Net.Environment:

1. If environment.useTls() returns true then use WSS as the protocol, otherwise WS.
2. Use host for the host name or IP address.
3. Use port for the port if available and not the standard 443 for WSS or 80 for WS.

Get a parameter, with plural suffix array support.

This method will first look for a parameter named exactly key, and if found return that. Otherwise it will look for an array parameter named key with s appended, and if found return the first element from that array. For example:

const helper = new UrlHelper();
helper.parameter('nodeIds', [1, 2, 3]);

helper.param('nodeIds'); // [1, 2, 3]
helper.param('nodeId');  // 1
Copy

If key already ends in s, then a desired array result is assumed. If a value is not found for the parameter, then s is removed from key and that parameter value is returned, as an array if it is not already. For example:

const helper = new UrlHelper();
helper.parameter('nodeId', 1);

helper.param('nodeIds'); // [1]
helper.param('nodeId');  // 1
Copy

Get or set a parameter.

This is a shortcut for calling Util.Configuration#value on the parameters object.

Replace occurances of URL template variables with values from the parameters property and append to the host URL.

This method provides a way to resolve an absolute URL based on the configured environment and parameters on this object.

See

Net.UrlHelper#resolveTemplateUrl

Replace occurances of URL template variables with values from the parameters property.

URL template variables are specified as {<em>name</em>}. The variable will be replaced by the value associated with property name in the parameters object. The value will be URI encoded.

Get the URL to actually request, incorporating the environment's proxyUrlPrefix if available.

If a environment.proxyUrlPrefix value is configured, this will re-write the URL to use that host prefix, otherwise url will be returned unchanged.

Replace occurances of URL template variables with values from a parameter object.

URL template variables are specified as {<em>name</em>}. The variable will be replaced by the value associated with property name in the provided parameter object. The value will be URI encoded.

Any occurances of // after replacing template variables will be reduced to /.