Add HTTP service contract type support

ballerina-tests/http-advanced-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -128,7 +128,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},

ballerina-tests/http-advanced-tests/tests/service_contract_tests.bal

@@ -0,0 +1,116 @@
+// Copyright (c) 2024 WSO2 LLC. (http://www.wso2.org).
+//
+// WSO2 LLC. licenses this file to you under the Apache License,
+// Version 2.0 (the "License"); you may not use this file except
+// in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+import ballerina/crypto;
+import ballerina/http;
+import ballerina/http_test_common as common;
+import ballerina/test;
+
+final http:Client serviceContractClient = check new (string `localhost:${serviceContractTestPort}/socialMedia`);
+
+service common:Service on new http:Listener(serviceContractTestPort) {
+
+    resource function get users() returns common:User[]|error {
+        return [{id: 1, name: "Alice", email: "alice@gmail.com"}, {id: 2, name: "Bob", email: "bob@gmail.com"}];
+    }
+
+    resource function get users/[int id]() returns common:User|common:UserNotFound|error {
+        return {id: 1, name: "Alice", email: "alice@gmail.com"};
+    }
+
+    resource function post users(common:NewUser newUser) returns http:Created|error {
+        return {
+            body: {
+                message: "User created successfully"
+            }
+        };
+    }
+
+    resource function delete users/[int id]() returns http:NoContent|error {
+        return http:NO_CONTENT;
+    }
+
+    resource function get users/[int id]/posts() returns common:PostWithMeta[]|common:UserNotFound|error {
+        return [{id: 1, content: "Content 1", createdAt: "2020-01-01T10:00:00Z"}, {id: 2, content: "Content 2", createdAt: "2020-01-01T10:00:00Z"}];
+    }
+
+    resource function post users/[int id]/posts(common:NewPost newPost) returns http:Created|common:UserNotFound|common:PostForbidden|error {
+        return error("invalid post");
+    }
+
+    public function createInterceptors() returns common:ErrorInterceptor {
+        return new ();
+    }
+}
+
+@test:Config {}
+function testCachingWithServiceContract() returns error? {
+    http:Response response = check serviceContractClient->/users;
+    json payload = [{id: 1, name: "Alice", email: "alice@gmail.com"}, {id: 2, name: "Bob", email: "bob@gmail.com"}];
+    test:assertTrue(response.hasHeader(common:LAST_MODIFIED));
+    common:assertHeaderValue(check response.getHeader(common:CACHE_CONTROL), "must-revalidate,public,max-age=10");
+    common:assertHeaderValue(check response.getHeader(common:ETAG), crypto:crc32b(payload.toString().toBytes()));
+    common:assertHeaderValue(check response.getHeader(common:CONTENT_TYPE), "application/vnd.socialMedia+json");
+    common:assertJsonPayload(response.getJsonPayload(), payload);
+}
+
+@test:Config {}
+function testLinksInServiceContract() returns error? {
+    record{*http:Links; *common:User;} response = check serviceContractClient->/users/'2;
+    map<http:Link> expectedLinks = {
+        "delete-user": {
+            href: "/socialMedia/users/{id}",
+            types: ["application/vnd.socialMedia+json"],
+            methods: [http:DELETE]
+        },
+        "create-posts": {
+            href: "/socialMedia/users/{id}/posts",
+            types: ["text/vnd.socialMedia+plain"],
+            methods: [http:POST]
+        },
+        "get-posts": {
+            href: "/socialMedia/users/{id}/posts",
+            types: ["application/vnd.socialMedia+json", "text/vnd.socialMedia+plain"],
+            methods: [http:GET]
+        }
+    };
+    record{} payload = {"id": 1, "name": "Alice", "email": "alice@gmail.com", "_links": expectedLinks};
+    test:assertEquals(response, payload);
+}
+
+@test:Config {}
+function testPayloadAnnotationWithServiceContract() returns error? {
+    common:NewUser newUser = {name: "Alice", email: "alice@gmail.com"};
+    http:Response response = check serviceContractClient->/users.post(newUser);
+    test:assertEquals(response.statusCode, 415);
+    common:assertTextPayload(response.getTextPayload(), "content-type : application/json is not supported");
+
+    record{string message;} result = check serviceContractClient->/users.post(newUser, mediaType = "application/vnd.socialMedia+json");
+    test:assertEquals(result.message, "User created successfully");
+}
+
+@test:Config {}
+function testInterceptorWithServiceContract() returns error? {
+    common:NewPost newPost = {content: "sample content"};
+    http:Response response = check serviceContractClient->/users/'1/posts.post(newPost, mediaType = "application/vnd.socialMedia+json");
+    test:assertEquals(response.statusCode, 500);
+    common:assertJsonPayload(response.getTextPayload(), "invalid post");
+
+    json invalidPost = {message: "sample content"};
+    response = check serviceContractClient->/users/'1/posts.post(invalidPost, mediaType = "application/vnd.socialMedia+json");
+    test:assertEquals(response.statusCode, 400);
+    common:assertTrueTextPayload(response.getTextPayload(), "data binding failed");
+}

ballerina-tests/http-advanced-tests/tests/test_service_ports.bal

@@ -48,3 +48,5 @@ const int cookieTestPort2 = 9254;
 
 const int http1SsePort = 9094;
 const int http2SsePort = 9095;
+
+const int serviceContractTestPort = 9096;

ballerina-tests/http-client-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -124,7 +124,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},

ballerina-tests/http-dispatching-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -127,7 +127,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},

ballerina-tests/http-interceptor-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -118,7 +118,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},

ballerina-tests/http-misc-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -121,7 +121,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},

ballerina-tests/http-resiliency-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -119,7 +119,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},

ballerina-tests/http-security-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -123,7 +123,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},

ballerina-tests/http-service-tests/Dependencies.toml

@@ -5,7 +5,7 @@
 
 [ballerina]
 dependencies-toml-version = "2"
-distribution-version = "2201.9.0"
+distribution-version = "2201.10.0-20240801-104200-87df251c"
 
 [[package]]
 org = "ballerina"
@@ -124,7 +124,9 @@ name = "http_test_common"
 version = "2.12.0"
 scope = "testOnly"
 dependencies = [
+	{org = "ballerina", name = "http"},
 	{org = "ballerina", name = "lang.string"},
+	{org = "ballerina", name = "log"},
 	{org = "ballerina", name = "mime"},
 	{org = "ballerina", name = "test"},
 	{org = "ballerina", name = "time"},