From 231fe6e41265848e20e6d59f282db5f5b44fb8c5 Mon Sep 17 00:00:00 2001
From: "HAKO-PC\\Hako" <carlosed127@gmail.com>
Date: Sat, 30 Dec 2017 12:20:44 -0300
Subject: [PATCH] + Permissions manager + Networking implementation + Design
 for the ArtistsListActivity - Search icon on the Actionbar (replaced with an
 EditText)

---
 app/build.gradle                              |   8 +-
 app/src/main/AndroidManifest.xml              |   6 +-
 .../androiditunesapi/AndroidItunesAPI.java    |  23 ++---
 .../activities/ArtistListActivity.java        |  92 +++++++++++++++---
 .../models/{Artist.java => Response.java}     |   2 +-
 .../hakodev/androiditunesapi/util/Utils.java  |  16 +++
 app/src/main/res/drawable/default_artist.png  | Bin 0 -> 25793 bytes
 .../main/res/layout/activity_artists_list.xml |  39 ++++++++
 app/src/main/res/layout/activity_main.xml     |  18 ----
 .../main/res/layout/artists_list_adapter.xml  |  34 +++++++
 app/src/main/res/menu/actionbar_search.xml    |  10 --
 app/src/main/res/values/colors.xml            |   1 +
 app/src/main/res/values/strings.xml           |  11 ++-
 app/src/main/res/values/styles.xml            |   1 +
 app/src/main/res/xml/backup_rules.xml         |   4 +
 15 files changed, 201 insertions(+), 64 deletions(-)
 rename app/src/main/java/com/hakodev/androiditunesapi/models/{Artist.java => Response.java} (96%)
 create mode 100644 app/src/main/java/com/hakodev/androiditunesapi/util/Utils.java
 create mode 100644 app/src/main/res/drawable/default_artist.png
 create mode 100644 app/src/main/res/layout/activity_artists_list.xml
 delete mode 100644 app/src/main/res/layout/activity_main.xml
 create mode 100644 app/src/main/res/layout/artists_list_adapter.xml
 delete mode 100644 app/src/main/res/menu/actionbar_search.xml
 create mode 100644 app/src/main/res/xml/backup_rules.xml

diff --git a/app/build.gradle b/app/build.gradle
index a4efa74..2c9d219 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -30,8 +30,8 @@ dependencies {
     androidTestImplementation 'com.android.support.test:runner:1.0.1'
     androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
 
-    compile 'com.github.shaz-tech:EasyRuntimePermission:1.0'
-    compile 'pro.oncreate.easynet:easynet:1.3.0'
-    compile group: 'com.google.code.gson', name: 'gson', version: '2.7'
-
+    compile 'com.android.support:design:26.1.0'
+    compile 'com.anthonycr.grant:permissions:1.0'
+    implementation 'com.squareup.okhttp3:okhttp:3.9.1'
+    compile group: 'com.google.code.gson', name: 'gson', version: '2.8.2'
 }
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
index a91f3ab..2036afc 100644
--- a/app/src/main/AndroidManifest.xml
+++ b/app/src/main/AndroidManifest.xml
@@ -2,6 +2,8 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="com.hakodev.androiditunesapi">
 
+    <uses-permission android:name="android.permission.INTERNET" />
+
     <application
         android:name=".AndroidItunesAPI"
         android:allowBackup="true"
@@ -9,11 +11,13 @@
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
-        android:theme="@style/AppTheme.BrandedLaunch">
+        android:theme="@style/AppTheme.BrandedLaunch"
+        android:fullBackupContent="@xml/backup_rules">
         <activity android:name=".activities.ArtistListActivity">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
                 <category android:name="android.intent.category.LAUNCHER" />
+                <action android:name="android.intent.action.VIEW" />
             </intent-filter>
         </activity>
     </application>
diff --git a/app/src/main/java/com/hakodev/androiditunesapi/AndroidItunesAPI.java b/app/src/main/java/com/hakodev/androiditunesapi/AndroidItunesAPI.java
index 001991b..0cf5d5e 100644
--- a/app/src/main/java/com/hakodev/androiditunesapi/AndroidItunesAPI.java
+++ b/app/src/main/java/com/hakodev/androiditunesapi/AndroidItunesAPI.java
@@ -2,14 +2,15 @@ package com.hakodev.androiditunesapi;
 
 import android.app.Application;
 
