Added customization in codegen to generate additional builder methods

[joviegas]

Motivation and Context

• Provide API in S3AsyncClient to create instance of S3CrtAsyncClient .

Customization.config

  "additionalBuilderMethods": [
      {
        "methodName": "crtBuilder",
        "clientTypes": ["async"],
        "instanceType": "software.amazon.awssdk.services.s3.internal.crt.S3CrtAsyncClient",
        "returnType": "software.amazon.awssdk.services.s3.internal.crt.S3CrtAsyncClient.S3CrtAsyncClientBuilder"
      }
  ],

S3AsyncClient.java

    /**
     * Create a builder that can be used to configure and create a {@link S3CrtAsyncClient}
     */
    static S3CrtAsyncClientBuilder crtBuilder() {
        return S3CrtAsyncClient.builder();
    }

Modifications

• Added custom config in codegen to generate additional builders if specified.

Testing

• Junits
• Integ test updated with the new builder.

Screenshots (if appropriate)

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)

License

• I confirm that this pull request can be released under the Apache 2 license

[zoewangg]

minor: should this be singular clientType since we know for sure that sync and async don't share the same instanceType and returnType?

[joviegas]

IMO keeping clientTypes will give us flexibility to add some builders of CustomLibraries which needs to be both in Sync and Async in future.

[zoewangg]

Yeah, but sync and async clients will most likely have different instanceTypes and returnTypes, eg: S3AsyncClientBuilder and S3ClientBuilder, so I think we will probably never use "clientTypes": ["async", "sync"] in reality and we will probably have something like below:

"additionalBuilderMethods": [
        {
          "methodName": "builderOne",
          "clientTypes": ["sync"],
          "instanceType": "software.amazon.awssdk.services.builder.DefaultBuilder",
          "returnType": "software.amazon.awssdk.services.builder.CustomBuilder"
        },
        {
          "methodName": "builderOne",
          "clientTypes": ["async"],
          "instanceType": "software.amazon.awssdk.services.builder.DefaultAsyncBuilder",
          "returnType": "software.amazon.awssdk.services.builder.CustomAsyncBuilder"
        }

[joviegas]

Done

[sonarcloud]

SonarCloud Quality Gate failed.   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
6 Code Smells

79.4% Coverage
0.0% Duplication

[zoewangg]

Is it case sensitive?

[joviegas]

Nope, handled in the code not to be case sensitive