public final class HealthSubscription

Object
HealthSubscription

A live handle on a registered subscription.

Methods

`public` `String getId()`	The identifier this subscription was registered under.
`public` `List<HealthDataType> getTypes()`	The types being watched.
`public boolean isActive()`	`true` until `stop()` is called.
`public boolean isPushDelivery()`	Whether the operating system wakes the app when new data arrives.
`public` `HealthAnchor getAnchor()`	The cursor reached by the most recent delivery, or null before the first one.
`public long getLastDeliveryMillis()`	When the last batch was delivered, epoch millis, or 0 if never.
`public void stop()`	Cancels the subscription and discards its persisted cursor.
`public` `String toString()`	Returns a string representation of the object.

Inherited methods

From Object

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

Method details

getId

public String getId()

The identifier this subscription was registered under.

getTypes

public List<HealthDataType> getTypes()

The types being watched.

isActive

public boolean isActive()

true until stop() is called.

isPushDelivery

public boolean isPushDelivery()

Whether the operating system wakes the app when new data arrives.

false on every platform in this release. Health Connect has no push mechanism at all – Google’s own guidance is to poll – and while HealthKit does offer HKObserverQuery, this release registers none. Nothing here hooks the application lifecycle either, so changes arrive exactly when you call HealthStore.drainChanges() and at no other time: call it when you come to the foreground and from your background-fetch handler.

This is exposed as a queryable fact rather than hidden, because an app that assumes push will silently miss data for days and its authors will never know why – no changes and no new data look identical from the outside.

getAnchor

public HealthAnchor getAnchor()

The cursor reached by the most recent delivery, or null before the first one.

getLastDeliveryMillis

public long getLastDeliveryMillis()

When the last batch was delivered, epoch millis, or 0 if never.

stop

public void stop()

Cancels the subscription and discards its persisted cursor. Idempotent.

Restarting later under the same id resynchronizes from scratch, because the cursor is gone. To pause without losing your place, simply stop calling HealthStore.drainChanges().

toString

public String toString()

Returns a string representation of the object. In general, the toString method returns a string that “textually represents” this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method. The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@’, and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of: getClass().getName() + ‘@’ + Integer.toHexString(hashCode())