Add setUserAgent and setResponseTimeoutMs methods

Author: wenbinf

README.md

@@ -54,7 +54,7 @@ You can install this library for JVM-based languages, including Java, Kotlin, Cl
 Add this dependency to your project's build file:
 
 ```groovy
-implementation "com.listennotes:podcast-api:1.0.5"
+implementation "com.listennotes:podcast-api:1.0.6"
 ```
 
 ### Maven users
@@ -65,7 +65,7 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.listennotes</groupId>
   <artifactId>podcast-api</artifactId>
-  <version>1.0.5</version>
+  <version>1.0.6</version>
 </dependency>
 ```
 
@@ -89,6 +89,12 @@ public class PodcastApiExample {
           String apiKey = System.getenv("LISTEN_API_KEY");
           Client objClient = new Client(apiKey);
 
+          // Set timeout for 15 seconds
+          objClient.setResponseTimeoutMs(15000);
+
+          // Customize your user agent
+          objClient.setUserAgent("My Great Podcast App");
+
           // All parameters can be found at
           //    https://www.listennotes.com/api/docs/
           HashMap<String, String> parameters = new HashMap<>();

gradle.properties

@@ -1,5 +1,5 @@
 GROUP_ID=com.listennotes
-VERSION_NAME=1.0.5
+VERSION_NAME=1.0.6
 
 POM_URL=https://github.com/ListenNotes/podcast-api-java
 POM_SCM_URL[email protected]:ListenNotes/podcast-api-java.git

src/main/java/com/listennotes/podcast_api/Client.java

@@ -27,15 +27,25 @@ public final class Client {
     public static final String USER_AGENT = "podcast-api-java";
 
     protected String apiKey = "";
+    protected Integer timeoutMs = 30000; // 30 seconds
+    protected String userAgent = USER_AGENT;
     protected HttpURLConnection con;
     protected Map<String, String> requestParams;
 
+    public Client() {
+        // No api key. Use api mock server.
+    }
+
     public Client(String apiKey) {
         this.apiKey = apiKey;
     }
 
-    public Client() {
-        // No api key. Use api mock server.
+    public void setResponseTimeoutMs(Integer timeoutMs) {
+        this.timeoutMs = timeoutMs;
+    }
+
+    public void setUserAgent(String userAgent) {
+        this.userAgent = userAgent;
     }
 
     public ApiResponse submitPodcast(Map<String, String> mapParams) throws ListenApiException {
@@ -155,12 +165,12 @@ public HttpURLConnection getConnection(String strUrl) throws ListenApiException
         }
 
         con.setDoOutput(true);
-        con.setRequestProperty("User-Agent", USER_AGENT);
+        con.setRequestProperty("User-Agent", this.userAgent);
         if (this.apiKey != null && this.apiKey.length() > 0) {
             con.setRequestProperty("X-ListenAPI-Key", this.apiKey);
         }
         con.setConnectTimeout(5000);
-        con.setReadTimeout(5000);
+        con.setReadTimeout(this.timeoutMs);
         con.setInstanceFollowRedirects(false);
         return con;
     }

src/main/java/com/listennotes/podcast_api/Sample.java

@@ -8,6 +8,8 @@ public static void main(String[] args) {
         try {
             String apiKey = System.getenv("LISTEN_API_KEY");
             Client objClient = new Client(apiKey);
+            objClient.setResponseTimeoutMs(15000);
+            objClient.setUserAgent("My Great Podcast App");
 
             HashMap<String, String> parameters;
             ApiResponse response;