FillEventHistory

public final class FillEventHistory
extends Object implements Parcelable

java.lang.Object
   ↳ android.service.autofill.FillEventHistory


Describes what happened after the last AutofillService#onFillRequest(FillRequest, android.os.CancellationSignal, FillCallback) call.

This history is typically used to keep track of previous user actions to optimize further requests. For example, the service might return email addresses in alphabetical order by default, but change that order based on the address the user picked on previous requests.

The history is not persisted over reboots, and it's cleared every time the service replies to a AutofillService#onFillRequest(FillRequest, android.os.CancellationSignal, FillCallback) by calling FillCallback#onSuccess(FillResponse) or FillCallback#onFailure(CharSequence) (if the service doesn't call any of these methods, the history will clear out after some pre-defined time).

Summary

Nested classes

class FillEventHistory.Event

Description of an event that occurred after the latest call to FillCallback#onSuccess(FillResponse)

Inherited constants

Fields

public static final Creator<FillEventHistory> CREATOR

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

Bundle getClientState()

This method was deprecated in API level 28. use getEvents() then Event#getClientState() instead.

List<FillEventHistory.Event> getEvents()

Returns the events occurred after the latest call to FillCallback#onSuccess(FillResponse).

String toString()

Returns a string representation of the object.

void writeToParcel(Parcel parcel, int flags)

Flatten this object in to a Parcel.

Inherited methods

Fields

CREATOR

Added in API level 26
public static final Creator<FillEventHistory> CREATOR

Public methods

describeContents

Added in API level 26
public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR

getClientState

Added in API level 26
Deprecated in API level 28
public Bundle getClientState ()

This method was deprecated in API level 28.
use getEvents() then Event#getClientState() instead.

Returns the client state set in the previous FillResponse.

Note: the state is associated with the app that was autofilled in the previous AutofillService#onFillRequest(FillRequest, android.os.CancellationSignal, FillCallback) , which is not necessary the same app being autofilled now.

Returns
Bundle This value may be null.

getEvents

Added in API level 26
public List<FillEventHistory.Event> getEvents ()

Returns the events occurred after the latest call to FillCallback#onSuccess(FillResponse).

Returns
List<FillEventHistory.Event> The list of events or null if non occurred.

toString

Added in API level 26
public String toString ()

Returns a string representation of the object.

Returns
String a string representation of the object.

writeToParcel

Added in API level 26
public void writeToParcel (Parcel parcel, 
                int flags)

Flatten this object in to a Parcel.

Parameters
parcel Parcel: The Parcel in which the object should be written. This value cannot be null.

flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES