Add docs to GetKey + testing

Author: artemlos

src/main/java/io/cryptolens/methods/Key.java

@@ -94,6 +94,26 @@ public static LicenseKey Activate (String token, String RSAPubKey, ActivateModel
         return LicenseKey.LoadFromString(RSAPubKey, result.RawResponse);
     }
 
+    /**
+     * Calls the GetKey method (https://app.cryptolens.io/docs/api/v3/GetKey?modelVersion=3).
+     * <p>This method allows you to retrieve the error message from the Web API.</p>
+     * <p>
+     *     To retrieve the error message, you need to initialize an APIError object and pass it in into the
+     *     "error" parameter. For example,
+     * </p>
+     * <code>
+     *     APIError error = new APIError();<br>
+     *     LicenseKey license = Key.GetKey(auth, RSAPubKey, new GetKeyModel(3349, "ICVLD-VVSZR-ZTICT-YKGXL"), error);<br>
+     *     System.out.println(error.message);
+     * </code>
+     * @param token The access token with 'GetKey' permission.
+     * @param RSAPubKey Your RSA Public Key, which can be found at https://app.cryptolens.io/docs/api/v3/QuickStart.
+     * @param model Method parameters.
+     * @param error The error object whose Message field will be populated if an error has occurred. Please initialize
+     *              this parameter, i.e. define <code>APIError error = new APIError();</code> and then pass
+     *              <code>error</code> into this parameter.
+     * @return A LicenseKey object if success and null otherwise.
+     */
     public static LicenseKey GetKey (String token, String RSAPubKey, GetKeyModel model, APIError error) {
 
         Map<String,String> extraParams = new HashMap<>();

src/test/java/io/cryptolens/KeyTest.java

@@ -1,46 +1,63 @@
 package io.cryptolens;
 
+import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
 import io.cryptolens.methods.Helpers;
 import io.cryptolens.methods.Key;
-import io.cryptolens.models.APIError;
-import io.cryptolens.models.ActivateModel;
-import io.cryptolens.models.DeactivateModel;
-import io.cryptolens.models.LicenseKey;
+import io.cryptolens.models.*;
 import junit.framework.Test;
 import junit.framework.TestCase;
 import junit.framework.TestSuite;
 
+import java.lang.reflect.Type;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+import java.util.HashMap;
+
 /**
  * Unit test for simple App.
  */
 public class KeyTest
-    extends TestCase
-{
+    extends TestCase {
+
+    HashMap<String, String> APIKey = null;
+
+
     /**
      * Create the test case
      *
      * @param testName name of the test case
      */
-    public KeyTest(String testName )
-    {
-        super( testName );
+    public KeyTest(String testName) {
+        super(testName);
     }
 
     /**
      * @return the suite of tests being tested
      */
-    public static Test suite()
-    {
-        return new TestSuite( KeyTest.class );
+    public static Test suite() {
+        return new TestSuite(KeyTest.class);
+    }
+
+    public void init() throws Exception{
+        String api_content = new String(Files.readAllBytes(Paths.get("apikeys.json")), "UTF-8");
+        Type type = new TypeToken<HashMap<String, String>>(){}.getType();
+        APIKey = new Gson().fromJson(api_content, type);
+
+        assertTrue( true );
+
     }
 
+
     /**
      * Rigourous Test :-)
      */
     public void testApp() throws Exception {
 
+        init();
+
         String RSAPubKey = "<RSAKeyValue><Modulus>sGbvxwdlDbqFXOMlVUnAF5ew0t0WpPW7rFpI5jHQOFkht/326dvh7t74RYeMpjy357NljouhpTLA3a6idnn4j6c3jmPWBkjZndGsPL4Bqm+fwE48nKpGPjkj4q/yzT4tHXBTyvaBjA8bVoCTnu+LiC4XEaLZRThGzIn5KQXKCigg6tQRy0GXE13XYFVz/x1mjFbT9/7dS8p85n8BuwlY5JvuBIQkKhuCNFfrUxBWyu87CFnXWjIupCD2VO/GbxaCvzrRjLZjAngLCMtZbYBALksqGPgTUN7ZM24XbPWyLtKPaXF2i4XRR9u6eTj5BfnLbKAU5PIVfjIS+vNYYogteQ==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
-        String auth = "WyIyNjA5IiwiaWE5b0VFT3Q2eDlNR2FvbHBHK2VOYUZ4bzNjT3h5UkNrMCtiYnhPRSJd";
+        String auth = APIKey.get("getkeyactivate");
 
         APIError error = new APIError();
 
@@ -65,7 +82,32 @@ public void testApp() throws Exception {
         //Key.Deactivate("", new DeactivateModel(3349, "ICVLD-VVSZR-ZTICT-YKGXL", Helpers.GetMachineCode()));
         System.out.println(Helpers.GetMachineCode());
 
-        assertTrue( true );
+        assertTrue(true);
 
     }
+
+
+    public void testGetKey() throws Exception {
+
+        init();
+
+        String RSAPubKey = "<RSAKeyValue><Modulus>sGbvxwdlDbqFXOMlVUnAF5ew0t0WpPW7rFpI5jHQOFkht/326dvh7t74RYeMpjy357NljouhpTLA3a6idnn4j6c3jmPWBkjZndGsPL4Bqm+fwE48nKpGPjkj4q/yzT4tHXBTyvaBjA8bVoCTnu+LiC4XEaLZRThGzIn5KQXKCigg6tQRy0GXE13XYFVz/x1mjFbT9/7dS8p85n8BuwlY5JvuBIQkKhuCNFfrUxBWyu87CFnXWjIupCD2VO/GbxaCvzrRjLZjAngLCMtZbYBALksqGPgTUN7ZM24XbPWyLtKPaXF2i4XRR9u6eTj5BfnLbKAU5PIVfjIS+vNYYogteQ==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
+        String auth = APIKey.get("getkeyactivate");
+
+        APIError error = new APIError();
+
+        LicenseKey license = Key.GetKey(auth, RSAPubKey, new GetKeyModel(3349, "ICVLD-VVSZR-ZTICT-YKGXL"), error);
+
+        if (license == null) {
+            System.out.println("The license does not work.");
+            System.out.println("Error: " + error.message);
+        } else {
+            System.out.println("The license is valid!");
+            System.out.println("It will expire: " + license.Expires);
+        }
+
+        assertTrue(true);
+
+    }
+
 }