org.kuali.mobility.push.service.send

Class AndroidSendService

java.lang.Object

org.kuali.mobility.push.service.send.AndroidSendService

All Implemented Interfaces:

SendService

public class AndroidSendService
extends Object
implements SendService

Implementation of the send service for Android. This service should never be called directly, but instead be called via SendServiceDelegator.
This service limits the total number of simultanious connections to the GCM service to a maximum of 10 connections. If another thread attempts to send another message and the connection limit has been reached, the thread will block until a connection is available.
This implementation will send messages requested by the sendPush(Push, List) in batches of 1000 registration ids per batch.

The SendServiceDelegator service ensures that the OS specific implementations are called in a separate thread, calling this service directly can cause unexpected long waits in inappropriate threads.

This implementation's properties are set by spring injection if used as a bean.
Available spring properties are:

Property	Purpose
google.api.key	Google API key
push.google.gcm.host	URL for the GCM host

Since:

2.2.0

Author:

Kuali Mobility Team (mobility.dev@kuali.org)

Constructor Summary

Constructors

Constructor and Description
AndroidSendService()

Method Summary

Methods

Modifier and Type	Method and Description
void	sendPush(Push push, Device device) Sends a Push message to one specific device.
void	sendPush(Push push, List<Device> devices) Sends a Push message to a list of devices.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AndroidSendService

public AndroidSendService()

Method Detail

sendPush

public void sendPush(Push push,
            Device device)

Description copied from interface: SendService

Sends a Push message to one specific device. If the implementation can not send a message to the specified device eg. The implementation can only send to Android devices and a iOS device is specified, an InvalidArgumentException can be thrown.

Specified by:

sendPush in interface SendService

Parameters:

push - The Push message to send.

sendPush

public void sendPush(Push push,
            List<Device> devices)

Description copied from interface: SendService

Sends a Push message to a list of devices. If the implementation can not send a message to one (or more) of the devices in the list, the service may throw an IllegalArgumentException and not send further to any other devices in the list.

Specified by:

sendPush in interface SendService

Parameters:

push - The Push message to send.

devices - The list of devices to send the message to.