Add sample examples for read function

Author: SasinduDilshara

.vscode/launch.json

@@ -0,0 +1,28 @@
+{
+    "configurations": [
+        {
+            "name": "Ballerina Debug",
+            "type": "ballerina",
+            "request": "launch",
+            "programArgs": [],
+            "commandOptions": [],
+            "env": {}
+        },
+        {
+            "name": "Ballerina Test",
+            "type": "ballerina",
+            "request": "launch",
+            "debugTests": true,
+            "programArgs": [],
+            "commandOptions": [],
+            "env": {}
+        },
+        {
+            "name": "Ballerina Remote",
+            "type": "ballerina",
+            "request": "attach",
+            "debuggeeHost": "127.0.0.1",
+            "debuggeePort": "5005"
+        }
+    ]
+}

ballerina/read.bal

@@ -26,17 +26,22 @@ public type JsonPathRawTemplate object {
 };
 
 # Extract details from the given JSON value using the provided query template expression
+#
+# ```ballerina
+# read({id: 1, "name": "John Doe"}, `$.name`) => "John Doe"
+# ```
+#
 # + 'json - JSON value
 # + query - JSON path expression
 # + return - extracted details as JSON value, a jsonpath:Error otherwise
 public isolated function read(json 'json, JsonPathRawTemplate query) returns json|Error {
     return readJson('json, new JsonPathRawTemplateImpl(query));
 }
 
-public class JsonPathRawTemplateImpl {
+class JsonPathRawTemplateImpl {
     *JsonPathRawTemplate;
 
-    public isolated function init(JsonPathRawTemplate jsonPathRawTemplate) {
+    isolated function init(JsonPathRawTemplate jsonPathRawTemplate) {
         self.strings = jsonPathRawTemplate.strings;
         self.insertions = jsonPathRawTemplate.insertions;
     }
@@ -46,6 +51,6 @@ public class JsonPathRawTemplateImpl {
 # + 'json - JSON value
 # + query - JSON path expression
 # + return - extracted details as JSON value, a jsonpath:Error otherwise
-public isolated function readJson(json 'json, JsonPathRawTemplateImpl query) returns json|Error = @java:Method {
+isolated function readJson(json 'json, JsonPathRawTemplateImpl query) returns json|Error = @java:Method {
     'class: "io.ballerina.lib.data.jsonpath.BJsonPath"
 } external;

ballerina/tests/jsonpath_simple_tests.bal

@@ -484,3 +484,9 @@ function testQuery9() returns error? {
   19.95
 ]);
 }
+
+@test:Config {}
+function testQuery10() returns error? {
+    json result = check read({id: 1, "name": "John Doe"}, `$.name`);
+    test:assertEquals(result, "John Doe");
+}

build-config/resources/Ballerina.toml

@@ -18,19 +18,19 @@ artifactId = "jsondata-native"
 version = "@toml.version@"
 path = "../native/build/libs/data.jsondata-native-@project.version@.jar"
 
-[[platform.java11.dependency]]
+[[platform.java17.dependency]]
 path = "./lib/json-path-@jsonpath.version@.jar"
 groupId = "com.jayway.jsonpath"
 artifactId = "json-path"
 version = "@jsonpath.version@"
 
-[[platform.java11.dependency]]
+[[platform.java17.dependency]]
 path = "./lib/json-smart-@jsonsmart.version@.jar"
 groupId = "net.minidev.json"
 artifactId = "json-smart"
 version = "@jsonsmart.version@"
 
-[[platform.java11.dependency]]
+[[platform.java17.dependency]]
 path = "./lib/accessors-smart-@accessors.version@.jar"
 groupId = "net.minidev.json"
 artifactId = "accessors-smart"

gradle.properties

@@ -12,7 +12,7 @@ githubJohnrengelmanShadowVersion=8.1.1
 underCouchDownloadVersion=4.0.4
 researchgateReleaseVersion=2.8.0
 ballerinaGradlePluginVersion=2.0.1
-javaJsonPathVersion=2.7.0
+javaJsonPathVersion=2.9.0
 javaJsonSmartVersion=2.4.7
 javaAccessorsSmartVersion=2.4.7
 stdlibIoVersion=1.6.0