Add jsondata:Name and http:Header mapping for record fields in the OpenAPI generation

[TharmiganK]

Purpose

$Subject

Fixes: ballerina-platform/ballerina-library#7014

This PR also address the mapping for header annotation with a record type:

TODO: Add tests for header once it is supported in HTTP

import ballerina/data.jsondata;
import ballerina/http;

public type Album record {|
    string artist;
    @jsondata:Name {value: "_id"}
    string id;
    string title;
|};

public type Headers record {|
    @http:Header {name: "X-API-VERSION"}
    string? xAPIVERSION = "v1";
|};

@http:ServiceConfig {basePath: "/api/v1"}
type OASServiceType service object {
    *http:ServiceContract;
    resource function get albums(@http:Header Headers xAPIVERSION) returns Album[];
};

...
  /albums:
    get:
      operationId: getAlbums
      parameters:
      - name: X-API-VERSION
        in: header
        schema:
          type: string
          nullable: true
          default: v1
...

[sonarcloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarCloud