Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Documentation possibly obsolete (was in a README.txt file inside output)
This code creates a long pooling connection to stream JSONP data from a REDIS DB to a client using a servlet. The connection is kept alive until one of the conditions occur:
- The streaming connection duration expires (subscription_duration parameter value)
- The REDIS DB connection times out (REDIS_CALLBACK_TIMEOUT constant)
- Connection loss, e.g., client closes the connection
The code accepts i) channel name, ii) fully qualified channel name and, iii) wildcard '*' for pattern based subscription.
Dependencies: jersey 2.5.1, jax-rs 2.0, jedis-2.2.1, gson-2.2.4, commons-pool-1.6, slf4j-1.7.5
Hints for testing:
- You can increase the test duration by adjusting the SUBSCRIPTION_MAX_DURATION.
- Tune REDIS_CALLBACK_TIMEOUT, in case the rate of publication is very slow
- Tune the number of threads in ExecutorService
- [Required] Set redisHost and redisPort in code, as per your REDIS setup/location
- [Optional] Tune time-out and other parameters, if necessary
- [Required]Compile and package as WAR file
- [Required] Deploy as WAR file in glassfish 3.1.2
- [Optional] Setup ssh tunneling (e.g. command: ssh tunneling:: ssh -f -L 1978:localhost:6379 scd1.qcri.org -N)
- Issue stream request from client
Channel Name based example:
Wildcard based example:
Fully qualified channel name example:
- crisisCode [mandatory]: the REDIS channel to which to subscribe
- subscription_duration [optional]: time for which to subscribe (connection automatically closed after that). The allowed suffixes are: s (for seconds), m (for minutes), h (for hours) and d (for days). The max subscription duration is specified by the hard coded SUBSCRIPTION_MAX_DURATION value (default duration).
- callback [optional]: name of the callback function for JSONP data
- rate [optional]: an upper bound on the rate at which to send messages to client, expressed as messages/min (a floating point number). If <= 0, then default rate is assumed.