com.google.api.client.googleapis.subscriptions.json

Class JsonNotificationCallback<T>

java.lang.Object

com.google.api.client.googleapis.subscriptions.TypedNotificationCallback<T>

com.google.api.client.googleapis.subscriptions.json.JsonNotificationCallback<T>

Type Parameters:

T - Type of the data contained within a notification

All Implemented Interfaces:

NotificationCallback, Serializable

public abstract class JsonNotificationCallback<T>
extends TypedNotificationCallback<T>

A TypedNotificationCallback which uses an JSON content encoding.

Must not be implemented in form of an anonymous class as this will break serialization.

Implementation should be thread-safe.

State will only be persisted once when a subscription is created. All state changes occurring during the .handleNotification(..) call will be lost.

Example usage:

    class MyJsonNotificationCallback extends JsonNotificationCallback<ItemList> {
      void handleNotification(
          Subscription subscription, TypedNotification<ItemList> notification) {
        for (Item item in notification.getContent().getItems()) {
          System.out.println(item.getId());
        }
      }
    }

    JsonFactory createJsonFactory() {
      return new JacksonFactory();
    }

    ...

    service.items.list("someID").subscribe(new MyJsonNotificationCallback()).execute()
 

Since:

1.14

Author:

Matthias Linder (mlinder)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
JsonNotificationCallback()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract com.google.api.client.json.JsonFactory	createJsonFactory() Creates a new JSON factory which is used to deserialize notifications.
com.google.api.client.json.JsonFactory	getJsonFactory() Returns the JSON-factory used by this handler.
protected com.google.api.client.util.ObjectParser	getParser(UnparsedNotification notification) Returns an ObjectParser which can be used to parse this notification.
JsonNotificationCallback<T>	setDataType(Class<T> dataClass) Sets the data type which this handler can parse or Void.class if no data type is expected.

Methods inherited from class com.google.api.client.googleapis.subscriptions.TypedNotificationCallback

getDataClass, handleNotification, handleNotification

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonNotificationCallback

public JsonNotificationCallback()

Method Detail

getJsonFactory

public final com.google.api.client.json.JsonFactory getJsonFactory()
                                                            throws IOException

Returns the JSON-factory used by this handler.

Throws:

IOException

createJsonFactory

protected abstract com.google.api.client.json.JsonFactory createJsonFactory()
                                                                     throws IOException

Creates a new JSON factory which is used to deserialize notifications.

Throws:

IOException

getParser

protected final com.google.api.client.util.ObjectParser getParser(UnparsedNotification notification)
                                                           throws IOException

Description copied from class: TypedNotificationCallback

Returns an ObjectParser which can be used to parse this notification.

Specified by:

getParser in class TypedNotificationCallback<T>

Parameters:

notification - Notification which should be parsable by the returned parser

Throws:

IOException

setDataType

public JsonNotificationCallback<T> setDataType(Class<T> dataClass)

Description copied from class: TypedNotificationCallback

Sets the data type which this handler can parse or Void.class if no data type is expected.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Overrides:

setDataType in class TypedNotificationCallback<T>