我目前正在玩我的 jersey2 休息服务。为了更好地了解给定服务（描述、类型等），我大量使用了 swagger (swagger-jersey2-jaxrs)。因此，我能够生成我的服务描述 (swagger.json)，并且可以通过 swagger ui 查看和探索它们。
现在我需要创建一些客户端来使用这些服务。我遇到了 swagger codegen cli，它是一个很好的工具，可以生成你的客户端和许多不同的语言（在我的例子中是 java）。我能够生成 api 客户端和正在使用的模型。
在这里，我面临第一个问题。REST 服务和 swagger 描述受 http 基本身份验证保护。我阅读了文档 ，它给了我一些提示，即有可能使用基本身份验证。在这一点上，我不得不提到，从我的角度来看，文档非常差。它说：
-a , --auth 在远程获取 swagger 定义时添加授权标头。传入一个 URL 编码的 name:header 字符串，用逗号分隔多个值。
我想到的第一件事是在 http 标头中传递一个字符串，但这不起作用，甚至谷歌搜索如何使用 swagger cli 的基本身份验证也没有得到一些明确的答案。经过大量尝试和错误后（我使用的是 CLI 2.1.2），我终于找到了正确的格式：
java -jar swagger-codegen-cli-2.1.2.jar generate -a "授权：基本 YWRtaW46YWRtaW4=" -i http://localhost:8080/webproject/restapi/swagger.json -l java -o restclient
其中 YWRtaW46YWRtaW4= 在我的例子中是 admin:admin 的 base64 编码值。
到现在为止还挺好。生成的 java 客户端也必须使用基本身份验证。我查看了 ApiClient 中的方法，发现了 setUsername 和 setPassword。我认为这种方法使客户能够使用基本身份验证，但没有运气。
所以我深入研究了生成的类，尤其是 ApiClient 和几个生成的 ApiService 类。我发现 setUsername 和 setPassword 无效，原因如下：
/**
* Helper method to set username for the first HTTP basic authentication.
*/
public void setUsername(String username) {
for (Authentication auth : authentications.values()) {
if (auth instanceof HttpBasicAuth) {
((HttpBasicAuth) auth).setUsername(username);
return;
}
}
throw new RuntimeException("No HTTP basic authentication configured!");
}
同时HashMap定义如下：
// Setup authentications (key: authentication name, value: authentication).
authentications = new HashMap<String, Authentication>();
// Prevent the authentications from being modified.
authentications = Collections.unmodifiableMap(authentications);
身份验证 hashmap 变得不可变，但为什么呢？什么目的？此外，ApiClinet 内部没有生成所需身份验证对象的辅助方法，因此我执行了以下操作：
1) 注释掉 authentications Collections.unmodifiableMap(authentications) 行，使 hashmap 再次变为可修改
2）手动创建所需的身份验证对象
HttpBasicAuth authentication = new HttpBasicAuth();
authentication.setUsername("admin");
authentication.setPassword("admin");
3) 将 auth 对象添加到 apiClients 身份验证 hashmap：
ApiClient apiClient = new ApiClient();
apiClient.setBasePath(basePath);
apiClient.getAuthentications().put("basic", authentication);
4）修改invokeApi方法（ApiClient.java）
public String invokeAPI(String path, String method, Map<String, String> queryParams, Object body, Map<String, String> headerParams, Map<String, String> formParams, String accept, String contentType, String[] authNames) throws ApiException {
String authNames2[] = {"basic"};
updateParamsForAuth(authNames2, queryParams, headerParams);
//updateParamsForAuth(authNames, queryParams, headerParams);
...
第 4 步是必要的，因为 ApiServices 调用 apiClient 方法，如下所示：
String[] authNames = new String[] { };
String response = apiClient.invokeAPI(path, "POST", queryParams, postBody, headerParams, formParams, accept, contentType, authNames);
另一种可能的解决方案是在每个 apiService 中定义身份验证哈希图的密钥，例如：
String[] authNames = new String[] { "basic" };
完成所有修改后，一切都按预期工作，但我不认为这是自动生成的休息客户端背后的想法。所以我的问题是：我是否遗漏了一些观点，或者我是否应该将大摇大摆的生成客户端（在本例中为 java）更多地考虑为正在开发的 beta 解决方案？请让我正确，我认为整个 swagger 框架（jersey2 支持、openapi、swaggerui、codegen）是一件很棒的事情，我感谢开发人员的努力，但我想正确使用 codegen，我不认为背后的想法是所以必须以这种方式自定义生成的 ApiClient 和 ApiServices。