vertx-push-onesignal

Send push notifications asynchronously in your vertx application with OneSignal.

Example

//Create a client. You get the APP_ID and API_KEY from the OneSignal-dashboard
PushClient.create(Vertx.vertx(), "YOUR_APP_ID", "YOUR_API_KEY").
                //setup the content of the message on the serverside
                withContent(new JsonObject().put("en", "English Content.").put("de","Deutscher Inhalt.")).
                //all users should receive this
                targetBySegments(Segments.ALL).
                sendNow(
                        h -> {
                            if (h.succeeded()) {
                                System.err.println(h.result().encodePrettily());
                            } else {
                                h.cause().printStackTrace();
                            }
                        });

More examples can be found in the Examples-class.

Why would I use this library over writing my own CURL?

Sure you can do this. What this library gives you on top is validation. When writing your own request it is absolutely fine to both target users by segments and filters. This library makes sure that you only use one targeting parameter. Also the content of a message can either be defined by using templates or setting the content like in the example above, this library lets you set exactly one way to deliver messages.

Filters

Targeting users using filters can be tricky when writing your own CURL call. You have to remember which relation can be used for which filter. This library only lets you use the relations that are allowed for a given filter:

//using a filter to target only users that haven't used the app for 24 hours
Filters.lastSession().greater(24);  //OK
Filters.lastSession().less(24);     //OK
Filters.lastSession().exists(24);   //Compiler-error

//Combining filters using OR
Filters.lastSession().greater(24).or(Filters.sessionCount().equal(1));
...

requirements

To use this library you need to create a OneSignal-account and configure your clients (web or mobile) accordingly.

maven

<dependency>
  <groupId>io.github.jklingsporn</groupId>
  <artifactId>vertx-push-onesignal</artifactId>
  <version>1.9</version>
</dependency>

disclaimer

The author has no connection to the companies behind OneSignal or Vertx. This library also comes without any warranty - just take it or leave it.