http-client-java, support apiVersions property in metadata.json

.chronus/changes/http-client-java_update-metadata-file-2026-1-14-14-41-22.md

@@ -0,0 +1,7 @@
+---
+changeKind: feature
+packages:
+  - "@typespec/http-client-java"
+---
+
+Support apiVersions in metadata.json file.

packages/http-client-java/emitter/src/code-model-builder.ts

@@ -313,6 +313,13 @@ export class CodeModelBuilder {
     this.sdkContext = await createSdkContext(this.emitterContext, LIB_NAME, sdkContextOptions);
     this.program.reportDiagnostics(this.sdkContext.diagnostics);
 
+    // metadata
+    if (this.sdkContext.sdkPackage.metadata.apiVersions) {
+      this.codeModel.apiVersionMap = Object.fromEntries(
+        this.sdkContext.sdkPackage.metadata.apiVersions,
+      );
+    }
+
     // license
     if (this.sdkContext.sdkPackage.licenseInfo) {
       this.codeModel.info.license = new License(this.sdkContext.sdkPackage.licenseInfo.name, {

packages/http-client-java/emitter/src/common/client.ts

@@ -20,7 +20,7 @@ export interface Client extends Aspect {
 
   security: Security;
 
-  serviceVersion?: ServiceVersion; // apiVersions is in
+  serviceVersion?: ServiceVersion; // for ServiceVersion class
 
   /**
    * Parent client of this client, if exists.

packages/http-client-java/emitter/src/common/code-model.ts

@@ -22,6 +22,8 @@ export interface CodeModel extends Metadata {
   clients: Array<Client>;
 
   arm?: boolean;
+
+  apiVersionMap?: Record<string, string>;
 }
 
 export class CodeModel extends Metadata implements CodeModel {

packages/http-client-java/generator/http-client-generator-clientcore-test/src/main/resources/META-INF/authentication-apikey_metadata.json

@@ -1 +1 @@
-{"flavor":"generic","crossLanguageDefinitions":{"authentication.apikey.ApiKeyClient":"Authentication.ApiKey","authentication.apikey.ApiKeyClientBuilder":"Authentication.ApiKey","authentication.apikey.InvalidAuth":"Authentication.ApiKey.InvalidAuth"},"generatedFiles":["src/main/java/authentication/apikey/ApiKeyClient.java","src/main/java/authentication/apikey/ApiKeyClientBuilder.java","src/main/java/authentication/apikey/InvalidAuth.java","src/main/java/authentication/apikey/implementation/ApiKeyClientImpl.java","src/main/java/authentication/apikey/implementation/package-info.java","src/main/java/authentication/apikey/package-info.java","src/main/java/module-info.java"]}
+{"flavor":"generic","apiVersions":{},"crossLanguageDefinitions":{"authentication.apikey.ApiKeyClient":"Authentication.ApiKey","authentication.apikey.ApiKeyClientBuilder":"Authentication.ApiKey","authentication.apikey.InvalidAuth":"Authentication.ApiKey.InvalidAuth"},"generatedFiles":["src/main/java/authentication/apikey/ApiKeyClient.java","src/main/java/authentication/apikey/ApiKeyClientBuilder.java","src/main/java/authentication/apikey/InvalidAuth.java","src/main/java/authentication/apikey/implementation/ApiKeyClientImpl.java","src/main/java/authentication/apikey/implementation/package-info.java","src/main/java/authentication/apikey/package-info.java","src/main/java/module-info.java"]}

packages/http-client-java/generator/http-client-generator-clientcore-test/src/main/resources/META-INF/authentication-http-custom_metadata.json

@@ -1 +1 @@
-{"flavor":"generic","crossLanguageDefinitions":{"authentication.http.custom.CustomClient":"Authentication.Http.Custom","authentication.http.custom.CustomClientBuilder":"Authentication.Http.Custom","authentication.http.custom.InvalidAuth":"Authentication.Http.Custom.InvalidAuth"},"generatedFiles":["src/main/java/authentication/http/custom/CustomClient.java","src/main/java/authentication/http/custom/CustomClientBuilder.java","src/main/java/authentication/http/custom/InvalidAuth.java","src/main/java/authentication/http/custom/implementation/CustomClientImpl.java","src/main/java/authentication/http/custom/implementation/package-info.java","src/main/java/authentication/http/custom/package-info.java","src/main/java/module-info.java"]}
+{"flavor":"generic","apiVersions":{},"crossLanguageDefinitions":{"authentication.http.custom.CustomClient":"Authentication.Http.Custom","authentication.http.custom.CustomClientBuilder":"Authentication.Http.Custom","authentication.http.custom.InvalidAuth":"Authentication.Http.Custom.InvalidAuth"},"generatedFiles":["src/main/java/authentication/http/custom/CustomClient.java","src/main/java/authentication/http/custom/CustomClientBuilder.java","src/main/java/authentication/http/custom/InvalidAuth.java","src/main/java/authentication/http/custom/implementation/CustomClientImpl.java","src/main/java/authentication/http/custom/implementation/package-info.java","src/main/java/authentication/http/custom/package-info.java","src/main/java/module-info.java"]}

packages/http-client-java/generator/http-client-generator-clientcore-test/src/main/resources/META-INF/authentication-noauth-union_metadata.json

@@ -1 +1 @@
-{"flavor":"generic","crossLanguageDefinitions":{"authentication.noauth.union.UnionClient":"Authentication.Noauth.Union","authentication.noauth.union.UnionClientBuilder":"Authentication.Noauth.Union"},"generatedFiles":["src/main/java/authentication/noauth/union/UnionClient.java","src/main/java/authentication/noauth/union/UnionClientBuilder.java","src/main/java/authentication/noauth/union/implementation/UnionClientImpl.java","src/main/java/authentication/noauth/union/implementation/package-info.java","src/main/java/authentication/noauth/union/package-info.java","src/main/java/module-info.java"]}
+{"flavor":"generic","apiVersions":{},"crossLanguageDefinitions":{"authentication.noauth.union.UnionClient":"Authentication.Noauth.Union","authentication.noauth.union.UnionClientBuilder":"Authentication.Noauth.Union"},"generatedFiles":["src/main/java/authentication/noauth/union/UnionClient.java","src/main/java/authentication/noauth/union/UnionClientBuilder.java","src/main/java/authentication/noauth/union/implementation/UnionClientImpl.java","src/main/java/authentication/noauth/union/implementation/package-info.java","src/main/java/authentication/noauth/union/package-info.java","src/main/java/module-info.java"]}

packages/http-client-java/generator/http-client-generator-clientcore-test/src/main/resources/META-INF/authentication-oauth2_metadata.json

@@ -1 +1 @@
-{"flavor":"generic","crossLanguageDefinitions":{"authentication.oauth2.InvalidAuth":"Authentication.OAuth2.InvalidAuth","authentication.oauth2.OAuth2Client":"Authentication.OAuth2","authentication.oauth2.OAuth2ClientBuilder":"Authentication.OAuth2"},"generatedFiles":["src/main/java/authentication/oauth2/InvalidAuth.java","src/main/java/authentication/oauth2/OAuth2Client.java","src/main/java/authentication/oauth2/OAuth2ClientBuilder.java","src/main/java/authentication/oauth2/implementation/OAuth2ClientImpl.java","src/main/java/authentication/oauth2/implementation/package-info.java","src/main/java/authentication/oauth2/package-info.java","src/main/java/module-info.java"]}
+{"flavor":"generic","apiVersions":{},"crossLanguageDefinitions":{"authentication.oauth2.InvalidAuth":"Authentication.OAuth2.InvalidAuth","authentication.oauth2.OAuth2Client":"Authentication.OAuth2","authentication.oauth2.OAuth2ClientBuilder":"Authentication.OAuth2"},"generatedFiles":["src/main/java/authentication/oauth2/InvalidAuth.java","src/main/java/authentication/oauth2/OAuth2Client.java","src/main/java/authentication/oauth2/OAuth2ClientBuilder.java","src/main/java/authentication/oauth2/implementation/OAuth2ClientImpl.java","src/main/java/authentication/oauth2/implementation/package-info.java","src/main/java/authentication/oauth2/package-info.java","src/main/java/module-info.java"]}

packages/http-client-java/generator/http-client-generator-clientcore-test/src/main/resources/META-INF/authentication-union_metadata.json

@@ -1 +1 @@
-{"flavor":"generic","crossLanguageDefinitions":{"authentication.union.UnionClient":"Authentication.Union","authentication.union.UnionClientBuilder":"Authentication.Union"},"generatedFiles":["src/main/java/authentication/union/UnionClient.java","src/main/java/authentication/union/UnionClientBuilder.java","src/main/java/authentication/union/implementation/UnionClientImpl.java","src/main/java/authentication/union/implementation/package-info.java","src/main/java/authentication/union/package-info.java","src/main/java/module-info.java"]}
+{"flavor":"generic","apiVersions":{},"crossLanguageDefinitions":{"authentication.union.UnionClient":"Authentication.Union","authentication.union.UnionClientBuilder":"Authentication.Union"},"generatedFiles":["src/main/java/authentication/union/UnionClient.java","src/main/java/authentication/union/UnionClientBuilder.java","src/main/java/authentication/union/implementation/UnionClientImpl.java","src/main/java/authentication/union/implementation/package-info.java","src/main/java/authentication/union/package-info.java","src/main/java/module-info.java"]}

packages/http-client-java/generator/http-client-generator-clientcore-test/src/main/resources/META-INF/documentation_metadata.json

@@ -1 +1 @@
-{"flavor":"generic","crossLanguageDefinitions":{"documentation.DocumentationClientBuilder":"Documentation","documentation.ListsClient":"Documentation.Lists","documentation.TextFormattingClient":"Documentation.TextFormatting","documentation.lists.BulletPointsEnum":"Documentation.Lists.BulletPointsEnum","documentation.lists.BulletPointsModel":"Documentation.Lists.BulletPointsModel","documentation.lists.implementation.BulletPointsModelRequest":"Documentation.Lists.bulletPointsModel.Request.anonymous"},"generatedFiles":["src/main/java/documentation/DocumentationClientBuilder.java","src/main/java/documentation/ListsClient.java","src/main/java/documentation/TextFormattingClient.java","src/main/java/documentation/implementation/DocumentationClientImpl.java","src/main/java/documentation/implementation/ListsImpl.java","src/main/java/documentation/implementation/TextFormattingsImpl.java","src/main/java/documentation/implementation/package-info.java","src/main/java/documentation/lists/BulletPointsEnum.java","src/main/java/documentation/lists/BulletPointsModel.java","src/main/java/documentation/lists/implementation/BulletPointsModelRequest.java","src/main/java/documentation/lists/implementation/package-info.java","src/main/java/documentation/lists/package-info.java","src/main/java/documentation/package-info.java","src/main/java/module-info.java"]}
+{"flavor":"generic","apiVersions":{},"crossLanguageDefinitions":{"documentation.DocumentationClientBuilder":"Documentation","documentation.ListsClient":"Documentation.Lists","documentation.TextFormattingClient":"Documentation.TextFormatting","documentation.lists.BulletPointsEnum":"Documentation.Lists.BulletPointsEnum","documentation.lists.BulletPointsModel":"Documentation.Lists.BulletPointsModel","documentation.lists.implementation.BulletPointsModelRequest":"Documentation.Lists.bulletPointsModel.Request.anonymous"},"generatedFiles":["src/main/java/documentation/DocumentationClientBuilder.java","src/main/java/documentation/ListsClient.java","src/main/java/documentation/TextFormattingClient.java","src/main/java/documentation/implementation/DocumentationClientImpl.java","src/main/java/documentation/implementation/ListsImpl.java","src/main/java/documentation/implementation/TextFormattingsImpl.java","src/main/java/documentation/implementation/package-info.java","src/main/java/documentation/lists/BulletPointsEnum.java","src/main/java/documentation/lists/BulletPointsModel.java","src/main/java/documentation/lists/implementation/BulletPointsModelRequest.java","src/main/java/documentation/lists/implementation/package-info.java","src/main/java/documentation/lists/package-info.java","src/main/java/documentation/package-info.java","src/main/java/module-info.java"]}

packages/http-client-java/generator/http-client-generator-clientcore-test/src/main/resources/META-INF/encode-array_metadata.json

@@ -1 +1 @@
-{"flavor":"generic","crossLanguageDefinitions":{"encode.array.ArrayClient":"Encode.Array.Property","encode.array.ArrayClientBuilder":"Encode.Array","encode.array.Colors":"Encode.Array.Colors","encode.array.ColorsExtensibleEnum":"Encode.Array.ColorsExtensibleEnum","encode.array.CommaDelimitedArrayProperty":"Encode.Array.CommaDelimitedArrayProperty","encode.array.CommaDelimitedEnumArrayProperty":"Encode.Array.CommaDelimitedEnumArrayProperty","encode.array.CommaDelimitedExtensibleEnumArrayProperty":"Encode.Array.CommaDelimitedExtensibleEnumArrayProperty","encode.array.NewlineDelimitedArrayProperty":"Encode.Array.NewlineDelimitedArrayProperty","encode.array.NewlineDelimitedEnumArrayProperty":"Encode.Array.NewlineDelimitedEnumArrayProperty","encode.array.NewlineDelimitedExtensibleEnumArrayProperty":"Encode.Array.NewlineDelimitedExtensibleEnumArrayProperty","encode.array.PipeDelimitedArrayProperty":"Encode.Array.PipeDelimitedArrayProperty","encode.array.PipeDelimitedEnumArrayProperty":"Encode.Array.PipeDelimitedEnumArrayProperty","encode.array.PipeDelimitedExtensibleEnumArrayProperty":"Encode.Array.PipeDelimitedExtensibleEnumArrayProperty","encode.array.SpaceDelimitedArrayProperty":"Encode.Array.SpaceDelimitedArrayProperty","encode.array.SpaceDelimitedEnumArrayProperty":"Encode.Array.SpaceDelimitedEnumArrayProperty","encode.array.SpaceDelimitedExtensibleEnumArrayProperty":"Encode.Array.SpaceDelimitedExtensibleEnumArrayProperty"},"generatedFiles":["src/main/java/encode/array/ArrayClient.java","src/main/java/encode/array/ArrayClientBuilder.java","src/main/java/encode/array/Colors.java","src/main/java/encode/array/ColorsExtensibleEnum.java","src/main/java/encode/array/CommaDelimitedArrayProperty.java","src/main/java/encode/array/CommaDelimitedEnumArrayProperty.java","src/main/java/encode/array/CommaDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/NewlineDelimitedArrayProperty.java","src/main/java/encode/array/NewlineDelimitedEnumArrayProperty.java","src/main/java/encode/array/NewlineDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/PipeDelimitedArrayProperty.java","src/main/java/encode/array/PipeDelimitedEnumArrayProperty.java","src/main/java/encode/array/PipeDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/SpaceDelimitedArrayProperty.java","src/main/java/encode/array/SpaceDelimitedEnumArrayProperty.java","src/main/java/encode/array/SpaceDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/implementation/ArrayClientImpl.java","src/main/java/encode/array/implementation/PropertiesImpl.java","src/main/java/encode/array/implementation/package-info.java","src/main/java/encode/array/package-info.java","src/main/java/module-info.java"]}
+{"flavor":"generic","apiVersions":{},"crossLanguageDefinitions":{"encode.array.ArrayClient":"Encode.Array.Property","encode.array.ArrayClientBuilder":"Encode.Array","encode.array.Colors":"Encode.Array.Colors","encode.array.ColorsExtensibleEnum":"Encode.Array.ColorsExtensibleEnum","encode.array.CommaDelimitedArrayProperty":"Encode.Array.CommaDelimitedArrayProperty","encode.array.CommaDelimitedEnumArrayProperty":"Encode.Array.CommaDelimitedEnumArrayProperty","encode.array.CommaDelimitedExtensibleEnumArrayProperty":"Encode.Array.CommaDelimitedExtensibleEnumArrayProperty","encode.array.NewlineDelimitedArrayProperty":"Encode.Array.NewlineDelimitedArrayProperty","encode.array.NewlineDelimitedEnumArrayProperty":"Encode.Array.NewlineDelimitedEnumArrayProperty","encode.array.NewlineDelimitedExtensibleEnumArrayProperty":"Encode.Array.NewlineDelimitedExtensibleEnumArrayProperty","encode.array.PipeDelimitedArrayProperty":"Encode.Array.PipeDelimitedArrayProperty","encode.array.PipeDelimitedEnumArrayProperty":"Encode.Array.PipeDelimitedEnumArrayProperty","encode.array.PipeDelimitedExtensibleEnumArrayProperty":"Encode.Array.PipeDelimitedExtensibleEnumArrayProperty","encode.array.SpaceDelimitedArrayProperty":"Encode.Array.SpaceDelimitedArrayProperty","encode.array.SpaceDelimitedEnumArrayProperty":"Encode.Array.SpaceDelimitedEnumArrayProperty","encode.array.SpaceDelimitedExtensibleEnumArrayProperty":"Encode.Array.SpaceDelimitedExtensibleEnumArrayProperty"},"generatedFiles":["src/main/java/encode/array/ArrayClient.java","src/main/java/encode/array/ArrayClientBuilder.java","src/main/java/encode/array/Colors.java","src/main/java/encode/array/ColorsExtensibleEnum.java","src/main/java/encode/array/CommaDelimitedArrayProperty.java","src/main/java/encode/array/CommaDelimitedEnumArrayProperty.java","src/main/java/encode/array/CommaDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/NewlineDelimitedArrayProperty.java","src/main/java/encode/array/NewlineDelimitedEnumArrayProperty.java","src/main/java/encode/array/NewlineDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/PipeDelimitedArrayProperty.java","src/main/java/encode/array/PipeDelimitedEnumArrayProperty.java","src/main/java/encode/array/PipeDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/SpaceDelimitedArrayProperty.java","src/main/java/encode/array/SpaceDelimitedEnumArrayProperty.java","src/main/java/encode/array/SpaceDelimitedExtensibleEnumArrayProperty.java","src/main/java/encode/array/implementation/ArrayClientImpl.java","src/main/java/encode/array/implementation/PropertiesImpl.java","src/main/java/encode/array/implementation/package-info.java","src/main/java/encode/array/package-info.java","src/main/java/module-info.java"]}