To access a Web Service through a proxy server, specify the JavaVM properties or the properties specific to the Cosminexus JAX-WS functionality, and set up the proxy server information. The following table describes the properties and their specified contents, when establishing a connection through a proxy server:

Table 10-14 Properties used for connecting through a proxy server

Legend:

Y: Indicates that the specification of the property is required.

O: Indicates that the property is specified as required.

--: Indicates that the property need not be specified.

#1

System properties supported by the JavaVM in the standard manner. For the system properties of JavaVM, see the JavaVM documentation.

#2

The properties are specific to the Cosminexus JAX-WS functionality, and are simple properties. To execute detailed control, we recommend that you perform the implementation using the java.net.Authenticator class of the J2SE 6.0 standard in the Web Service client. For details, see the subsection 10.10(3) When not using properties specific to the JAX-WS functionality.

#3

For connecting through the SSL protocol, see the section 10.11 Connection by SSL protocol.

Set up the properties specific to the Cosminexus JAX-WS functionality in the action definition file. For setting up the action definition files, see the section 10.1 Action definition file. When using the properties specific to the JAX-WS functionality, note the contents described in the subsection 10.10(4) Notes on using properties specific to the JAX-WS functionality.

How to set up the system properties of JavaVM differs depending on the execution of the Web Service client.

• When the Web Service client is executed using commands
  When the Web Service client is executed using commands (cjclstartap), set up the JavaVM property in the user property file for Java application (usrconf.properties) for the cjclstartap command.
  
• When the Web Service client is executed on the J2EE server
  When the Web Service client is executed on the J2EE server, set up the JavaVM property in the user property file for J2EE server (usrconf.properties).
  

The following is an example of property settings:

http.proxyHost=10.209.15.79
http.proxyPort=3128
https.proxyHost=10.209.15.79
https.proxyPort=3128
http.nonProxyHosts=10.209.15.80|www.hitachi.co.jp

There are no rules for the positions to add property settings.

The properties specific to the JAX-WS functionality are the simple properties. Therefore, for executing the detailed control, we recommend that you perform the implementation using the java.net.Authenticator class of the J2SE 6.0 standard with the Web Service client. For details, see the J2SE 6 documentation. The following is an example of the implementation using the java.net.Authenticator class:

java.net.Authenticator.setDefault( new java.net.Authenticator(){
 
  // Override the getPasswordAuthentication method
  public java.net.PasswordAuthentication getPasswordAuthentication() {
 
    // Set the user name
    String userName = ...
  
    // Set the password
    char[] password = ...
    
    // Generate PasswordAuthentication.
    java.net.PasswordAuthentication auth =
        new java.net.PasswordAuthentication( userName, password );
    
    return auth;
  }
} );

With the Cosminexus server, specify the value of the properties specific to the JAX-WS functionality in JavaVM using the setDefault() method of the java.net.Authenticator class of the Java SE standard. Therefore, note the following:

• Valid range
  The properties specific to the JAX-WS functionality are enabled in the entire process in which the Web Service client is operating (or an entire J2EE server if the Web Service client is operating on the J2EE server), and also affects HTTP connections other than the Cosminexus server. If you do not want to apply proxy settings in HTTP connections other than Cosminexus through properties specific to the JAX-WS functionality, you must perform implementation using the setDefault() method of the java.net.Authenticator class in the user program (Web Service client) instead of the property specific to the JAX-WS functionality. For details, see the subsection 10.10(3) When not using properties specific to the JAX-WS functionality.
  
• Conflict
  When using a property specific to the JAX-WS functionality, specify the settings in such a way so that no product other than Cosminexus invokes the setDefault() method of the java.net.Authenticator class, in the process in which the Web Service client is operating. Take special care when using any other product in the library. Depending on the timing of invoking the setDefault() method of the java.net.Authenticator class, the settings might be in conflict and the operation might become invalid. When any other product such as a user program and the library invoke the setDefault() method of the java.net.Authenticator class, do not use properties specific to the JAX-WS functionality.
  
• Security exception
  When the setDefault() method of the java.net.Authenticator class throws java.lang.SecurityException, the message KDJW10025-W is output to a log, and the processing continues. Check the detailed message and remove the cause of the error, as and when required.