CS-42937 : Support for Early Access Header

CS-42936 : Taxonomy document and Test

Author: ishaileshmishra

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2012 - 2023 Contentstack
+Copyright (c) 2012 - 2024 Contentstack
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -137,7 +137,7 @@ if(response.isSuccessful()){
 
 ### The MIT License (MIT)
 
-Copyright © 2012-2023 [Contentstack](https://www.contentstack.com/). All Rights Reserved
+Copyright © 2012-2024 [Contentstack](https://www.contentstack.com/). All Rights Reserved
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the

changelog.md

@@ -1,11 +1,34 @@
 # Changelog
 
+## v1.2.0
+
+### Dec 18, 2023
+
+- New Features:
+    - Early access header support
+
+
+
+## v1.1.0
+
+### Oct 31, 2023
+
+- New Features:
+  - Taxonomy 
+  - Teams
+
+Bug Fixes:
+  - KeepAliveDuration
+  - SNYK issues fixed
+
+
 ## v1.0.0
 
 ### Aug 01, 2023
+
 - Bug Fixed For un-localize An Entry
 - Fixed Timeout Issue
-- #32 Fixed 
+- #32 Fixed
 - Code coverage improvements
 - NRP support added
 - General improvements with minor breaking changes
@@ -15,4 +38,5 @@
 ### Initial Release
 
 ### Oct 20, 2022
+
 Initial release for Contentstack CMA base Java management SDK

pom.xml

@@ -7,7 +7,7 @@
     <artifactId>cms</artifactId>
     <packaging>jar</packaging>
     <name>contentstack-management-java</name>
-    <version>1.1.0</version>
+    <version>1.3.0</version>
     <description>Contentstack Java Management SDK for Content Management API, Contentstack is a headless CMS with an
         API-first approach
     </description>

src/main/java/com/contentstack/cms/core/Util.java

@@ -15,10 +15,10 @@
  */
 public class Util {
 
-    // The line `public static final String SDK_VERSION = "1.0.0";`
+    // The line `public static final String SDK_VERSION = "1.2.0";`
     // named `SDK_VERSION` of type `String`. The value of this constant is set to
-    // "1.0.0".
-    public static final String SDK_VERSION = "1.0.0";
+    // "1.2.0".
+    public static final String SDK_VERSION = "1.2.0";
 
     static final String PRIVATE_CONSTRUCTOR = "private constructor can't be accessed outside the class";
     public static final Boolean RETRY_ON_FAILURE = true;

src/main/java/com/contentstack/cms/stack/Entry.java

@@ -744,12 +744,12 @@ public Call<ResponseBody> publishWithReference(@NotNull JSONObject requestBody)
     }
 
     /**
-     * To Unpublish an entry call will unpublish an entry at once, and also, gives
-     * you the provision to unpublish an
+     * To Un-publish an entry call will un-publish an entry at once, and also, gives
+     * you the provision to un-publish an
      * entry automatically at a later date/time.
      * <p>
      * In the 'Body' section, you can specify the locales and environments from
-     * which you want to unpublish the entry.
+     * which you want to un-publish the entry.
      * These details should be specified in the
      * <p>
      * <b>entry</b> parameter. However, if
@@ -778,4 +778,21 @@ public Call<ResponseBody> unpublish(@NotNull JSONObject requestBody) {
         return this.service.unpublish(this.headers, this.contentTypeUid, this.entryUid, requestBody);
     }
 
+
+    /**
+     * Get instance of  taxonomy search filter class instance through which we can query on taxonomy based on content type
+     * <p><b>Examples</b></p>
+     * <p>
+     * <pre>
+     *           JSONObject query = new JSONObject();
+     *         query.put("taxonomies.taxonomy_uid", "{ \"$in\" : [\"term_uid1\" , \"term_uid2\" ] }");
+     *         Response<ResponseBody> response = entry.query(query).execute();
+     *     </pre>
+     * instance of {@link Terms}
+     */
+    public Call<ResponseBody> query(@NotNull JSONObject query) {
+        validateCT();
+        return this.service.filterTaxonomy(this.headers, this.contentTypeUid, query);
+    }
+
 }

src/main/java/com/contentstack/cms/stack/EntryService.java

@@ -146,4 +146,11 @@ Call<ResponseBody> unpublish(
             @Path("content_type_uid") String contentTypeUid,
             @Path("entry_uid") String entryUid,
             @Body JSONObject requestBody);
+
+    @GET("content_types/{content_type_uid}/entries")
+    Call<ResponseBody> filterTaxonomy(
+            @HeaderMap Map<String, Object> headers,
+            @Path("content_type_uid") String contentTypeUid,
+            @Query("query") JSONObject queryObject);
+
 }

src/main/java/com/contentstack/cms/stack/Taxonomy.java

@@ -251,4 +251,16 @@ public Terms terms() {
         return new Terms(this.taxonomyService, this.headers, this.taxonomyId);
     }
 
+
+    /**
+     * Get instance of  taxonomy search filter class instance through which we can query on taxonomy based on Entry
+     * <p>Example usage:</p>
+     * <pre>JSONObject object = new JSonObject();</pre>
+     * <pre>object.put("taxonomies.color", Object)</pre>
+     * <pre>Taxonomy taxonomy = stack("authtoken").taxonomy("taxonomyId").filterTaxonomy(object);</pre>
+     */
+    public Call<ResponseBody> query(JSONObject query) {
+        return this.taxonomyService.filterTaxonomy(this.headers, query);
+    }
+
 }

src/main/java/com/contentstack/cms/stack/TaxonomyService.java

@@ -91,4 +91,11 @@ Call<ResponseBody> reorder(
     Call<ResponseBody> searchTerm(
             @HeaderMap HashMap<String, Object> headers,
             @Query("typeahead") String termString);
+
+
+    @GET("taxonomies/entries")
+    Call<ResponseBody> filterTaxonomy(
+            @HeaderMap HashMap<String, Object> headers,
+            @Query("query") JSONObject queryObject
+    );
 }

src/test/java/com/contentstack/cms/ContentstackUnitTest.java

@@ -250,7 +250,7 @@ public void testValidOrganization() {
     @Test
     public void testNullOrganizationUid() {
         Contentstack client = new Contentstack.Builder().setAuthtoken("fake@authtoken").build();
-        Assertions.assertThrows(IllegalArgumentException.class, () -> client.organization(null));
+        Assertions.assertThrows(NullPointerException.class, () -> client.organization(null));
     }
 
     @Test