Add setLocale method to Asset class and corresponding test case

Author: harshitha-cstk

contentstack/src/androidTest/java/com/contentstack/sdk/AssetTestCase.java

@@ -124,6 +124,22 @@ public void onCompletion(ResponseType responseType, Error error) {
         latch.await(5, TimeUnit.SECONDS);
     }
 
+    @Test
+    public void test_setLocale_fetch() throws InterruptedException {
+        final CountDownLatch latch = new CountDownLatch(1);
+        final Asset asset = stack.asset(assetUid);
+        asset.setLocale("en-us");
+        asset.fetch(new FetchResultCallback() {
+            @Override
+            public void onCompletion(ResponseType responseType, Error error) {
+                assertNotNull(asset.getAssetUid());
+                latch.countDown();
+            }
+        });
+        latch.await(5, TimeUnit.SECONDS);
+        assertEquals("Query was not completed in time", 0, latch.getCount());
+    }
+
     @Test
     public void test_include_branch() {
         final Asset asset = stack.asset(assetUid);

contentstack/src/main/java/com/contentstack/sdk/Asset.java

@@ -616,4 +616,22 @@ public Asset includeBranch() {
         return this;
     }
 
+     /**
+     * <p>
+     * <br><br><b>Example :</b><br>
+     * <pre class="prettyprint">
+     * Asset asset = asset.setLocale("en-hi");
+     * </pre>
+     * </p>
+     */
+    public Asset setLocale(String locale) {
+        if (locale != null) {
+            try {
+                urlQueries.put("locale", locale);
+            } catch (JSONException e) {
+                Log.e(TAG, e.getLocalizedMessage());
+            }
+        }
+        return this;
+    }
 }

contentstack/src/test/java/com/contentstack/sdk/TestAssetAdvanced.java

@@ -189,6 +189,37 @@ public void testAddParamOverwrite() {
         assertNotNull(asset);
     }
 
+    // ==================== SET LOCALE Tests ====================
+
+    @Test
+    public void testSetLocale() {
+        Asset result = asset.setLocale("en-us");
+        assertNotNull(result);
+        assertSame(asset, result);
+        assertEquals("en-us", asset.urlQueries.optString("locale", ""));
+    }
+
+    @Test
+    public void testSetLocaleReturnsThis() {
+        Asset result = asset.setLocale("en-hi");
+        assertSame(asset, result);
+    }
+
+    @Test
+    public void testSetLocaleWithNull() {
+        asset.setLocale("en-us");
+        Asset result = asset.setLocale(null);
+        assertSame(asset, result);
+        assertEquals("en-us", asset.urlQueries.optString("locale", ""));
+    }
+
+    @Test
+    public void testSetLocaleChainedWithFetch() {
+        asset.setLocale("en-us").includeFallback();
+        assertTrue(asset.urlQueries.has("locale"));
+        assertEquals("en-us", asset.urlQueries.optString("locale", ""));
+    }
+
     // ==================== GET METHODS Tests ====================
 
     @Test