Typical usage is:
Map metaData = ServletTunnel.extractMetaData (req); Connection con = ClientFactory.connect (uri, metaData); ServletTunnel.tunnel (req, res, con);
We use this to tunnel this information to the remote server, otherwise it won't know our client's IP address and other non-header info.