Package com.relayrides.pushy.apns

Contains classes and interfaces for interacting with the Apple Push Notification service (APNs).

See:
Description

Interface Summary

ApnsConnectionListener<T extends ApnsPushNotification>	An ApnsConnectionListener receives lifecycle events from ApnsConnection instances.
ApnsPushNotification	A push notification that can be sent through the Apple Push Notification service (APNs).
FailedConnectionListener<T extends ApnsPushNotification>	Listens for failed attempts to connect to an APNs gateway.
RejectedNotificationListener<T extends ApnsPushNotification>	Listens for permanent push notification rejections.

Class Summary

ApnsConnection<T extends ApnsPushNotification>	A connection to an APNs gateway.
ApnsEnvironment	An APNs environment is a set of servers that provide push notification services.
ExpiredToken	Represents a device token that the APN Feedback Service has reported as expired.
PushManager<T extends ApnsPushNotification>	Push managers manage connections to the APNs gateway and send notifications from their queue.
PushManagerFactory<T extends ApnsPushNotification>	A PushManagerFactory is used to configure and construct a new PushManager.

Enum Summary

RejectedNotificationReason

An enumeration of error codes that may be returned by APNs to indicate why a push notification was rejected.

Exception Summary

FeedbackConnectionException

Signals that an attempt to connect to the APNs feedback service has failed.

Package com.relayrides.pushy.apns Description

Contains classes and interfaces for interacting with the Apple Push Notification service (APNs).

The PushManager class is the main public-facing class in Pushy. A PushManager manages connections to APNs and manages the queue of outbound notifications. Generally, Pushy users should create a single long-lived PushManager instance per "topic" (or receiving app) and use it throughout the lifetime of their provider application.

The ApnsPushNotification interface represents a single APNs push notification sent to a single device. A simple concrete implementation of the ApnsPushNotification interface (SimpleApnsPushNotification) and tools for constructing push notification payloads can be found in the com.relayrides.pushy.apns.util package.

Author:

Jon Chambers