Next : Early Access Support Added

CHANGELOG.md

@@ -1,6 +1,15 @@
 # CHANGELOG
 
-## v1.12.3
+
+## v1.13.0
+
+### Date: 18-Dec-2023
+
+- Taxonomy Query Support
+- Updated Latest version of Utils SDK to 1.2.6
+- Snyk Issues fixed
+- Updated dependencies
+- Added support for early access feature
 
 ### Date: 28-SEP-2023
 

pom.xml

@@ -5,7 +5,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.contentstack.sdk</groupId>
     <artifactId>java</artifactId>
-    <version>1.12.3</version>
+    <version>1.13.0</version>
     <packaging>jar</packaging>
     <name>contentstack-java</name>
     <description>Java SDK for Contentstack Content Delivery API</description>
@@ -25,18 +25,18 @@
         <loggin.version>5.0.0-alpha.11</loggin.version>
         <jococo-plugin.version>0.8.5</jococo-plugin.version>
         <lombok-source.version>1.18.30</lombok-source.version>
-        <junit-jupiter.version>5.10.0</junit-jupiter.version>
+        <junit-jupiter.version>5.10.1</junit-jupiter.version>
         <junit-jupiter-engine.version>5.8.0-M1</junit-jupiter-engine.version>
         <gson.version>2.8.8</gson.version>
         <json-simple-version>1.1.1</json-simple-version>
         <maven-site-plugin.version>3.3</maven-site-plugin.version>
         <maven-gpg-plugin.version>1.5</maven-gpg-plugin.version>
         <maven-compiler-plugin.version>3.8.1</maven-compiler-plugin.version>
         <nexus-staging-maven-plugin.version>1.6.13</nexus-staging-maven-plugin.version>
-        <json-version>20230618</json-version>
+        <json-version>20231013</json-version>
         <jacoco-maven-plugin-version>0.8.7</jacoco-maven-plugin-version>
         <maven-release-plugin-version>2.5.3</maven-release-plugin-version>
-        <contentstack-utils-version>1.2.4</contentstack-utils-version>
+        <contentstack-utils-version>1.2.6</contentstack-utils-version>
     </properties>
 
     <parent>

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

@@ -4,9 +4,11 @@
 import retrofit2.Call;
 import retrofit2.http.GET;
 import retrofit2.http.HeaderMap;
+import retrofit2.http.Query;
 import retrofit2.http.Url;
 
 import java.util.LinkedHashMap;
+import java.util.Map;
 
 /**
  * @author Shailesh Mishra
@@ -15,5 +17,11 @@
  */
 public interface APIService {
     @GET
-    Call<ResponseBody> getRequest(@Url String url, @HeaderMap LinkedHashMap<String, Object> headers);
+    Call<ResponseBody> getRequest(
+            @Url String url, @HeaderMap LinkedHashMap<String, Object> headers);
+
+    @GET("v3/taxonomies/entries")
+    Call<ResponseBody> getTaxonomy(
+            @HeaderMap Map<String, Object> headers,
+            @Query("query") String query);
 }

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

