Skip to content

[JAVA] Add generic okhttp generator #24355

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rar91279 wants to merge 7 commits into
base: master
Choose a base branch
from
Open

[JAVA] Add generic okhttp generator #24355

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
cc3300c
Add generic okhttp generator supporting Jackson 2/3, Gson and JSONB a…
rar91279 Jul 19, 2026
de650fb
Prepare for pull request:
rar91279 Jul 20, 2026
f93efde
Merge remote-tracking branch 'origin/master' into java-generic-okhttp
rar91279 Jul 20, 2026
7e874ab
Update Java generator docs to include OkHttp support for Jackson 3 an…
rar91279 Jul 20, 2026
e785b11
Update samples/client/echo_api/java/okhttp/build.sbt
rar91279 Jul 20, 2026
1b81c63
Switch to fully qualified `java.math.BigDecimal` in templates and imp…
rar91279 Jul 20, 2026
ca52004
Merge remote-tracking branch 'origin/java-generic-okhttp' into java-g…
rar91279 Jul 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
12 changes: 12 additions & 0 deletions bin/configs/java-okhttp-3.1-duplicated-operationid.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-3.1-duplicated-operationid
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_1/java/duplicated_operationid.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
validateSpec: false
additionalProperties:
artifactId: petstore-okhttp-31-do
hideGenerationTimestamp: "true"
disallowAdditionalPropertiesIfNotPresent: false
openapiNormalizer:
FIX_DUPLICATED_OPERATIONID: true
20 changes: 20 additions & 0 deletions bin/configs/java-okhttp-3.1.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-3.1
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_1/java/petstore.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
validateSpec: false
nameMappings:
_type: underscoreType
type_: typeWithUnderscore
parameterNameMappings:
_type: underscoreType
type_: typeWithUnderscore
additionalProperties:
artifactId: petstore-okhttp-31
hideGenerationTimestamp: "true"
useOneOfDiscriminatorLookup: "true"
disallowAdditionalPropertiesIfNotPresent: false
enumPropertyNaming: legacy
openapiNormalizer:
FIX_DUPLICATED_OPERATIONID: true
11 changes: 11 additions & 0 deletions bin/configs/java-okhttp-awsv4signature.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-awsv4signature
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: okhttp-awsv4signature
hideGenerationTimestamp: "true"
useOneOfDiscriminatorLookup: "true"
disallowAdditionalPropertiesIfNotPresent: false
withAWSV4Signature: true
9 changes: 9 additions & 0 deletions bin/configs/java-okhttp-dynamicOperations.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-dynamicOperations
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: petstore-okhttp-dynamicoperations
hideGenerationTimestamp: "true"
dynamicOperations: "true"
8 changes: 8 additions & 0 deletions bin/configs/java-okhttp-echo-api.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
generatorName: java
outputDir: samples/client/echo_api/java/okhttp
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/echo_api.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: echo-api-okhttp
hideGenerationTimestamp: "true"
10 changes: 10 additions & 0 deletions bin/configs/java-okhttp-group-parameter.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-group-parameter
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-group-parameter.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: petstore-okhttp-group-parameter
hideGenerationTimestamp: "true"
disallowAdditionalPropertiesIfNotPresent: false
useSingleRequestParameter: true
17 changes: 17 additions & 0 deletions bin/configs/java-okhttp-gson-user-defined-templates.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
generatorName: java
outputDir: samples/client/echo_api/java/okhttp-gson-user-defined-templates
library: okhttp-gson
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
hideGenerationTimestamp: "true"
files:
README.mustache:
destinationFilename: info.md
api_doc.mustache:
templateType: APIDocs
destinationFilename: Documentation.md
pojo.mustache:
templateType: Model
folder: modelCopy
destinationFilename: .java
26 changes: 26 additions & 0 deletions bin/configs/java-okhttp-jackson.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-jackson
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-okhttp-gson.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
nameMappings:
_type: underscoreType
type_: typeWithUnderscore
parameterNameMappings:
_type: underscoreType
type_: typeWithUnderscore
additionalProperties:
serializationLibrary: jackson
defaultToEmptyContainer: "array?|array|map?"
artifactId: petstore-okhttp-jackson
hideGenerationTimestamp: true
useOneOfDiscriminatorLookup: true
disallowAdditionalPropertiesIfNotPresent: false
useReflectionEqualsHashCode: true
removeEnumValuePrefix: true
enumNameMappings:
s: LOWER_CASE_S
S: UPPER_CASE_S
operationIdNameMappings:
getArrayOfEnums: getFakeArrayofenums
fakeHealthGet: getFakeHealth
27 changes: 27 additions & 0 deletions bin/configs/java-okhttp-jackson3.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-jackson3
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-okhttp-gson.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
nameMappings:
_type: underscoreType
type_: typeWithUnderscore
parameterNameMappings:
_type: underscoreType
type_: typeWithUnderscore
additionalProperties:
serializationLibrary: jackson
useJackson3: true
defaultToEmptyContainer: "array?|array|map?"
artifactId: petstore-okhttp-jackson3
hideGenerationTimestamp: true
useOneOfDiscriminatorLookup: true
disallowAdditionalPropertiesIfNotPresent: false
useReflectionEqualsHashCode: true
removeEnumValuePrefix: true
enumNameMappings:
s: LOWER_CASE_S
S: UPPER_CASE_S
operationIdNameMappings:
getArrayOfEnums: getFakeArrayofenums
fakeHealthGet: getFakeHealth
27 changes: 27 additions & 0 deletions bin/configs/java-okhttp-jsonb.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-jsonb
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-okhttp-gson.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
nameMappings:
_type: underscoreType
type_: typeWithUnderscore
parameterNameMappings:
_type: underscoreType
type_: typeWithUnderscore
additionalProperties:
serializationLibrary: jsonb
useJakartaEe: true
defaultToEmptyContainer: "array?|array|map?"
artifactId: petstore-okhttp-jsonb
hideGenerationTimestamp: true
useOneOfDiscriminatorLookup: true
disallowAdditionalPropertiesIfNotPresent: false
useReflectionEqualsHashCode: true
removeEnumValuePrefix: true
enumNameMappings:
s: LOWER_CASE_S
S: UPPER_CASE_S
operationIdNameMappings:
getArrayOfEnums: getFakeArrayofenums
fakeHealthGet: getFakeHealth
13 changes: 13 additions & 0 deletions bin/configs/java-okhttp-jspecify.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-jspecify
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/okhttp-jspecify.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: petstore-okhttp-jspecify
hideGenerationTimestamp: true
useJspecify: true
containerDefaultToNull: true
typeMappings:
OffsetDateTime: java.time.Instant
BigDecimal: java.math.BigDecimal
10 changes: 10 additions & 0 deletions bin/configs/java-okhttp-nullable-required.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-nullable-required
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore-with-nullable-required.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: nullable-required-okhttp
hideGenerationTimestamp: "true"
useOneOfDiscriminatorLookup: "true"
disallowAdditionalPropertiesIfNotPresent: false
8 changes: 8 additions & 0 deletions bin/configs/java-okhttp-oneOf-array.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
generatorName: java
outputDir: samples/client/others/java/okhttp-oneOf-array
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/oneOf_array.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
hideGenerationTimestamp: "true"
useBeanValidation: "true"
7 changes: 7 additions & 0 deletions bin/configs/java-okhttp-oneOf.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
generatorName: java
outputDir: samples/client/others/java/okhttp-oneOf
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/oneOf_twoPrimitives.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
hideGenerationTimestamp: "true"
9 changes: 9 additions & 0 deletions bin/configs/java-okhttp-parcelableModel.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-parcelableModel
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
parcelableModel: "true"
artifactId: petstore-okhttp-parcelableModel
hideGenerationTimestamp: "true"
11 changes: 11 additions & 0 deletions bin/configs/java-okhttp-streaming.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
generatorName: java
outputDir: samples/client/others/java/okhttp-streaming
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/streaming.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: petstore-okhttp
hideGenerationTimestamp: "true"
supportStreaming: true
serializableModel: true
enumPropertyNaming: legacy
13 changes: 13 additions & 0 deletions bin/configs/java-okhttp-swagger1.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-swagger1
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: petstore-okhttp
hideGenerationTimestamp: "true"
useOneOfDiscriminatorLookup: "true"
disallowAdditionalPropertiesIfNotPresent: false
annotationLibrary: "swagger1"
openapiNormalizer:
SET_TAGS_FOR_ALL_OPERATIONS: common
11 changes: 11 additions & 0 deletions bin/configs/java-okhttp-swagger2.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp-swagger2
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
additionalProperties:
artifactId: petstore-okhttp
hideGenerationTimestamp: "true"
useOneOfDiscriminatorLookup: "true"
disallowAdditionalPropertiesIfNotPresent: false
annotationLibrary: "swagger2"
25 changes: 25 additions & 0 deletions bin/configs/java-okhttp.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
generatorName: java
outputDir: samples/client/petstore/java/okhttp
library: okhttp
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-okhttp-gson.yaml
templateDir: modules/openapi-generator/src/main/resources/Java
nameMappings:
_type: underscoreType
type_: typeWithUnderscore
parameterNameMappings:
_type: underscoreType
type_: typeWithUnderscore
additionalProperties:
defaultToEmptyContainer: "array?|array|map?"
artifactId: petstore-okhttp
hideGenerationTimestamp: true
useOneOfDiscriminatorLookup: true
disallowAdditionalPropertiesIfNotPresent: false
useReflectionEqualsHashCode: true
removeEnumValuePrefix: true
enumNameMappings:
s: LOWER_CASE_S
S: UPPER_CASE_S
operationIdNameMappings:
getArrayOfEnums: getFakeArrayofenums
fakeHealthGet: getFakeHealth
Loading
Loading