Merge pull request #1794 from SachinAkash01/relaxed-data-binding

Refactor Descriptions for `laxDataBinding` Support

openapi-cli/src/test/java/io/ballerina/openapi/generators/common/TestConstants.java

@@ -39,11 +39,9 @@ public class TestConstants {
             "    # Enables the inbound payload validation functionality which provided by the constraint package. " +
             "Enabled by default\n" +
             "    boolean validation = true;\n" +
-            "    # Enables or disables relaxed data binding on the client side. Disabled by default.\n" +
-            "    # When enabled, the JSON data will be projected to the Ballerina record type and during the " +
-            "projection, \n" +
-            "    # nil values will be considered as optional fields and absent fields will be considered for " +
-            "nilable types\n" +
+            "    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated " +
+            "as optional,\n" +
+            "    # and absent fields are handled as `nilable` types. Enabled by default.\n" +
             "    boolean laxDataBinding = true;\n" +
             "|};";
 
@@ -216,11 +214,9 @@ public class TestConstants {
             "    # Enables the inbound payload validation functionality which provided by the constraint package. " +
             "Enabled by default\n" +
             "    boolean validation = true;\n" +
-            "    # Enables or disables relaxed data binding on the client side. Disabled by default.\n" +
-            "    # When enabled, the JSON data will be projected to the Ballerina record type and during the " +
-            "projection, \n" +
-            "    # nil values will be considered as optional fields and absent fields will be considered for " +
-            "nilable types\n" +
+            "    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated " +
+            "as optional,\n" +
+            "    # and absent fields are handled as `nilable` types. Enabled by default.\n" +
             "    boolean laxDataBinding = true;\n" +
             "|};";
     public static final String CONNECTION_CONFIG_MIXED_AUTH = "" +
@@ -260,11 +256,9 @@ public class TestConstants {
             "    # Enables the inbound payload validation functionality which provided by the constraint package. " +
             "Enabled by default\n" +
             "    boolean validation = true;\n" +
-            "    # Enables or disables relaxed data binding on the client side. Disabled by default.\n" +
-            "    # When enabled, the JSON data will be projected to the Ballerina record type and during the " +
-            "projection, \n" +
-            "    # nil values will be considered as optional fields and absent fields will be considered for " +
-            "nilable types\n" +
+            "    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated " +
+            "as optional,\n" +
+            "    # and absent fields are handled as `nilable` types. Enabled by default.\n" +
             "    boolean laxDataBinding = true;\n" +
             "|};";
 
@@ -302,11 +296,9 @@ public class TestConstants {
             "    # Enables the inbound payload validation functionality which provided by the constraint package. " +
             "    Enabled by default\n" +
             "    boolean validation = true;\n" +
-            "    # Enables or disables relaxed data binding on the client side. Disabled by default.\n" +
-            "    # When enabled, the JSON data will be projected to the Ballerina record type and during the " +
-            "projection,\n" +
-            "    # nil values will be considered as optional fields and absent fields will be considered for " +
-            "nilable types\n" +
+            "    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated " +
+            "as optional,\n" +
+            "    # and absent fields are handled as `nilable` types. Enabled by default.\n" +
             "    boolean laxDataBinding = true;\n" +
             "|};";
     public static final String OAUTH2_REFRESH_TOKEN_GRANT_CONFIG_RECORD = "#OAuth2ClientCredentialsGrantConfigs" +

openapi-cli/src/test/resources/expected_gen/bal_name_ext_client.bal

@@ -353,8 +353,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/constraint_import_types.bal

@@ -64,8 +64,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/default_headers_conflict_with_query.bal

@@ -301,9 +301,8 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};
 

openapi-cli/src/test/resources/expected_gen/default_headers_queries_parameters.bal

@@ -307,9 +307,8 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};
 

openapi-cli/src/test/resources/expected_gen/default_value_generation_client.bal

@@ -324,9 +324,8 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};
 

openapi-cli/src/test/resources/expected_gen/jira_openapi_client.bal

@@ -6737,9 +6737,8 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};
 

openapi-cli/src/test/resources/expected_gen/licenses/schema.bal

@@ -77,8 +77,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/licenses/schema_for_both_service_client.bal

@@ -87,8 +87,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/licenses/schema_with_user_given_license.bal

@@ -86,8 +86,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/licenses/types_for_both_service_client_generations.bal

@@ -87,8 +87,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/non_constraint_import_types.bal

@@ -62,8 +62,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/nullable_false_types.bal

@@ -72,8 +72,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/nullable_types.bal

@@ -77,8 +77,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/petstore_schema.bal

@@ -87,8 +87,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/petstore_schema_2.bal

@@ -82,8 +82,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/petstore_schema_type.bal

@@ -74,8 +74,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/petstore_schema_with_license.bal

@@ -86,8 +86,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/sanitize_array_member.bal

@@ -330,8 +330,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/type_filtered_by_tags.bal

@@ -77,8 +77,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/expected_gen/type_name_with_mixed_case.bal

@@ -330,8 +330,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};

openapi-cli/src/test/resources/generators/client/ballerina/union_path_types.bal

@@ -58,8 +58,7 @@ public type ConnectionConfig record {|
     http:ProxyConfig proxy?;
     # Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
     boolean validation = true;
-    # Enables or disables relaxed data binding on the client side. Disabled by default.
-    # When enabled, the JSON data will be projected to the Ballerina record type and during the projection,
-    # nil values will be considered as optional fields and absent fields will be considered for nilable types
+    # Enables relaxed data binding on the client side. When enabled, `nil` values are treated as optional,
+    # and absent fields are handled as `nilable` types. Enabled by default.
     boolean laxDataBinding = true;
 |};