feat(grammar): Support JSON_SERIALIZE (#182)

zpa-core/src/main/kotlin/org/sonar/plugins/plsqlopen/api/PlSqlKeyword.kt

@@ -282,6 +282,7 @@ enum class PlSqlKeyword(override val value: String, val isReserved: Boolean = fa
     JSON_OBJECT("json_object"),
     JSON_OBJECTAGG("json_objectagg"),
     JSON_SCALAR("json_scalar"),
+    JSON_SERIALIZE("json_serialize"),
     JSON_QUERY("json_query"),
     KEEP("keep"),
     KEY("key"),
@@ -364,6 +365,7 @@ enum class PlSqlKeyword(override val value: String, val isReserved: Boolean = fa
     OPEN("open"),
     OPERATOR("operator"),
     OPTIMAL("optimal"),
+    ORDERED("ordered"),
     ORDINALITY("ordinality"),
     OTHERS("others"),
     OUTER("outer"),

zpa-core/src/main/kotlin/org/sonar/plugins/plsqlopen/api/SingleRowSqlFunctionsGrammar.kt

@@ -57,6 +57,7 @@ enum class SingleRowSqlFunctionsGrammar : GrammarRuleKey {
     JSON_MERGEPATCH_EXPRESSION,
     JSON_OBJECT_EXPRESSION,
     JSON_SCALAR_EXPRESSION,
+    JSON_SERIALIZE_EXPRESSION,
     JSON_QUERY_EXPRESSION,
     XMLATTRIBUTES_EXPRESSION,
     XMLELEMENT_EXPRESSION,
@@ -95,6 +96,7 @@ enum class SingleRowSqlFunctionsGrammar : GrammarRuleKey {
                     JSON_MERGEPATCH_EXPRESSION,
                     JSON_OBJECT_EXPRESSION,
                     JSON_SCALAR_EXPRESSION,
+                    JSON_SERIALIZE_EXPRESSION,
                     JSON_QUERY_EXPRESSION,
                     XMLATTRIBUTES_EXPRESSION,
                     XMLELEMENT_EXPRESSION,
@@ -368,6 +370,26 @@ enum class SingleRowSqlFunctionsGrammar : GrammarRuleKey {
                 RPARENTHESIS
             )
 
+            b.rule(JSON_SERIALIZE_EXPRESSION).define(
+                JSON_SERIALIZE,
+                LPARENTHESIS,
+                EXPRESSION,
+                b.optional(JSON_RETURNING_CLAUSE),
+                b.optional(PRETTY),
+                b.optional(ASCII),
+                b.optional(ORDERED),
+                b.optional(TRUNCATE),
+                b.optional(
+                    b.firstOf(
+                        NULL,
+                        ERROR,
+                        b.sequence(EMPTY, b.optional(b.firstOf(ARRAY, OBJECT)))
+                    ),
+                    ON, ERROR
+                ),
+                RPARENTHESIS
+            )
+
             b.rule(JSON_QUERY_EXPRESSION).define(
                 JSON_QUERY,
                 LPARENTHESIS,

zpa-core/src/test/kotlin/org/sonar/plugins/plsqlopen/api/expressions/JsonSerializeTest.kt

@@ -0,0 +1,70 @@
+/**
+ * Z PL/SQL Analyzer
+ * Copyright (C) 2015-2024 Felipe Zorzo
+ * mailto:felipe AT felipezorzo DOT com DOT br
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ */
+package org.sonar.plugins.plsqlopen.api.expressions
+
+import com.felipebz.flr.tests.Assertions.assertThat
+import org.junit.jupiter.api.BeforeEach
+import org.junit.jupiter.api.Test
+import org.sonar.plugins.plsqlopen.api.PlSqlGrammar
+import org.sonar.plugins.plsqlopen.api.RuleTest
+
+class JsonSerializeTest : RuleTest() {
+
+    @BeforeEach
+    fun init() {
+        setRootRule(PlSqlGrammar.EXPRESSION)
+    }
+
+    @Test
+    fun matchesJsonSerialize() {
+        assertThat(p).matches("json_serialize(val)")
+    }
+
+    @Test
+    fun matchesJsonSerializeWithReturning() {
+        assertThat(p).matches("json_serialize(val returning clob)")
+    }
+
+    @Test
+    fun matchesJsonSerializeSqlNullOnError() {
+        assertThat(p).matches("json_serialize(val null on error)")
+    }
+
+    @Test
+    fun matchesJsonSerializeSqlErrorOnError() {
+        assertThat(p).matches("json_serialize(val error on error)")
+    }
+
+    @Test
+    fun matchesJsonSerializeSqlEmptyArrayOnError() {
+        assertThat(p).matches("json_serialize(val empty array on error)")
+    }
+
+    @Test
+    fun matchesJsonSerializeSqlEmptyObjectOnError() {
+        assertThat(p).matches("json_serialize(val empty object on error)")
+    }
+
+    @Test
+    fun matchesLongJsonSerialize() {
+        assertThat(p).matches("json_serialize(val returning blob pretty ascii ordered truncate empty object on error)")
+    }
+
+}