[2.0.x] Add OpenAPI resource annotation for the mapping example details into OAS

[lnash94]

Purpose

ballerina-platform/ballerina-library#5983
As the first phase, we only support the below attribute metadata in suggested annotation

• operationId
• tags
• summary
• examples of response

Manually tested and integration test will be added after updating http version with this fix :
ballerina-platform/module-ballerina-http#2041

// AUTO-GENERATED FILE.
// This file is auto-generated by the Ballerina OpenAPI tool.

import ballerina/http;

listener http:Listener ep0 = new (8080, config = {host: "localhost"});

service / on ep0 {
    @openapi:ResourceInfo {
        operationId: "petId",
        tags: ["pets", "food"],
       summary: "Retrieve pet",
        examples: {
            "response": {
                "200":
                    {
                    "examples": {
                        "application/json": {
                            "pet1": {
                                "value": {
                                    "name": "Rova",
                                    "age": 5
                                }
                            },
                            "pet2": {
                                "value": {
                                    "name": "Tommoy",
                                    "age": 5
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    resource function get pet() returns record {} {
        return {};
    }
}

Generated code:

...
paths:
  /pet:
    get:
      tags:
      - pets
      - food
      summary: Retrieve pet
      operationId: petId
      responses:
        "200":
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                pet1:
                  value:
                    name: Rova
                    age: 5
                pet2:
                  value:
                    name: Tommoy
                    age: 5

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarCloud

[lnash94]

This PR fix is for the preview state. The feature will be improved with the upcoming release.