org.jboss.aerogear.unifiedpush.message.sender.GCMPushNotificationSender Maven / Gradle / Ivy
/**
* JBoss, Home of Professional Open Source
* Copyright Red Hat, Inc., and individual contributors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.jboss.aerogear.unifiedpush.message.sender;
import com.google.android.gcm.server.Constants;
import com.google.android.gcm.server.Message;
import com.google.android.gcm.server.Message.Builder;
import com.google.android.gcm.server.MulticastResult;
import com.google.android.gcm.server.Result;
import com.google.android.gcm.server.Sender;
import org.jboss.aerogear.unifiedpush.api.Installation;
import org.jboss.aerogear.unifiedpush.api.AndroidVariant;
import org.jboss.aerogear.unifiedpush.api.Variant;
import org.jboss.aerogear.unifiedpush.api.VariantType;
import org.jboss.aerogear.unifiedpush.message.InternalUnifiedPushMessage;
import org.jboss.aerogear.unifiedpush.message.UnifiedPushMessage;
import org.jboss.aerogear.unifiedpush.service.ClientInstallationService;
import org.jboss.aerogear.unifiedpush.utils.AeroGearLogger;
import javax.inject.Inject;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import org.jboss.aerogear.unifiedpush.message.Priority;
@SenderType(VariantType.ANDROID)
public class GCMPushNotificationSender implements PushNotificationSender {
// collection of error codes we check for in the GCM response
// in order to clean-up invalid or incorrect device tokens
private static final Set GCM_ERROR_CODES =
new HashSet(Arrays.asList(
Constants.ERROR_INVALID_REGISTRATION, // Bad registration_id.
Constants.ERROR_NOT_REGISTERED) // The user has uninstalled the application or turned off notifications.
);
@Inject
private ClientInstallationService clientInstallationService;
private final AeroGearLogger logger = AeroGearLogger.getInstance(GCMPushNotificationSender.class);
/**
* Sends GCM notifications ({@link UnifiedPushMessage}) to all devices, that are represented by
* the {@link List} of tokens for the given {@link AndroidVariant}.
*/
public void sendPushMessage(Variant variant, Collection tokens, UnifiedPushMessage pushMessage, String pushMessageInformationId, NotificationSenderCallback callback) {
// no need to send empty list
if (tokens.isEmpty()) {
return;
}
final List registrationIDs = new ArrayList(tokens);
final AndroidVariant androidVariant = (AndroidVariant) variant;
// payload builder:
Builder gcmBuilder = new Message.Builder();
org.jboss.aerogear.unifiedpush.message.Message message = pushMessage.getMessage();
// add the "recognized" keys...
gcmBuilder.addData("alert", message.getAlert());
gcmBuilder.addData("sound", message.getSound());
gcmBuilder.addData("badge", "" + message.getBadge());
/*
The Message defaults to a Normal priority. High priority is used
by GCM to wake up devices in Doze mode as well as apps in AppStandby
mode. This has no effect on devices older than Android 6.0
*/
gcmBuilder.priority(message.getPriority() == Priority.HIGH ?
Message.Priority.HIGH :
Message.Priority.NORMAL
);
// if present, apply the time-to-live metadata:
int ttl = pushMessage.getConfig().getTimeToLive();
if (ttl != -1) {
gcmBuilder.timeToLive(ttl);
}
// iterate over the missing keys:
Set keys = message.getUserData().keySet();
for (String key : keys) {
// GCM needs stringified values:
gcmBuilder.addData(key, "" + message.getUserData().get(key));
}
//add the aerogear-push-id
gcmBuilder.addData(InternalUnifiedPushMessage.PUSH_MESSAGE_ID, pushMessageInformationId);
Message gcmMessage = gcmBuilder.build();
// send it out.....
try {
logger.fine("Sending transformed GCM payload: " + gcmMessage);
final Sender sender = new Sender(androidVariant.getGoogleKey());
// send out a message to a batch of devices...
processGCM(androidVariant, registrationIDs, gcmMessage, sender);
logger.fine("Message batch to GCM has been submitted");
callback.onSuccess();
} catch (Exception e) {
// GCM exceptions:
logger.severe("Error sending payload to GCM server");
callback.onError("Error sending payload to GCM server");
}
}
/**
* Process the HTTP POST to the GCM infrastructor for the given list of registrationIDs. *
*/
private void processGCM(AndroidVariant androidVariant, List registrationIDs, Message gcmMessage, Sender sender) throws IOException {
logger.info(String.format("Sent push notification to GCM Server for %d registrationIDs",registrationIDs.size()));
MulticastResult multicastResult = sender.send(gcmMessage, registrationIDs, 0);
// after sending, let's identify the inactive/invalid registrationIDs and trigger their deletion:
cleanupInvalidRegistrationIDsForVariant(androidVariant.getVariantID(), multicastResult, registrationIDs);
}
/**
* Walks over the {@code MulticastResult} from the GCM call and identifies the index of all {@code Result} objects that
* indicate an InvalidRegistration error.
*
*
This index is used to find the matching registration ID in the List of all used registrationIDs.
*
*
Afterwards all 'invalid' registration IDs for the given variantID are being deleted from our database.
*
* @param variantID id of the actual {@code AndroidVariantEntity}.
* @param multicastResult the results from the HTTP request to the Google Cloud.
* @param registrationIDs list of all tokens that we submitted to GCM.
*/
private void cleanupInvalidRegistrationIDsForVariant(String variantID, MulticastResult multicastResult, List registrationIDs) {
// get the GCM send results for all of the client devices:
final List results = multicastResult.getResults();
// storage for all the invalid registration IDs:
final Set inactiveTokens = new HashSet();
// read the results:
for (int i = 0; i < results.size(); i++) {
// use the current index to access the individual results
final Result result = results.get(i);
final String errorCodeName = result.getErrorCodeName();
if (errorCodeName != null) {
logger.info(String.format("Processing [%s] error code from GCM response, for registration ID: [%s]", errorCodeName, registrationIDs.get(i)));
}
//after sending, lets find tokens that are inactive from now on and need to be replaced with the new given canonical id.
//according to gcm documentation, google refreshes tokens after some time. So the previous tokens will become invalid.
//When you send a notification to a registration id which is expired, for the 1st time the message(notification) will be delivered
//but you will get a new registration id with the name canonical id. Which mean, the registration id you sent the message to has
//been changed to this canonical id, so change it on your server side as well.
//check if current index of result has canonical id
String canonicalRegId = result.getCanonicalRegistrationId();
if (canonicalRegId != null) {
// same device has more than one registration id: update it, if needed!
// let's see if the canonical id is already in our system:
Installation installation = clientInstallationService.findInstallationForVariantByDeviceToken(variantID, canonicalRegId);
if (installation != null) {
// ok, there is already a device, with newest/latest registration ID (aka canonical id)
// It is time to remove the old reg id, to avoid duplicated messages in the future!
inactiveTokens.add(registrationIDs.get(i));
} else {
// since there is no registered device with newest/latest registration ID (aka canonical id),
// this means the new token/regId was never stored on the server. Let's update the device and change its token to new canonical id:
installation = clientInstallationService.findInstallationForVariantByDeviceToken(variantID,registrationIDs.get(i));
installation.setDeviceToken(canonicalRegId);
//update installation with the new token
logger.info(String.format("Based on returned canonical id from GCM, updating Android installations with registration id [%s] with new token [%s] ", registrationIDs.get(i), canonicalRegId));
clientInstallationService.updateInstallation(installation);
}
} else {
// is there any 'interesting' error code, which requires a clean up of the registration IDs
if (GCM_ERROR_CODES.contains(errorCodeName)) {
// Ok the result at INDEX 'i' represents a 'bad' registrationID
// Now use the INDEX of the _that_ result object, and look
// for the matching registrationID inside of the List that contains
// _all_ the used registration IDs and store it:
inactiveTokens.add(registrationIDs.get(i));
}
}
}
if (! inactiveTokens.isEmpty()) {
// trigger asynchronous deletion:
logger.info(String.format("Based on GCM response data and error codes, deleting %d invalid or duplicated Android installations", inactiveTokens.size()));
clientInstallationService.removeInstallationsForVariantByDeviceTokens(variantID, inactiveTokens);
}
}
}