[Android] Add facility class for AlertDialog display in API

[Geoffrey Métais]

vlc-android | branch: master | Geoffrey Métais <geoffrey.metais at gmail.com> | Mon Dec 21 19:17:37 2015 +0100| [241e24bfb1556a9a6be6210bd3d78dabf07d569d] | committer: Geoffrey Métais

Add facility class for AlertDialog display in API

> https://code.videolan.org/videolan/vlc-android/commit/241e24bfb1556a9a6be6210bd3d78dabf07d569d
---

 .../videolan/vlc/extensions/api/tools/Dialogs.java | 91 ++++++++++++++++++++++
 api/src/main/res/values/strings.xml                | 27 +------
 2 files changed, 94 insertions(+), 24 deletions(-)

diff --git a/api/src/main/java/org/videolan/vlc/extensions/api/tools/Dialogs.java b/api/src/main/java/org/videolan/vlc/extensions/api/tools/Dialogs.java
new file mode 100644
index 0000000..225780e
--- /dev/null
+++ b/api/src/main/java/org/videolan/vlc/extensions/api/tools/Dialogs.java
@@ -0,0 +1,91 @@
+package org.videolan.vlc.extensions.api.tools;
+
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.provider.Settings;
+import android.support.annotation.NonNull;
+import android.support.annotation.Nullable;
+import android.support.v7.app.AlertDialog;
+
+import org.videolan.vlc.plugin.api.R;
+
+public class Dialogs {
+
+    /**
+     * Constant value to disable Dialog message.
+     */
+    public static final int NO_MESSAGE = 0;
+
+
+    /**
+     * Facility function to show an AlertDialog
+     * @param context The context to use for Dialog display
+     * @param title Title for the AlertDialog
+     * @param message Message to display (set to NO_MESSAGE if you don't want to show any message)
+     * @param cancelListener The listener wich will be triggered after dialog cancelation.
+     *                       If null, the dialog is not cancelable
+     * @return the AlertDialog instance
+     */
+    public static AlertDialog showAlertDialog(@NonNull Context context, @NonNull int title,
+                                              @Nullable int message,
+                                              @Nullable DialogInterface.OnCancelListener cancelListener) {
+        return showAlertDialog(context, title, message, cancelListener, null, null);
+    }
+
+    /**
+     * Facility function to show an AlertDialog
+     * @param context The context to use for Dialog display
+     * @param title Title for the AlertDialog
+     * @param message Message to display (set to NO_MESSAGE if you don't want to show any message)
+     * @param cancelListener The listener wich will be triggered after dialog cancelation.
+     *                       If null, the dialog is not cancelable
+     * @param positiveAction DialogInterface.OnClickListener wich will be triggered on 'OK' button click.
+     *                       If null, the AlertDialog doesn't have positive button.
+     * @param negativeAction ialogInterface.OnClickListener wich will be triggered on 'Cancel' button click.
+     *                       If null, the AlertDialog doesn't have negative button.
+     * @return the AlertDialog instance
+     */
+    public static AlertDialog showAlertDialog(@NonNull Context context, @NonNull int title,
+                                              @NonNull int message,
+                                              @Nullable DialogInterface.OnCancelListener cancelListener,
+                                              @Nullable DialogInterface.OnClickListener positiveAction,
+                                              @Nullable DialogInterface.OnClickListener negativeAction) {
+
+        AlertDialog.Builder builder = new AlertDialog.Builder(context)
+                .setTitle(title);
+        if (message > 0)
+            builder.setMessage(message);
+        if (cancelListener != null) {
+            builder.setCancelable(true)
+                    .setOnCancelListener(cancelListener);
+        }
+        if (positiveAction != null) {
+            builder.setPositiveButton(android.R.string.ok, positiveAction);
+        }
+        if (negativeAction != null) {
+            builder.setPositiveButton(android.R.string.cancel, negativeAction);
+        }
+        AlertDialog alert = builder.create();
+        alert.show();
+        return alert;
+    }
+
+    /**
+     *
+     * @param context The context to use for Dialog display
+     * @param cancelListener The listener wich will be triggered after dialog cancelation or positive action
+     * @return the AlertDialog instance
+     */
+    public static AlertDialog showNetworkNeeded(@NonNull final Context context,
+                                                @NonNull final DialogInterface.OnCancelListener cancelListener) {
+        return showAlertDialog(context, R.string.network_error_title, R.string.network_error_message,
+                cancelListener, new DialogInterface.OnClickListener() {
+                    @Override
+                    public void onClick(DialogInterface dialog, int which) {
+                        context.startActivity(new Intent(Settings.ACTION_WIFI_SETTINGS));
+                        dialog.cancel();
+                    }
+                }, null);
+    }
+}
diff --git a/api/src/main/res/values/strings.xml b/api/src/main/res/values/strings.xml
index 491820c..86bf7e7 100644
--- a/api/src/main/res/values/strings.xml
+++ b/api/src/main/res/values/strings.xml
@@ -1,26 +1,5 @@
-<!--
-  ~ **************************************************************************
-  ~  strings.xml.java
-  ~ ***************************************************************************
-  ~  Copyright © 2015 VLC authors and VideoLAN
-  ~  Author: Geoffrey Métais
-  ~
-  ~  This program is free software; you can redistribute it and/or modify
-  ~  it under the terms of the GNU General Public License as published by
-  ~  the Free Software Foundation; either version 2 of the License, or
-  ~  (at your option) any later version.
-  ~
-  ~  This program is distributed in the hope that it will be useful,
-  ~  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  ~  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  ~  GNU General Public License for more details.
-  ~
-  ~  You should have received a copy of the GNU General Public License
-  ~  along with this program; if not, write to the Free Software
-  ~  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
-  ~  ***************************************************************************
-  -->
-
 <resources>
-    <string name="app_name">Plugin API</string>
+  <string name="app_name">VLC extension library</string>
+  <string name="network_error_title">No Internet connection</string>
+  <string name="network_error_message">This extension needs your device to be connected to internet</string>
 </resources>