Update OpenAPI spec (#160)

## Changes
Update of the OpenAPI spec. This also introduces the template_libraries
field being added in
databricks/databricks-sdk-go#635.

This PR contains some other changes:
1. Change `float`/`Float` to `double`/`Double`. OpenAPI specs currently
specify `format: "double"` for all non-integral numeric values.
2. Remove old types that were previously in the OpenAPI spec but are no
longer needed.
3. Do not generate files for types that don't correspond to distinct
Java types (e.g. are not objects or enums). A lot of extra files are
generated unnecessarily today, corresponding to either
integers/strings/booleans or arrays/maps. Since Java has no type-def
functionality, these are represented in the SDK as their JDK
equivalents.

## Tests
Added AccountMetastoreAssignmentsIT to verify the correct functionality
of the updated AccountMetastoreAssignments API.
Nightly tests passed on this PR.

Author: mgyucht

.codegen.json

@@ -1,5 +1,8 @@
 {
   "formatter": "mvn spotless:apply",
+  "template_libraries": [
+    ".codegen/lib.tmpl"
+  ],
   "types": {
     ".codegen/model.java.tmpl": "databricks-sdk-java/src/main/java/com/databricks/sdk/service/{{.Package.Name}}/{{.PascalName}}.java"
   },
@@ -19,6 +22,7 @@
   },
   "toolchain": {
     "require": ["mvn", "java"],
+    "setup": ["rm -r databricks-sdk-java/src/main/java/com/databricks/sdk/service"],
     "post_generate": ["mvn --errors clean test"]
   }
 }

.codegen/_openapi_sha

@@ -1 +1 @@
-09a7fa63d9ae243e5407941f200960ca14d48b07
+bcbf6e851e3d82fd910940910dd31c10c059746c

.codegen/api.java.tmpl

@@ -99,7 +99,7 @@ public class {{.PascalName}}API {
 	{{range .Methods}}
 	{{if and .Request .Request.RequiredFields}}
   public {{template "method-return-type" .}} {{template "java-name" .}}({{range $i, $p := .Request.RequiredFields -}}
-    {{if $i}}, {{end}}{{template "type" .Entity }} {{.CamelName}}{{if .IsNameReserved}}Value{{end}}
+    {{if $i}}, {{end}}{{template "type-unboxed" .Entity }} {{.CamelName}}{{if .IsNameReserved}}Value{{end}}
   {{- end}}) {
     {{if or .Response .Wait -}}return {{end}}{{template "java-name" .}}(new {{.Request.PascalName}}(){{range .Request.RequiredFields}}
       .set{{.PascalName}}({{.CamelName}}{{if .IsNameReserved}}Value{{end}}){{end}});
@@ -173,9 +173,9 @@ public class {{.PascalName}}API {
 {{define "method-return-type" -}}
   {{if and .Wait (and (not .IsCrudRead) (not (eq .SnakeName "get_run"))) }}Wait<{{.Wait.Poll.Response.PascalName}},{{if .Response}}{{.Response.PascalName}}{{else}}Void{{end}}>
   {{- else if .Response}}{{if .Response.ArrayValue -}}
-    Iterable<{{.Response.ArrayValue.PascalName}}>
+    Iterable<{{ template "type" .Response.ArrayValue }}>
   {{- else if .Pagination -}}
-    Iterable<{{.Pagination.Entity.PascalName}}>
+    Iterable<{{ template "type" .Pagination.Entity }}>
   {{- else -}}
     {{template "type" .Response}}
   {{- end}}{{else}}void{{end}}

.codegen/interface.java.tmpl

@@ -23,21 +23,3 @@ public interface {{.PascalName}}Service {
   {{if .Response -}}{{template "type" .Response}}{{else}}void{{end}} {{.CamelName}}{{if .IsNameReserved}}Content{{end}}({{if .Request}}{{template "type" .Request}} {{.Request.CamelName}}{{if .IsNameReserved}}Content{{end}}{{end}});
   {{end}}
 }
-{{- define "type" -}}
-  {{- if not . }}Object /* ERROR */
-  {{- else if .IsEmpty}}Object
-  {{- else if .IsAny}}Object
-  {{- else if .IsString}}String
-  {{- else if .IsBool}}boolean
-  {{- else if .IsInt64}}long
-  {{- else if .IsFloat64}}float
-  {{- else if .IsInt}}long
-  {{- else if .ArrayValue }}Collection<{{template "type" .ArrayValue}}>
-  {{- else if .MapValue }}Map<String,{{template "type" .MapValue}}>
-  {{- else if .IsByteStream}}InputStream
-  {{- else if .IsObject }}{{.PascalName}}
-  {{- else if .IsExternal }}com.databricks.sdk.service.{{.Package.Name}}.{{.PascalName}}
-  {{- else if .Enum }}{{.PascalName}}
-  {{- else}}Object /* MISSING TYPE */
-  {{- end -}}
-{{- end -}}

.codegen/lib.tmpl

@@ -0,0 +1,26 @@
+{{- define "type-unboxed" -}}
+  {{- if .IsBool}}boolean
+  {{- else if .IsInt64}}long
+  {{- else if .IsFloat64}}double
+  {{- else if .IsInt}}long
+  {{- else }}{{template "type" .}}{{end}}
+{{- end -}}
+
+{{- define "type" -}}
+  {{- if not . }}Object /* ERROR */
+  {{- else if .IsEmpty}}Object
+  {{- else if .IsAny}}Object
+  {{- else if .IsString}}String
+  {{- else if .IsBool}}Boolean
+  {{- else if .IsInt64}}Long
+  {{- else if .IsFloat64}}Double
+  {{- else if .IsInt}}Long
+  {{- else if .ArrayValue }}Collection<{{template "type" .ArrayValue}}>
+  {{- else if .MapValue }}Map<String,{{template "type" .MapValue}}>
+  {{- else if .IsByteStream}}InputStream
+  {{- else if .IsObject }}{{.PascalName}}
+  {{- else if .IsExternal }}com.databricks.sdk.service.{{.Package.Name}}.{{.PascalName}}
+  {{- else if .Enum }}{{.PascalName}}
+  {{- else}}Object /* MISSING TYPE */
+  {{- end -}}
+{{- end -}}

.codegen/model.java.tmpl

@@ -65,8 +65,6 @@ public class {{.PascalName}} {
     {{- end}}.toString();
   }
 }
-{{else if .ArrayValue}}// type {{.PascalName}} []{{template "type" .ArrayValue}}
-{{else if .MapValue}}// type {{.PascalName}} {{template "type" .}}
 {{else if .Enum -}}
 @Generated
 public enum {{.PascalName}}{
@@ -75,23 +73,9 @@ public enum {{.PascalName}}{
   @JsonProperty("{{.Content}}") {{end}}{{.ConstantName}},{{.Comment "// " 80}}
   {{ end }}
 }
+{{ else }}
+Any types that have no fields (i.e. primitives or array types) or are not enums are not represented by distinct Java
+types in the Java SDK.
+{{skipThisFile}}
 {{- end}}
 
-{{- define "type" -}}
-  {{- if not . }}Object /* ERROR */
-  {{- else if .IsEmpty}}Object
-  {{- else if .IsAny}}Object
-  {{- else if .IsString}}String
-  {{- else if .IsBool}}Boolean
-  {{- else if .IsInt64}}Long
-  {{- else if .IsFloat64}}Float
-  {{- else if .IsInt}}Long
-  {{- else if .ArrayValue }}Collection<{{template "type" .ArrayValue}}>
-  {{- else if .MapValue }}Map<String,{{template "type" .MapValue}}>
-  {{- else if .IsByteStream}}InputStream
-  {{- else if .IsObject }}{{.PascalName}}
-  {{- else if .IsExternal }}com.databricks.sdk.service.{{.Package.Name}}.{{.PascalName}}
-  {{- else if .Enum }}{{.PascalName}}
-  {{- else}}Object /* MISSING TYPE */
-  {{- end -}}
-{{- end -}}