Template utility methods

Author: acoburn

access-grant/src/main/java/com/inrupt/client/accessgrant/AccessRequest.java

@@ -145,6 +145,33 @@ static AccessRequest parse(final String serialization) throws IOException {
         }
     }
 
+    /**
+     * Produce a URI template that can be used consistently with the JCL.
+     *
+     * @param dataPath the data path relative to a storage root
+     * @return a URI template
+     */
+    public static String template(final String dataPath) {
+        Objects.requireNonNull(dataPath, "dataPath may not be null!");
+        if (!dataPath.startsWith("/")) {
+            return "https://{domain}/{+path}/" + dataPath;
+        }
+        return template("/" + dataPath);
+    }
+
+    /**
+     * Produce a Map of template values that can be used with a URI template resolver.
+     *
+     * @param domain the domain of the user's storage
+     * @param path the base path of the user's storage
+     * @return a map of template values
+     */
+    public static Map<String, String> templateValues(final String domain, final String path) {
+        Objects.requireNonNull(domain, "domain may not be null!");
+        Objects.requireNonNull(path, "path may not be null!");
+        return Map.of("domain", domain, "path", path);
+    }
+
     /**
      * A collection of parameters used for creating access requests.
      *

access-grant/src/test/java/com/inrupt/client/accessgrant/AccessRequestTest.java

@@ -272,4 +272,18 @@ void testInvalidStream() throws IOException {
     void testInvalidString() throws IOException {
         assertThrows(IllegalArgumentException.class, () -> AccessRequest.of("not json"));
     }
+
+    @Test
+    void testTemplate() {
+        assertEquals("https://{domain}/{+path}/custom-path", AccessRequest.template("custom-path"));
+        assertEquals("https://{domain}/{+path}/custom-path", AccessRequest.template("/custom-path"));
+        assertEquals("https://{domain}/{+path}/./custom-path", AccessRequest.template("./custom-path"));
+    }
+
+    @Test
+    void testTemplateValues() {
+        final var values = AccessRequest.templateValues("mydomain.com", "/storage/path");
+        assertEquals("mydomain.com", values.get("domain"));
+        assertEquals("/storage/path", values.get("path"));
+    }
 }