English
资源说明：High performance reverse proxy, employs memcached for caching
Middleman
-----------
Middleman is a reverse proxy which supports regex refreshes and employes memcached as the backend. Middleman was written because varnish didn't work very well for our use case.
- Varnish employs local RAM hence cannot hold large working sets
- More Varnish servers means more origin traffic due to cache misses. It adds up.
- Local cache also create cache coherency problems
- Varnish monitoring is not at par with what we get from newrelic
Features
-------
- Middleman employs distributed memory (memcached)
- Supports regex invalidation
- Supports url refresh
- Awesome performance
- Quickly enable memcached cache on apps without coding
Design Principles
--------
- As much as possible, do things in background
- Use memcached to exploit distributed memory
User guide
------
To run middleman configure middleman webapp in Jetty, Tomcat, Resin, etc. Middleman is configured via a properties file. Specify origin server and memcached nodes in the configuration file. Origin servers is where Middleman will get the content from when it's not found it cache or it needs to refresh a url. Memcached nodes are used for caching.
###Refresh a URL
Middleman allows a url to be refreshed on-demand
/_refresh?url=http://app.example.com/index.html
###Invalidate via regex
Middleman allows urls to be invalidated by specifying a regex. Middleman maintains a list of regex rules for `refreshTimeout` period and if the url matches a regex, then it asynchronously refreshes the url when it was being requested.
/_refresh?regex=.*/posts/tags/code.*
Configuration
------
Middleman is configured via `ign/middleman/config/middleman-${environment}.properties` under `WEB-INF/classes` where `environment` can be specified via System Property `environment` (Example: `/ign/middleman/config/middleman-development.properties`). The default value of `environment` is `development`.
###middleman-development.properties
#memcached hosts comma separated list of host:port
memecahed=localhost:11211
#memcached cache timeout
#memcachedTimeout=200
memcachedTimeout=604800
#After refresh timeout has expired, the middleman proxy will return the
# stale data from memcached and schedule a background update
refreshTimeout=120
#refreshTimeout=7200
origin=127.0.0.1:80
#http connect and read timeouts in ms
connectTimeout=5000
readTimeout=30000
#cached rules time out in s
cachedRulesTimeout=5
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
