v0.1.0

Author: ishaileshmishra

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "java.configuration.updateBuildConfiguration": "automatic"
+}

changelog.md

@@ -1,4 +1,7 @@
+# Changelog
+
+## v0.1.0
+
+### 20-OCT-2022
 
-## v1.0.0
-#### 03-SEP-2021
 Initial release for Contentstack CMA base Java management SDK

pom.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.contentstack.sdk</groupId>
     <artifactId>cms</artifactId>
@@ -77,7 +76,7 @@
     </distributionManagement>
 
     <properties>
-        <sdk.version>1.0.0-SNAPSHOT</sdk.version>
+        <sdk.version>0.1.0-SNAPSHOT</sdk.version>
         <sdk.version.snapshot>${sdk.version}-SNAPSHOT</sdk.version.snapshot>
         <maven.compiler.target>1.8</maven.compiler.target>
         <maven.compiler.source>1.8</maven.compiler.source>
@@ -337,7 +336,7 @@
                                         </goals>
                                     </pluginExecutionFilter>
                                     <action>
-                                        <ignore/>
+                                        <ignore />
                                     </action>
                                 </pluginExecution>
                             </pluginExecutions>

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

@@ -27,8 +27,8 @@
 /**
  * <b>Contentstack Java Management SDK</b>
  * <br>
- * <b>Contentstack Java Management SDK</b> interact with the Content Management APIs and allow you to create, update,
- * delete, and fetch content from your Contentstack account. They are read-write in nature.
+ * <b>Java Management SDK</b> Interact with the Content Management APIs and allow you to create, update,
+ * delete, and fetch content from your Contentstack account. (They are read-write in nature.)
  * <br>
  * You can use them to build your own apps and manage your content from Contentstack.
  */
@@ -330,7 +330,7 @@ public Stack stack() {
      * @return the stack instance
      */
     public Stack stack(@NotNull Map<String, Object> header) {
-        if (this.authtoken == null && header.size() == 0)
+        if (this.authtoken == null && !header.containsKey(AUTHORIZATION) && header.get(AUTHORIZATION) == null)
             throw new IllegalStateException(PLEASE_LOGIN);
         return new Stack(this.instance, header);
     }
@@ -355,14 +355,41 @@ public Stack stack(@NotNull Map<String, Object> header) {
      * @return the stack instance
      */
     public Stack stack(@NotNull String apiKey, @NotNull String managementToken) {
-        if (this.authtoken == null)
-            throw new IllegalStateException(PLEASE_LOGIN);
         HashMap<String, Object> headers = new HashMap<>();
         headers.put(API_KEY, apiKey);
         headers.put(AUTHORIZATION, managementToken);
         return new Stack(this.instance, headers);
     }
 
+
+    /**
+     * <a href= "https://www.contentstack.com/docs/developers/apis/content-management-api/#stacks">stack</a> A stack is
+     * a space that stores the content of a project (a web or mobile property). Within a stack, you can create content
+     * structures, content entries, users, etc. related to the project
+     * <p>
+     * <b> Example </b>
+     *
+     * <pre>
+     * Contentstack client = new Contentstack.Builder().build();
+     * Stack org = client.stack();
+     * </pre>
+     *
+     * @param key
+     *         You can provide apiKey of the stack or branchKey
+     * @return the stack instance
+     */
+    public Stack stack(@NotNull String key) {
+        HashMap<String, Object> headers = new HashMap<>();
+        if (key.startsWith("blt")) {
+            // In the case of API_Key provided
+            headers.put(API_KEY, key);
+        } else {
+            // In case of branch provided
+            headers.put(BRANCH, key);
+        }
+        return new Stack(this.instance, headers);
+    }
+
     /**
      * <a href= "https://www.contentstack.com/docs/developers/apis/content-management-api/#stacks">stack</a> A stack is
      * a space that stores the content of a project (a web or mobile property). Within a stack, you can create content
@@ -384,8 +411,6 @@ public Stack stack(@NotNull String apiKey, @NotNull String managementToken) {
      * @return the stack instance
      */
     public Stack stack(@NotNull String apiKey, @NotNull String managementToken, @NotNull String branch) {
-        if (this.authtoken == null)
-            throw new IllegalStateException(PLEASE_LOGIN);
         HashMap<String, Object> headers = new HashMap<>();
         headers.put(API_KEY, apiKey);
         headers.put(AUTHORIZATION, managementToken);

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

@@ -10,14 +10,17 @@
 /**
  * <b>The type Header interceptor that extends Interceptor</b>
  * <p>
- * Interceptors are a powerful way to customize requests with Retrofit. A common use-case where you want to intercept
- * the actual request is to observe, modifies, and potentially short-circuits requests going out and the corresponding
- * responses coming back in. Typically, interceptors add, remove, or transform headers on the request. Depending on the
- * API implementation, you'll want to pass the auth token as the value for the Authorization header.
+ * Interceptors are a powerful way to customize requests with Retrofit. A common
+ * use-case where you want to intercept
+ * the actual request is to observe, modifies, and potentially short-circuits
+ * requests going out and the corresponding
+ * responses coming back in. Typically, interceptors add, remove, or transform
+ * headers on the request. Depending on the
+ * API implementation, you'll want to pass the auth token as the value for the
+ * Authorization header.
  *
  * @author ***REMOVED***
- * @version 1.0.0
- * @since 2022-05-19
+ * @since v0.1.0
  */
 public class AuthInterceptor implements Interceptor {
 

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

@@ -8,8 +8,8 @@
  * The Contentstack Logger
  *
  * @author ***REMOVED***
- * @version 1.0.0
- * @since 2022-05-19
+ * @version v0.1.0
+ * @since 2022-10-20
  */
 public class CMALogger {
 

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

@@ -13,8 +13,8 @@
  * Contentstack Response:
  *
  * @author ***REMOVED***
- * @version 1.0.0
- * @since 2022-05-19
+ * @version v0.1.0
+ * @since 2022-10-20
  */
 
 public class CMAResponseConvertor {

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

@@ -4,9 +4,11 @@
  * CMARuntimeException that extends Exception class
  *
  * @author ***REMOVED***
- * @version 1.0.0
- * @since 2022-05-19
+ * @version v0.1.0
+ * @since 2022-10-20
  */
-public class CMARuntimeException extends Exception { public CMARuntimeException(String message) {
+public class CMARuntimeException extends Exception {
+    public CMARuntimeException(String message) {
         super(message);
-    }}
+    }
+}

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

@@ -6,14 +6,14 @@
 
 import java.io.IOException;
 
-
 /**
- * The ContentstackResponse is the response when we execute the API Response, ContentstackResponse contains different
+ * The ContentstackResponse is the response when we execute the API Response,
+ * ContentstackResponse contains different
  * response type
  *
  * @author ***REMOVED***
- * @version 1.0.0
- * @since 2022-05-19
+ * @version v0.1.0
+ * @since 2022-10-20
  */
 class ContentstackResponse<T> {
 

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

@@ -0,0 +1,21 @@
+package com.contentstack.cms.core;
+
+public class NullKeyException extends Exception {
+
+    public NullKeyException() {
+        super();
+    }
+
+    /**
+     * Constructs a new exception with the specified detail message.  The
+     * cause is not initialized, and may subsequently be initialized by
+     * a call to {@link #initCause}.
+     *
+     * @param   message   the detail message. The detail message is saved for
+     *          later retrieval by the {@link #getMessage()} method.
+     */
+    public NullKeyException(String message) {
+        super(message);
+    }
+
+}