Merge pull request #4624 from irunika/http-matrix-param-support

[HTTP] Sample Update for Matrix Parameters

docs/ballerina-by-example/examples.txt

@@ -55,7 +55,7 @@ File API
 Throw
 Try/Catch/Finally
 Base Path and Path
-Query and Path Param
+Query, Path and Matrix Param
 Content Based Routing
 Header Based Routing
 Produces/Consumes

docs/ballerina-by-example/examples/query-path-and-matrix-param/query-and-path-param.client.sh

@@ -0,0 +1,9 @@
+$ curl "http://localhost:9090/sample/path;a=4;b=5/value1;x=10;y=15?bar=value2"
+{
+    "pathParam": "value1",
+    "queryParam": "value2",
+    "matrix": {
+        "path": "a=4, b=5",
+        "foo": "x=10, y=15"
+    }
+}

docs/ballerina-by-example/examples/query-and-path-param/query-and-path-param.bal → docs/ballerina-by-example/examples/query-path-and-matrix-param/query-path-and-matrix-param.bal

@@ -11,8 +11,20 @@ service<http> sample {
         // Get QueryParam.
         map params = req.getQueryParams();
         var bar, _ = (string)params.bar;
+
+        // Get Matrix params
+        map pathMParams = req.getMatrixParams("/sample/path");
+        var a, _ = (string)pathMParams.a;
+        var b, _ = (string)pathMParams.b;
+        string pathMatrixStr = string `a={{a}}, b={{b}}`;
+        map fooMParams = req.getMatrixParams("/sample/path/" + foo);
+        var x, _ = (string)fooMParams.x;
+        var y, _ = (string)fooMParams.y;
+        string fooMatrixStr = string `x={{x}}, y={{y}}`;
+        json matrixJson = {"path":pathMatrixStr, "foo":fooMatrixStr};
+
         // Create json payload with the extracted values.
-        json responseJson = {"pathParam":foo, "queryParam":bar};
+        json responseJson = {"pathParam":foo, "queryParam":bar, "matrix":matrixJson};
         http:OutResponse res = {};
         // A util method to set the json payload to the response message.
         res.setJsonPayload(responseJson);

docs/ballerina-by-example/examples/query-path-and-matrix-param/query-path-and-matrix-param.description

@@ -0,0 +1 @@
+// Ballerina support extracting values PathParam, QueryParam and MatrixParam.

docs/ballerina-by-example/examples/query-path-and-matrix-param/query-path-and-matrix-param.server.sh

@@ -0,0 +1,3 @@
+$ ballerina run query-path-and-matrix-param.bal
+ballerina: deploying service(s) in '.../query-path-and-matrix-param.bal'
+ballerina: started HTTP/WS server connector 0.0.0.0:9090