A Java Realtime and REST client library for Ably.io, the realtime messaging service.
Visit https://www.ably.io/documentation for a complete API reference and more examples.
Please refer to the documentation.
JRE 6 or later is required.
All dependencies are included as libraries in libs.
Note that the Java Unlimited JCE extensions
must be installed in the runtime environment.
Build a jar file for ably-rest with ant:
ant clean && ant
Alternatively, Eclipse project and classpath files are included; import directly into Eclipse (Indigo or later).
Tests are based on JUnit, and a single JUnit suite (at io.ably.test.RestSuite)
covers all tests.
Tests can be run from Eclipse, or from the command-line by:
java -classpath "./out/classes:./libs/*:./libs/test/*" io.ably.test.RestSuite
There is also an ant target to run the unit tests:
ant test
To run tests against a specific host, specify this as a property on the ant commandline:
ant test -Dably.host=custom.host.com
Tests will run against staging by default.
Also, to force the tests to run without TLS, do
ant test -Dably.tls=false
Please visit http://support.ably.io/ for access to our knowledgebase and to ask for any assistance.
You can also view the community reported Github issues.
To see what has changed in recent versions of Bundler, see the CHANGELOG.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Ensure you have added suitable tests and the test suite is passing(
ant test) - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Copyright (c) 2015 Ably Real-time Ltd, Licensed under the Apache License, Version 2.0. Refer to LICENSE for the license terms.