Skip to content

rollbar/rollbar-java

Repository files navigation

Overview

java-rollbar is a set of maven modules that allows reporting issues to Rollbar in anything that can use Java.

It's still under development, and many of the design decisions may still be altered. If you have an opinion voice it in the issues!

The library is split into small modules to enable re-use as much as possible. If you want to change a single piece of how it works it should be relatively straightforward.

  • rollbar-utilities contains code shared by the other modules.
  • rollbar-testing contains shared test code.
  • rollbar-sender implements sending occurrences to Rollbar. No external dependencies make this lightweight, but a good candidate for an upgrade.
  • rollbar-payload implements a Payload object that can be serialized to JSON. It does so with no external dependencies.
  • rollbar brings together all the pieces from above to make it easy to install and start recording errors.

Installing

You can, of course, build it yourself and depend on the .jar manually, however, the modules are up on maven central and can be installed in most tool chains pretty trivially.

Maven

All these can be installed as Maven projects. Simply add the dependency to your pom file:

<dependencies>
<dependency>
  <groupId>com.rollbar</groupId>
   <artifactId>rollbar</artifactId>
   <version>0.5.4</version>
</dependency>
</dependencies>

Gradle

compile('com.rollbar:rollbar:0.5.4')

Usage

For actual usage, the easiest way to get started is with the rollbar package. See the documentation there.

Contributing

This library was written by someone who knows C# much better than Java. Feel free to issue stylistic PRs, or offer suggestions on how we can improve this library.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request