de.mrapp.android.util

Class PermissionUtil

java.lang.Object

de.mrapp.android.util.PermissionUtil

public final class PermissionUtil
extends java.lang.Object

An utility class, which provides static methods, which allow to handle runtime permissions.

Since:

1.3.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	PermissionUtil.Callback Defines the interface, a callback, which should be notified, when an explanation should be shown before requesting a permission, must implement.

Method Summary

Modifier and Type	Method and Description
static boolean	isPermissionGranted(android.content.Context context, java.lang.String permission) Returns, whether a specific permission is granted, or not.
static void	requestPermission(android.app.Activity activity, int requestCode, PermissionUtil.Callback callback, java.lang.String permission) Requests a specific permission, if it has not already been granted by the user or at installation-time, by showing a dialog to the user.
static void	requestPermissions(android.app.Activity activity, int requestCode, PermissionUtil.Callback callback, java.lang.String... permissions) Requests a specific set of permissions, if they have not already been granted by the user or at installation-time, by showing a dialog to the user.

Methods inherited from class java.lang.Object

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

Method Detail

isPermissionGranted

public static boolean isPermissionGranted(android.content.Context context,
                                          java.lang.String permission)

Returns, whether a specific permission is granted, or not.

Parameters:

context - The context, which should be used, as an instance of the class Context. The context may not be null

permission - The permission, which should be checked, as a String, e.g. android.Manifest.permission.CALL_PHONE. The permission may neither be null, nor empty

Returns:

True, if the given permission is granted, false otherwise

requestPermission

public static void requestPermission(android.app.Activity activity,
                                     int requestCode,
                                     PermissionUtil.Callback callback,
                                     java.lang.String permission)

Requests a specific permission, if it has not already been granted by the user or at installation-time, by showing a dialog to the user. The given activity must implement the interface ActivityCompat.OnRequestPermissionsResultCallback as, after the user has accepted or rejected a permission, its onRequestPermissionsResultCallback-method will be invoked in order to deliver the result of the permission request. If an explanation should be shown to the user before requesting the permission and a callback is given, the callback will be notified instead of requesting the permission.

Parameters:

activity - The activity, which should handle the result of the permission request, as an instance of the class Activity. The activity may not be null and must implement the interface ActivityCompat.OnRequestPermissionsResultCallback

requestCode - The request code, which should be used, as an Integer value

callback - The callback, which should be notified when an explanation should be shown to the user before requesting the permission, as an instance of the type PermissionUtil.Callback, or null, if no explanation should be shown

permission - The permission, e.g. android.Manifest.permission.CALL_PHONE, which should be requested, as a String. The permission may neither be null, nor empty

requestPermissions

public static void requestPermissions(android.app.Activity activity,
                                      int requestCode,
                                      PermissionUtil.Callback callback,
                                      java.lang.String... permissions)

Requests a specific set of permissions, if they have not already been granted by the user or at installation-time, by showing a dialog to the user. The given activity must implement the interface ActivityCompat.OnRequestPermissionsResultCallback as, after the user has accepted or rejected a permission, its onRequestPermissionsResultCallback-method will be invoked in order to deliver the result of the permission request. If an explanation should be shown to the user before requesting a permission and a callback is given, the callback will be notified instead of requesting the permission.

Parameters:

activity - The activity, which should handle the result of the permission request, as an instance of the class Activity. The activity may not be null and must implement the interface ActivityCompat.OnRequestPermissionsResultCallback

requestCode - The request code, which should be used, as an Integer value

callback - The callback, which should be notified when an explanation should be shown to the user before requesting a permission, as an instance of the type PermissionUtil.Callback, or null, if no explanations should be shown

permissions - The permissions, e.g. android.Manifest.permission.CALL_PHONE, which should be requested, as a String array or an empty array, if no permissions should be requested