Added Route4Me account registration. Telematics Gateway Management

Author: r4m-juan

pom.xml

@@ -4,7 +4,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.route4me</groupId>
     <artifactId>route4me-java-sdk</artifactId>
-    <version>RELEASE-1.1.4</version>
+    <version>RELEASE-1.2.0</version>
     <packaging>jar</packaging>
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
@@ -17,7 +17,7 @@
         <dependency>
             <groupId>org.apache.logging.log4j</groupId>
             <artifactId>log4j-api</artifactId>
-            <version>2.11.2</version>
+            <version>2.13.2</version>
         </dependency>
 
         <dependency>

src/main/java/com/route4me/sdk/Manager.java

@@ -8,29 +8,27 @@
 import com.google.gson.annotations.SerializedName;
 import com.route4me.sdk.exception.APIException;
 import com.route4me.sdk.queryconverter.QueryConverter;
+import java.io.*;
+import java.lang.reflect.Type;
+import java.net.URISyntaxException;
+import java.util.List;
 import org.apache.http.HttpEntity;
+import org.apache.http.HttpHost;
 import org.apache.http.NameValuePair;
+import org.apache.http.client.config.RequestConfig;
 import org.apache.http.client.entity.UrlEncodedFormEntity;
 import org.apache.http.client.methods.CloseableHttpResponse;
 import org.apache.http.client.methods.HttpEntityEnclosingRequestBase;
 import org.apache.http.client.methods.HttpRequestBase;
 import org.apache.http.client.utils.URIBuilder;
 import org.apache.http.entity.StringEntity;
-import org.apache.http.impl.client.HttpClients;
-
-import java.io.*;
-import java.lang.reflect.Type;
-import java.net.URISyntaxException;
-import java.util.List;
-import org.apache.http.HttpHost;
-import org.apache.http.client.config.RequestConfig;
 import org.apache.http.impl.client.CloseableHttpClient;
