This is the official supported Java library for the Urban Airship API.
Using the library is straightforward. Create a client, setup a request payload, handle the results.
StringappKey = "appKey";
StringappSecret = "appSecret";
// Setup an authenticated APIClient with your application key and// application master secret.APIClientapiClient = APIClient.newBuilder()
.setKey(appKey)
.setSecret(appSecret)
.build();
// Setup a push payload to send to the API with our handy buildersPushPayloadpayload = PushPayload.newBuilder()
.setAudience(Selectors.deviceToken(deviceToken))
.setNotification(Notifications.notification("UA Push"))
.setPlatforms(PlatformData.of(Platform.IOS))
.build();
// Try and send, handle anything that comes uptry {
APIClientResponse<APIPushResponse> response = apiClient.push(payload);
log.info("Sent a push message!");
}
// Non 200 responses throw an APIRequestException. Check the documentation// to debug your request.catch (APIRequestExceptionex){
logger.error("Non 200 request, checking error details and taking action");
}
// An underlying error occurred, most likely outside of the scope of the// UA library, do some HTTP debuggingcatch (IOExceptione){
logger.error("Broken pipe what?");
}General documentation can be found here: http://docs.urbanairship.com/ Jave client library documentation can be found here: http://docs.urbanairship.com/reference/libraries/java/index.html
Clone the repository, and use
mvn package
to build the jar. Add the jar, located at a path similar to:
target/java-client-<version>.jar
If you would like a copy of the javadocs, use
mvn javadoc:javadoc
Add the following to your pom.xml
<!-- Urban Airship Library Dependency-->
<dependency>
<groupId>com.urbanairship</groupId>
<artifactId>java-client</artifactId>
<version>0.1.VERSION</version> <!-- Replace VERSION with the version you want to use -->
</dependency>There is an example project in the examples directory with code to send a push, a scheduled push, logging, and Maven integration.
Full documentation: http://docs.urbanairship.com/reference/libraries/java/index.html