-import pro.oncreate.easynet.EasyNet;
-import pro.oncreate.easynet.models.NResponseModel;
+import okhttp3.OkHttpClient;
 
 public class AndroidItunesAPI extends Application {
 
-    private static Application instance = null;
+    private static AndroidItunesAPI instance = null;
 
-    public static Application getInstance() {
+    private OkHttpClient networkClient;
+
+    public static AndroidItunesAPI getInstance() {
         return instance;
     }
 
@@ -17,14 +18,10 @@ public class AndroidItunesAPI extends Application {
     public void onCreate() {
         super.onCreate();
         instance = this;
-        EasyNet.getInstance()
-                .setWriteLogs(false)
-                .setDefaultRequestListener(request -> request.setHost("http://192.168.1.151:25555/BeamNGTelemetry"))
-                .addOnErrorDefaultListener(new EasyNet.OnErrorDefaultListenerWithCode(404) {
-                    @Override
-                    public void onError(NResponseModel responseModel) {
-                        // For example, intercepted error 404
-                    }
-                });
+        networkClient = new OkHttpClient();
+    }
+
+    public OkHttpClient getNetworkClient() {
+        return networkClient;
     }
 }
diff --git a/app/src/main/java/com/hakodev/androiditunesapi/activities/ArtistListActivity.java b/app/src/main/java/com/hakodev/androiditunesapi/activities/ArtistListActivity.java
index 4618b0c..eb8d592 100644
--- a/app/src/main/java/com/hakodev/androiditunesapi/activities/ArtistListActivity.java
+++ b/app/src/main/java/com/hakodev/androiditunesapi/activities/ArtistListActivity.java
@@ -1,39 +1,99 @@
 package com.hakodev.androiditunesapi.activities;
 
+import android.Manifest;
 import android.os.Bundle;
+import android.support.annotation.NonNull;
+import android.support.annotation.Nullable;
+import android.support.constraint.ConstraintLayout;
+import android.support.design.widget.Snackbar;
 import android.support.v7.app.AppCompatActivity;
-import android.view.Menu;
-import android.view.MenuItem;
+import android.util.Log;
 import android.widget.Toast;
 
+import com.anthonycr.grant.PermissionsManager;
+import com.anthonycr.grant.PermissionsResultAction;
+import com.hakodev.androiditunesapi.AndroidItunesAPI;
 import com.hakodev.androiditunesapi.R;
+import com.hakodev.androiditunesapi.util.Utils;
+
+import java.io.IOException;
+
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
 
 public class ArtistListActivity extends AppCompatActivity {
 
+    private final static String TAG = "ArtistListActivity";
+    private final static String SEARCH_URL = "https://itunes.apple.com/search?term=%1$s&country=US&entity=musicArtist&limit=10";
+
+    private OkHttpClient networkClient;
+    private ConstraintLayout lytBase;
+
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setupTheme();
-        setContentView(R.layout.activity_main);
+        setContentView(R.layout.activity_artists_list);
+        setupViews();
+        init();
+        askForPermissions();
     }
 
     @Override
-    public boolean onCreateOptionsMenu(Menu menu) {
-        getMenuInflater().inflate(R.menu.actionbar_search, menu);
-        return true;
-    }
-
-    @Override
-    public boolean onOptionsItemSelected(MenuItem item) {
-        int id = item.getItemId();
-        if (id == R.id.action_search) {
-            Toast.makeText(this, "Test", Toast.LENGTH_SHORT).show();
-            return true;
-        }
-        return super.onOptionsItemSelected(item);
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+        PermissionsManager.getInstance().notifyPermissionsChange(permissions, grantResults);
     }
 
     private void setupTheme() {
         setTheme(R.style.AppTheme);
     }
+
+    private void setupViews() {
+        lytBase = findViewById(R.id.lytBase);
+    }
+
+    private void init() {
+        networkClient = AndroidItunesAPI.getInstance().getNetworkClient();
+    }
+
+    private void askForPermissions() {
+        //Not needed for internet permission but more of a proof of concept
+        PermissionsManager.getInstance().requestPermissionsIfNecessaryForResult(this,
+                new String[]{Manifest.permission.INTERNET}, new PermissionsResultAction() {
+                    @Override
+                    public void onGranted() {
+                        Log.d(TAG, "Permissions Granted");
+                    }
+
+                    @Override
+                    public void onDenied(String permission) {
+                        Toast.makeText(ArtistListActivity.this, R.string.permissions_not_granted, Toast.LENGTH_SHORT).show();
+                    }
+                });
+    }
+
+    private void requestArtist(String artistName) {
+        new Thread(() -> {
+            Request request = new Request.Builder()
+                    .url(String.format(SEARCH_URL, Utils.formatStringForURL(artistName)))
+                    .build();
+            networkClient.newCall(request)
+                    .enqueue(new Callback() {
+                        @Override
+                        public void onFailure(@NonNull final Call call, @NonNull IOException e) {
+                            Log.e(TAG, e.getLocalizedMessage());
+                            runOnUiThread(() -> Snackbar.make(lytBase, R.string.network_connection_error, Snackbar.LENGTH_LONG).show());
+                        }
+
+                        @Override
+                        public void onResponse(@NonNull Call call, @NonNull final Response response) throws IOException {
+                            String res = response.body().string();
+                            Log.w(TAG, res);
+                        }
+                    });
+        }).start();
+    }
 }
diff --git a/app/src/main/java/com/hakodev/androiditunesapi/models/Artist.java b/app/src/main/java/com/hakodev/androiditunesapi/models/Response.java
similarity index 96%
rename from app/src/main/java/com/hakodev/androiditunesapi/models/Artist.java
rename to app/src/main/java/com/hakodev/androiditunesapi/models/Response.java
index f775b01..6c79748 100644
--- a/app/src/main/java/com/hakodev/androiditunesapi/models/Artist.java
+++ b/app/src/main/java/com/hakodev/androiditunesapi/models/Response.java
@@ -5,7 +5,7 @@ import com.google.gson.annotations.SerializedName;
 
 import java.util.List;
 
-public class Artist {
+public class Response {
 
     @SerializedName("resultCount")
     @Expose
diff --git a/app/src/main/java/com/hakodev/androiditunesapi/util/Utils.java b/app/src/main/java/com/hakodev/androiditunesapi/util/Utils.java
new file mode 100644
index 0000000..711fd58
--- /dev/null
+++ b/app/src/main/java/com/hakodev/androiditunesapi/util/Utils.java
@@ -0,0 +1,16 @@
+package com.hakodev.androiditunesapi.util;
+
+import java.io.UnsupportedEncodingException;
+import java.net.URLEncoder;
+
+public class Utils {
+    public static String formatStringForURL(String text) {
+        String encodedText = "";
+        try {
+            return URLEncoder.encode(text, "UTF-8");
+        } catch (UnsupportedEncodingException e) {
+            e.printStackTrace();
+        }
+        return encodedText;
+    }
+}
diff --git a/app/src/main/res/drawable/default_artist.png b/app/src/main/res/drawable/default_artist.png
new file mode 100644
index 0000000000000000000000000000000000000000..75de4d897816603716a33a2a0db6f25a0aa49561
GIT binary patch
literal 25793
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

literal 0
HcmV?d00001

diff --git a/app/src/main/res/layout/activity_artists_list.xml b/app/src/main/res/layout/activity_artists_list.xml
new file mode 100644
index 0000000..e5b5f35
--- /dev/null
+++ b/app/src/main/res/layout/activity_artists_list.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:id="@+id/lytBase"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    tools:context="com.hakodev.androiditunesapi.activities.ArtistListActivity">
+
+    <EditText
+        android:id="@+id/txtArtistSearch"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_marginEnd="8dp"
+        android:layout_marginStart="8dp"
+        android:layout_marginTop="8dp"
+        android:drawableEnd="@drawable/ic_search"
+        android:drawableRight="@drawable/ic_search"
+        android:ems="10"
+        android:hint="@string/search_artist"
+        android:inputType="textPersonName"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <ListView
+        android:id="@+id/listView"
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        android:layout_marginBottom="8dp"
+        android:layout_marginEnd="8dp"
+        android:layout_marginStart="8dp"
+        android:layout_marginTop="8dp"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@+id/txtArtistSearch" />
+
+</android.support.constraint.ConstraintLayout>
diff --git a/app/src/main/res/layout/activity_main.xml b/app/src/main/res/layout/activity_main.xml
deleted file mode 100644
index 64cf2d5..0000000
--- a/app/src/main/res/layout/activity_main.xml
+++ /dev/null
@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto"
-    xmlns:tools="http://schemas.android.com/tools"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    tools:context="com.hakodev.androiditunesapi.activities.ArtistListActivity">
-
-    <TextView
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="Hello World!"
-        app:layout_constraintBottom_toBottomOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintTop_toTopOf="parent" />
-
-</android.support.constraint.ConstraintLayout>
diff --git a/app/src/main/res/layout/artists_list_adapter.xml b/app/src/main/res/layout/artists_list_adapter.xml
new file mode 100644
index 0000000..7a2f327
--- /dev/null
+++ b/app/src/main/res/layout/artists_list_adapter.xml
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="48dp"
+    android:layout_gravity="center_vertical">
+
+    <ImageView
+        android:id="@+id/imgArtist"
+        android:layout_width="36dp"
+        android:layout_height="36dp"
+        android:layout_marginBottom="8dp"
+        android:layout_marginStart="8dp"
+        android:layout_marginTop="8dp"
+        android:layout_marginLeft="8dp"
+        android:contentDescription="@string/description_artists_image"
+        android:src="@drawable/default_artist"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <TextView
+        android:id="@+id/lblArtistName"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginBottom="8dp"
+        android:layout_marginEnd="8dp"
+        android:layout_marginStart="8dp"
+        android:layout_marginTop="8dp"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+</android.support.constraint.ConstraintLayout>
\ No newline at end of file
diff --git a/app/src/main/res/menu/actionbar_search.xml b/app/src/main/res/menu/actionbar_search.xml
deleted file mode 100644
index c7b5775..0000000
--- a/app/src/main/res/menu/actionbar_search.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<menu xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto">
-    <item
-        android:id="@+id/action_search"
-        android:icon="@drawable/ic_search"
-        android:orderInCategory="100"
-        android:title="@string/search"
-        app:showAsAction="always" />
-</menu>
\ No newline at end of file
diff --git a/app/src/main/res/values/colors.xml b/app/src/main/res/values/colors.xml
index 616a44e..cc012d9 100644
--- a/app/src/main/res/values/colors.xml
+++ b/app/src/main/res/values/colors.xml
@@ -6,4 +6,5 @@
     <color name="colorBackground">#111111</color>
     <color name="colorText">#ffffff</color>
     <color name="colorTextSecondary">#e4ded7</color>
+    <color name="colorHintText">#838383</color>
 </resources>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index efa5e36..752d499 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -1,5 +1,14 @@
 <resources>
     <!-- Common terms -->
     <string name="app_name">Artist Vault</string>
-    <string name="search">Buscar</string>
+    <string name="search_artist">Buscar artista</string>
+
+    <!-- Permissions -->
+    <string name="permissions_not_granted">No tengo los permisos necesarios para funcionar</string>
+
+    <!-- Networking -->
+    <string name="network_connection_error">Error en la conexión</string>
+
+    <!-- Image descriptions -->
+    <string name="description_artists_image">Imágen del artista</string>
 </resources>
diff --git a/app/src/main/res/values/styles.xml b/app/src/main/res/values/styles.xml
index 08fc461..e8ff1bf 100644
--- a/app/src/main/res/values/styles.xml
+++ b/app/src/main/res/values/styles.xml
@@ -9,6 +9,7 @@
         <item name="android:windowBackground">@color/colorBackground</item>
         <item name="android:textColor">@color/colorText</item>
         <item name="android:textColorSecondary">@color/colorTextSecondary</item>
+        <item name="android:textColorHint">@color/colorHintText</item>
     </style>
 
     <style name="AppTheme.NoActionBar">
diff --git a/app/src/main/res/xml/backup_rules.xml b/app/src/main/res/xml/backup_rules.xml
new file mode 100644
index 0000000..231c813
--- /dev/null
+++ b/app/src/main/res/xml/backup_rules.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<full-backup-content>
+    <include domain="sharedpref" path="."/>
+</full-backup-content>
\ No newline at end of file