Web services client to web container optimized communication
To improve performance, there is an optimized communication path between a web services client application and a web container that are located in the same application server process. Requests from the web services client that are normally sent to the web container using a network connection are delivered directly to the web container using an optimized local path. The local path is available because the web services client application and the web container are running in the same process.
This direct communication eliminates the need for clients and web containers that are in the same process to communicate over the network. For example, a web services client might be running in an application server. Instead of accessing the network to communicate with the web container, the web services client can communicate with the web container using the optimized local path. This optimized local path improves the performance of the application server by enabling web services clients and web containers to communicate without using network transports.
In a clustered environment, there is typically an HTTP server (such as IBM® HTTP server) that handles incoming client requests, distributing them to the correct application server in the cluster. The HTTP server uses information about the requested application and the defined virtual hosts to determine which application server receives the request. The web services client also uses the defined virtual host information to determine whether the request can be served by the local web container. You must define unique values for the host and port on each application server. You cannot define the values of host and port as wildcards denoted by the asterisk symbol (*) when you enable the optimized communication between the web services application and the web container. Using wildcards indicate that the local web container can handle web services requests for all destinations.
The optimized local communication path is disabled by default. You can enable the local communication path with the enableInProcessConnections custom property. Before you configure this custom property, make sure that you are not using wildcards for host names in your web container end points. Set this property to true in the web container to enabled the optimized local communication path. When disabled, the web services client and the web container communicate by using network transports. The custom property applies for JAX-RPC and JAX-WS scenarios, but not for JAX-RS scenarios.
For information about how to configure the enableInProcessConnections custom property, see the web container custom properties information.
When the optimized local communication path is enabled, logging of requests through the local path uses the same log attributes as the network channel chain for the web container. To use a different log file for in process requests than the log file for network requests, use a custom property on the HTTP Inbound Channel in the transport chain. Use the localLogFilenamePrefix custom property to specify a string that is added to the beginning of the network log file name to create a file name that is unique. Requests through the local process path are logged to this specified file. For example, if the log filename is ../httpaccess.log for a network chain, and the localLogFilenamePrefix custom property is set to local on the HTTP channel in that transport chain, the local log file name for requests to the host associated with that chain is /localhttpaccess.log.