uCosminexus Application Server, Web Service Development Guide
You can connect a Web resource client to a Web resource present in an external environment through a proxy server.
This section describes the settings of the properties required for connecting to an external environment through a proxy server.
To access a Web resource through a proxy server, specify the properties of JavaVM and information of the proxy server. The following table describes the JavaVM properties and contents to be specified for connecting through a proxy server. For details on the system properties of JavaVM, see the JavaVM documentation.
Table 13-5 The JavaVM properties for connecting through a proxy server
| No. | JavaVM property | Specified content | Without SSL | With SSL |
|---|---|---|---|---|
| 1 | http.proxyHost | Specify the host name or the IP address of a proxy server. If you do not specify any value, connection with the proxy server is not established. |
Y | N |
| 2 | http.proxyPort | Specify the port number of a proxy server. When http.proxyHost is appropriately specified, port number 80 of the host specified in http.proxyHost is accessed if you do not specify any value in http.proxyPort. When you do not specify any value in http.proxyHost, connection with the proxy server is not established even if http.proxyPort is specified. |
S | N |
| 3 | https.proxyHost | Specify the host name or the IP address of a proxy server to be used in connections by the SSL protocol#. You must specify the host name or the IP address to use a proxy server in connections by the SSL protocol. Note that if you do not specify the host name or the IP address, connection with the proxy server is not established. |
N | Y |
| 4 | https.proxyPort | Specify the port number of a proxy server to be used in connections by the SSL protocol#. Note that when https.proxyHost is appropriately specified, the port number 443 of the host specified in https.proxyHost is accessed, if you do not specify any value in https.proxyPort. If you do not specify any value in https.proxyHost, connection with the proxy server is not established even if https.proxyPort is specified. |
N | S |
| 5 | http.nonProxyHosts | Specify, as and when required, the host names that are not required for using a proxy server. When connecting with the host specified by using this property, connection is not established through the proxy server specified in http.proxyHost or https.proxyHost. When specifying multiple hosts, use the separator (|). You cannot use any character (such as space) other than (|) for separating the two host names. |
S | S |
For details on setting the system properties of JavaVM, see 10.10(2) How to set the properties.
When accessing a Web resource through a non-anonymous proxy server, we recommend that you establish a connection by using the java.net.Authenticator class of the J2SE 6.0 standard in the Web resource client. For details, see the J2SE 6 documentation.
For examples of establishing a connection by using the java.net.Authenticator class, see 10.10(3) When not using properties specific to the JAX-WS functionality.
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.