PLibGrantFlow

Class PLibGrantFlow

public class PLibGrantFlow
extends java.lang.Object

This class represents functionalities with respect to the asyncronous popup approach, in which flow decisions can be made by the user at runtime.

Constructor Summary

Constructor and Description
PLibGrantFlow()

Method Summary

Modifier and Type	Method and Description
static void	removeAllFlowDecisions(android.content.Context context) Removes all made persistent decisions from the plib.
static void	requestDataFlow(android.app.Activity uiActivity, PLibDataSource dataSource, PLibFlowCallback flowCallback) Requests permission for data flow by the user at runtime.

Methods inherited from class java.lang.Object

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

Constructor Detail

• PLibGrantFlow

  public PLibGrantFlow()

Method Detail

• removeAllFlowDecisions

  public static void removeAllFlowDecisions(android.content.Context context)

  Removes all made persistent decisions from the plib.

  Parameters:

  context - the context

• requestDataFlow

  public static void requestDataFlow(android.app.Activity uiActivity,
                                     PLibDataSource dataSource,
                                     PLibFlowCallback flowCallback)

  Requests permission for data flow by the user at runtime. This is done by a trusted plib popup, where dhe data flow is visualized and some information is shown to the user. The user can either agree on the data flow or denies it. In case where the object as the data to send somewhere is a string, the user can also select anonymize. Once the user grants data flow, regarded data is marked to be allowed to leave the app or device. In form of a visible checkbox, the user can let the plib persist given decisions for future requests. Such persistent decisions are regarded as unique in dependency of following attributes: the data type (class name), the decription about the flow (defined by the caller of this method within the data source wrapper), and the current stack trace of called method.

  THIS METHOD IS REGARDED AS A LEGAL SINK THROUGH THE PLIB!

  Parameters:

  uiActivity - Since a popup is shown to the user, an ui in form of an activity is required.

  dataSource - A generous wrapper for the data, for which a flow is requested. See PLibDataSource.

  flowCallback - A PLibFlowCallback callback, in which in dependeny of the user selection, represented data will be available: null when flow is not permited, the original content if it is permited or an anomyzed representation, if the user selected grant.