The transient JadeTcpIpProxy class implements TCP/IP network proxy support that enables you to open a TCP/IP network connection through a proxy server.
Asynchronous connection operations are executed on another thread. If this asynchronous worker thread needs to access JADE objects (for example, TcpIpConnection and JadeTcpIpProxy objects), these objects need to be shared transient or persistent objects.
If you cannot establish a direct TCP/IP connection because of physical network layouts or restrictions (for example, the use of a firewall), you may have to establish a connection through a proxy server by using the functionality provided by the JadeTcpIpProxy class.
You can use proxies as part of a firewall solution, as they sit between the client application and the server application, and may not permit the client to connect directly to the server. The client is required to connect to the proxy and asks the proxy to connect to the server on behalf of the client. The proxy may also require authentication from the client before it allows the connection to the server.
There are a number of different types of proxies, the two major types being HyperText Transfer Protocol (HTTP) and SOCKS. From the perspective of the client, the difference between the types of proxy is the protocol (that is, the type and format of messages) used between the client and the proxy. The other issue for the client is determining the type of proxy and where it is running.
The TcpIpConnection class networkProxy property contains a reference to a JadeTcpIpProxy object. If this reference contains a non-null value, the JadeTcpIpProxy class connect method is executed instead of the TcpIpConnection class open or openAsynch method for each attempt to connect to the proxy.
If the networkProxy property value is null, the TcpIpConnection class open or openAsynch method is executed.
For details about the JadeTcpIpProxy class constants and the properties and method defined in the JadeTcpIpProxy class, see "JadeTcpIpProxy Class Constants", "JadeTcpIpProxy Properties", and "JadeTcpIpProxy Method", in the following subsections.
For details about reimplementing JadeTcpIpProxy class functionality, see "Proxy Communication Code Examples" and "Considerations when Implementing JadeTcpIpProxy Class Features", in the following subsections. (See also "
(None)