HTTP Proxy Agent Properties

This agent handles proxies to other web servers. A file needs to be provided which lists the URIs which to proxy and where they should be proxied to.

service_name

This property tells the agent what name to register itself as. If a PropsListServiceManager is used, this name must be in the form of extension:// followed by a regular expression matching a domain:port. By default, this property is set to extension://.* which matches all domains and all ports.

proxy_file

This property tells the agent where to find the proxy file. The proxy file provides a list of URIs and where they should be proxied to. Here is an example of a proxy file:

/proxy_me=http://proxy_desitation:1099 /proxy_me_too=http://proxy1:9000 /proxy_me_too=http://proxy2:9000 /proxy_me_too=http://proxy3:9000

When a browser tries to access /proxy_me, the request will be given to this agent, it will contact the web server at proxy_destination, port 1099, and send the same request to that server. In the case when the browser tries to access /proxy_me_too, the HTTPProxyAgent will cycle through the 3 web servers which were given. Thus the first time I access it, I will be proxied to proxy1, port 9000. The second time I access it, I will be proxied to proxy2, port 9000; and proxy3 the third time, and proxy1 the fourth time, and so on. By default, this property is set to ./http.proxy

check_interval

The HTTPProxyAgent has an internal check where it pings the web servers on the proxy list. If they are not responding, that web server will be removed from the proxy list temporarily. It will be added once the HTTPProxyAgent pings it and it is responding. By default, this value is set to 300000, which means every 300000 milliseconds, it will check every proxy destination on its list.

initial_wait_time

This property tells the agent how long to wait before it starts to checking the proxy destinations. In the case where you are proxying to yourself, you will need to wait until the WebServer is fully initalized and running before the agent should start pinging it. By default this property is set to 60000, which means it will wait 60000 milliseconds before it starts checking.