+import org.apache.http.impl.client.HttpClients;
 import org.apache.logging.log4j.LogManager;
 
 public abstract class Manager {
-    
-    protected static final org.apache.logging.log4j.Logger logger = LogManager.getLogger(Manager.class);
 
+    protected static final org.apache.logging.log4j.Logger logger = LogManager.getLogger(Manager.class);
 
     private final String apiKey;
     protected Gson gson;
@@ -184,7 +182,9 @@ private <T> T makeRequest(RequestMethod method, URIBuilder builder, HttpEntity b
                 builder.addParameter("redirect", "0");
                 client = HttpClients.custom().disableRedirectHandling().build();
             }
-            builder.addParameter("api_key", this.apiKey);
+            if (this.apiKey != null) {
+                builder.addParameter("api_key", this.apiKey);
+            }
             HttpRequestBase hrb = method.create(builder.build());
             if (requestContentType != null) {
                 hrb.setHeader("Content-type", requestContentType);
@@ -201,12 +201,12 @@ private <T> T makeRequest(RequestMethod method, URIBuilder builder, HttpEntity b
             }
             //try with resources to close streams
 
-            try ( CloseableHttpResponse resp = client.execute(hrb);  InputStream is = resp.getEntity().getContent()) {
+            try (CloseableHttpResponse resp = client.execute(hrb); InputStream is = resp.getEntity().getContent()) {
                 //response should always be present
                 if (is == null) {
                     throw new APIException("Response body is null.");
                 }
-                try ( InputStreamReader isr = new InputStreamReader(is);  BufferedReader br = new BufferedReader(isr)) {
+                try (InputStreamReader isr = new InputStreamReader(is); BufferedReader br = new BufferedReader(isr)) {
                     if (resp.getStatusLine().getStatusCode() < 200 || resp.getStatusLine().getStatusCode() > 303) {
                         try {
                             StringBuilder respString = responseContentParser(br);
@@ -218,11 +218,10 @@ private <T> T makeRequest(RequestMethod method, URIBuilder builder, HttpEntity b
                     //deserialize json into an object
                     if (clazz != null && clazz != String.class) {
                         StringBuilder respString = responseContentParser(br);
-
                         try {
                             return this.gson.fromJson(respString.toString(), clazz);
                         } catch (JsonSyntaxException ex) {
-                            throw new APIException(respString.toString());
+                            throw new APIException(ex.toString());
                         }
                     } else if (type != null) {
                         StringBuilder respString = responseContentParser(br);

src/main/java/com/route4me/sdk/examples/telematics/TelematicsCreateVendorConnection.java

@@ -0,0 +1,44 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.route4me.sdk.examples.telematics;
+
+import com.route4me.sdk.exception.APIException;
+import com.route4me.sdk.services.telematics.TelematicsConnection;
+import com.route4me.sdk.services.telematics.TelematicsManager;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ *
+ * @author Route4Me
+ */
+public class TelematicsCreateVendorConnection {
+
+    public static void main(String[] args) {
+        String apiKey = "11111111111111111111111111111111";
+        TelematicsManager manager = new TelematicsManager(apiKey);
+        TelematicsConnection credentials = new TelematicsConnection();
+
+        credentials.setVendorID(4);
+        credentials.setAccountID("12345");
+        credentials.setUsername("username");
+        credentials.setPassword("password");
+        credentials.setVehiclePositionRefreshRate(60);
+        credentials.setName("Test Connection from Java SDK");
+        credentials.setValidateRemoteCredentials("false");
+        try {
+
+            TelematicsConnection connection = manager.createTelematicsConnection("a8a60c1fccb5db60bbb9ca6a6ff71aef", credentials);
+            System.out.println(connection);
+        } catch (IllegalAccessException ex) {
+            Logger.getLogger(TelematicsCreateVendorConnection.class.getName()).log(Level.SEVERE, null, ex);
+        } catch (APIException ex) {
+            Logger.getLogger(TelematicsCreateVendorConnection.class.getName()).log(Level.SEVERE, ex.toString());
+        }
+
+    }
+
+}

src/main/java/com/route4me/sdk/examples/telematics/TelematicsDeleteVendorConnection.java

@@ -0,0 +1,35 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.route4me.sdk.examples.telematics;
+
+import com.route4me.sdk.exception.APIException;
+import com.route4me.sdk.services.telematics.TelematicsConnection;
+import com.route4me.sdk.services.telematics.TelematicsManager;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ *
+ * @author Route4Me
+ */
+public class TelematicsDeleteVendorConnection {
+
+    public static void main(String[] args) {
+        String apiKey = "11111111111111111111111111111111";
+        TelematicsManager manager = new TelematicsManager(apiKey);
+        try {
+
+            TelematicsConnection connection = manager.deleteTelematicsConnection("a8a60c1fccb5db60bbb9ca6a6ff71aef", "7DltI9rWz11HAZPL4tZPL4tz4pthRPLu3AvuM");
+            System.out.println(connection);
+        } catch (IllegalAccessException ex) {
+            Logger.getLogger(TelematicsDeleteVendorConnection.class.getName()).log(Level.SEVERE, null, ex);
+        } catch (APIException ex) {
+            Logger.getLogger(TelematicsDeleteVendorConnection.class.getName()).log(Level.SEVERE, ex.toString());
+        }
+
+    }
+
+}

src/main/java/com/route4me/sdk/examples/telematics/TelematicsGetConnections.java

@@ -0,0 +1,32 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.route4me.sdk.examples.telematics;
+
+import com.route4me.sdk.exception.APIException;
+import com.route4me.sdk.services.telematics.TelematicsConnection;
+import com.route4me.sdk.services.telematics.TelematicsManager;
+import java.util.List;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ *
+ * @author Route4Me
+ */
+public class TelematicsGetConnections {
+
+    public static void main(String[] args) {
+        String apiKey = "11111111111111111111111111111111";
+        TelematicsManager manager = new TelematicsManager(apiKey);
+        try {
+            List<TelematicsConnection> connections = manager.getTelematicsConnections("a8a60c1fccb5db60bbb9ca6a6ff71aef");
+            System.out.println(connections);
+        } catch (APIException ex) {
+            Logger.getLogger(TelematicsGetConnections.class.getName()).log(Level.SEVERE, ex.toString());
+        }
+    }
+
+}

src/main/java/com/route4me/sdk/examples/telematics/TelematicsGetVendorConnection.java

@@ -0,0 +1,35 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.route4me.sdk.examples.telematics;
+
+import com.route4me.sdk.exception.APIException;
+import com.route4me.sdk.services.telematics.TelematicsConnection;
+import com.route4me.sdk.services.telematics.TelematicsManager;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ *
+ * @author Route4Me
+ */
+public class TelematicsGetVendorConnection {
+
+    public static void main(String[] args) {
+        String apiKey = "11111111111111111111111111111111";
+        TelematicsManager manager = new TelematicsManager(apiKey);
+        try {
+
+            TelematicsConnection connection = manager.getTelematicsConnection("a8a60c1fccb5db60bbb9ca6a6ff71aef", "7DltI9rWz11HAZPL4tZPL4tz4pthRPLu3AvuM");
+            System.out.println(connection);
+        } catch (IllegalAccessException ex) {
+            Logger.getLogger(TelematicsGetVendorConnection.class.getName()).log(Level.SEVERE, null, ex);
+        } catch (APIException ex) {
+            Logger.getLogger(TelematicsGetVendorConnection.class.getName()).log(Level.SEVERE, ex.toString());
+        }
+
+    }
+
+}

src/main/java/com/route4me/sdk/examples/telematics/TelematicsGetVendorInfo.java

@@ -0,0 +1,34 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.route4me.sdk.examples.telematics;
+
+import com.route4me.sdk.exception.APIException;
+import com.route4me.sdk.services.telematics.TelematicsManager;
+import com.route4me.sdk.services.telematics.TelematicsVendorsInfo;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ *
+ * @author Route4Me
+ */
+public class TelematicsGetVendorInfo {
+
+    public static void main(String[] args) {
+        String apiKey = "11111111111111111111111111111111";
+        TelematicsManager manager = new TelematicsManager(apiKey);
+
+        try {
+            TelematicsVendorsInfo vendor = manager.getTelematicsVendorInfo("3");
+            System.out.println(vendor.getVendor());
+
+        } catch (APIException ex) {
+            Logger.getLogger(TelematicsRegisterMember.class.getName()).log(Level.INFO, ex.toString());
+        }
+
+    }
+
+}

src/main/java/com/route4me/sdk/examples/telematics/TelematicsGetVendorsInfo.java

@@ -0,0 +1,37 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.route4me.sdk.examples.telematics;
+
+import com.route4me.sdk.exception.APIException;
+import com.route4me.sdk.services.telematics.TelematicsManager;
+import com.route4me.sdk.services.telematics.TelematicsVendorInfo;
+import com.route4me.sdk.services.telematics.TelematicsVendorsInfo;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ *
+ * @author Route4Me
+ */
+public class TelematicsGetVendorsInfo {
+
+    public static void main(String[] args) {
+        String apiKey = "11111111111111111111111111111111";
+        TelematicsManager manager = new TelematicsManager(apiKey);
+
+        try {
+            TelematicsVendorsInfo vendors = manager.getTelematicsVendorsInfo();
+            for (TelematicsVendorInfo vendor : vendors.getVendors()) {
+                System.out.println(vendor);
+
+            }
+        } catch (APIException ex) {
+            Logger.getLogger(TelematicsRegisterMember.class.getName()).log(Level.INFO, ex.toString());
+        }
+
+    }
+
+}

src/main/java/com/route4me/sdk/examples/telematics/TelematicsRegisterMember.java

@@ -0,0 +1,32 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.route4me.sdk.examples.telematics;
+
+import com.route4me.sdk.exception.APIException;
+import com.route4me.sdk.services.telematics.TelematicsManager;
+import com.route4me.sdk.services.telematics.TelematicsMemberRegister;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ *
+ * @author Route4Me
+ */
+public class TelematicsRegisterMember {
+
+    public static void main(String[] args) {
+        String apiKey = "11111111111111111111111111111111";
+        TelematicsManager manager = new TelematicsManager(apiKey);
+
+        try {
+            TelematicsMemberRegister register = manager.registerMember(1);
+            System.out.println(register);
+        } catch (APIException ex) {
+            Logger.getLogger(TelematicsRegisterMember.class.getName()).log(Level.INFO, ex.toString());
+        }
+    }
+
+}