@@ -186,7 +186,8 @@ public void send() {
     }
 
     private void getService(String requestUrl) throws IOException {
-        this.headers.put(X_USER_AGENT_KEY, "contentstack-java/" + SDK_VERSION);
+
+        this.headers.put(X_USER_AGENT_KEY, "contentstack-delivery-java/" + SDK_VERSION);
         this.headers.put(USER_AGENT_KEY, USER_AGENT);
         this.headers.put(CONTENT_TYPE, APPLICATION_JSON);
 
@@ -260,7 +261,6 @@ void handleJSONObject(JSONArray arrayEntry, JSONObject jsonObj, int idx) {
     }
 
     void setError(String errResp) {
-        logger.info(errResp);
         responseJSON = new JSONObject(errResp); // Parse error string to JSONObject
         responseJSON.put(ERROR_MESSAGE, responseJSON.optString(ERROR_MESSAGE));
         responseJSON.put(ERROR_CODE, responseJSON.optString(ERROR_CODE));

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

@@ -1,5 +1,7 @@
 package com.contentstack.sdk;
 
+import lombok.Getter;
+import lombok.Setter;
 import okhttp3.ConnectionPool;
 import org.jetbrains.annotations.NotNull;
 import org.json.JSONObject;
@@ -26,12 +28,19 @@ public class Config {
     protected JSONObject livePreviewEntry = null;
     protected ContentstackRegion region = ContentstackRegion.US;
     protected String managementToken;
+    @Setter
+    @Getter
     protected String branch;
+    @Setter
     protected Proxy proxy = null;
     protected ConnectionPool connectionPool = new ConnectionPool();
 
     protected List<ContentstackPlugin> plugins = null;
 
+
+    /**
+     * -- GETTER --
+     * The configuration for the contentstack that contains support for
     public String getBranch() {
         return branch;
     }
@@ -55,9 +64,8 @@ public void setBranch(String branch) {
      *         config = new Config(); config.setProxy(proxy);
      *         </code>
      */
-    public void setProxy(Proxy proxy) {
-        this.proxy = proxy;
-    }
+    @Getter
+    protected String[] earlyAccess;
 
     /**
      * Returns the Proxy instance
@@ -73,12 +81,9 @@ public Proxy getProxy() {
      * {@link okhttp3.Address} may share a {@link okhttp3.Connection}. This class implements the policy * of which
      * connections to keep open for future use.
      *
-     * @param maxIdleConnections
-     *         the maxIdleConnections default value is 5
-     * @param keepAliveDuration
-     *         the keepAliveDuration default value is 5
-     * @param timeUnit
-     *         the timeUnit default value is TimeUnit. MINUTES
+     * @param maxIdleConnections the maxIdleConnections default value is 5
+     * @param keepAliveDuration  the keepAliveDuration default value is 5
+     * @param timeUnit           the timeUnit default value is TimeUnit. MINUTES
      * @return ConnectionPool
      */
     public ConnectionPool connectionPool(int maxIdleConnections, long keepAliveDuration, TimeUnit timeUnit) {
@@ -98,8 +103,7 @@ public ContentstackRegion getRegion() {
     /**
      * Sets region.
      *
-     * @param region
-     *         the region
+     * @param region the region
      * @return the region
      */
     public ContentstackRegion setRegion(ContentstackRegion region) {
@@ -119,20 +123,10 @@ public void setPlugins(List<ContentstackPlugin> plugins) {
         this.plugins = plugins;
     }
 
-    /**
-     * Gets host.
-     *
-     * @return the host
-     */
-    public String getHost() {
-        return host;
-    }
-
     /**
      * Sets host.
      *
-     * @param hostName
-     *         the host name
+     * @param hostName the host name
      */
     public void setHost(String hostName) {
         if (hostName != null && !hostName.isEmpty()) {
@@ -152,8 +146,7 @@ public String getVersion() {
     /**
      * Enable live preview config.
      *
-     * @param enableLivePreview
-     *         to enable live preview
+     * @param enableLivePreview to enable live preview
      * @return the config
      */
     public Config enableLivePreview(boolean enableLivePreview) {
@@ -164,8 +157,7 @@ public Config enableLivePreview(boolean enableLivePreview) {
     /**
      * Sets live preview host.
      *
-     * @param livePreviewHost
-     *         the live preview host
+     * @param livePreviewHost the live preview host
      * @return the live preview host
      */
     public Config setLivePreviewHost(@NotNull String livePreviewHost) {
@@ -181,8 +173,7 @@ protected Config setLivePreviewEntry(@NotNull JSONObject livePreviewEntry) {
     /**
      * Sets management token.
      *
-     * @param managementToken
-     *         the management token
+     * @param managementToken the management token
      * @return the management token
      */
     public Config setManagementToken(@NotNull String managementToken) {
@@ -197,4 +188,24 @@ public enum ContentstackRegion {
         US, EU, AZURE_NA, AZURE_EU
     }
 
+
+    /**
+     * To initialize the SDK with the latest features offered in the early access phase,
+     * include the early access parameter as shown in the following code:
+     *
+     * @param earlyAccessFeatures The list of Early Access Features
+     *                            {@code
+     *                            Config config = new Config();
+     *                            String[] earlyAccess = {"Taxonomy", "Teams", "Terms", "LivePreview"};
+     *                            config.earlyAccess(earlyAccess);
+     *                            Stack stack = Contentstack.stack(API_KEY, DELIVERY_TOKEN, ENV, config);
+     *                            <p>
+     *                            }
+     * @return Config
+     */
+    public Config earlyAccess(@NotNull String[] earlyAccessFeatures) {
+        this.earlyAccess = earlyAccessFeatures;
+        return this;
+    }
+
 }

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

@@ -21,7 +21,7 @@
 public class Constants {
 
     private static final Logger logger = Logger.getLogger(Constants.class.getSimpleName());
-    protected static final String SDK_VERSION = "1.12.3";
+    protected static final String SDK_VERSION = "1.13.0";
     protected static final String ENVIRONMENT = "environment";
     protected static final String CONTENT_TYPE_UID = "content_type_uid";
     protected static final String ENTRY_UID = "entry_uid";

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

@@ -31,27 +31,23 @@ protected Contentstack() throws IllegalAccessException {
      * key of your stack. <br>
      * Find Your Stack Credentials from Contentstack .
      *
-     * @param stackApiKey
-     *                      The API Key is a unique key assigned to each stack.
-     * @param deliveryToken
-     *                      The Delivery Token is a read-only credential that you
+     * @param stackApiKey   The API Key is a unique key assigned to each stack.
+     * @param deliveryToken The Delivery Token is a read-only credential that you
      *                      can create for different environments of your
      *                      stack
-     * @param environment
-     *                      the environment for the stack
+     * @param environment   the environment for the stack
      * @return the stack
-     * @throws IllegalAccessException
-     *                                the illegal access exception
+     * @throws IllegalAccessException the illegal access exception
      *                                <p>
      *                                <b>Example</b>
      *
      *                                <pre>
-     *                                {
-     *                                    &#64;Code
-     *                                    Stack stack = contentstack.Stack("apiKey", "deliveryToken", "environment");
-     *                                }
+     *                                                                                              {
+     *                                                                                                  &#64;Code
+     *                                                                                                  Stack stack = contentstack.Stack("apiKey", "deliveryToken", "environment");
+     *                                                                                              }
      *
-     *                                </pre>
+     *                                                                                              </pre>
      */
     public static Stack stack(String stackApiKey, String deliveryToken, String environment)
             throws IllegalAccessException {
@@ -66,6 +62,7 @@ public static Stack stack(String stackApiKey, String deliveryToken, String envir
      * create content structures, content entries, users, etc. related to the
      * project.
      *
+
      * @param stackApiKey
      *                      The API Key is a unique key assigned to each stack.
      * @param deliveryToken
@@ -115,6 +112,10 @@ private static Stack initializeStack(String stackApiKey, String deliveryToken, S
         if (config.getBranch() != null && !config.getBranch().isEmpty()) {
             stack.setHeader("branch", config.getBranch());
         }
+        if (config.getEarlyAccess() != null && config.getEarlyAccess().length > 0) {
+            String eaValues = String.join(",", config.earlyAccess).replace("\"", "");
+            stack.setHeader("x-header-ea", eaValues);
+        }
         stack.setConfig(config);
         return stack;
     }