[SCB-1619] translate comments of oas-generator
Signed-off-by: kakulisen <18813972746@163.com>
diff --git a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/HttpStatuses.java b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/HttpStatuses.java
index 0064daa..b1a86ca 100644
--- a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/HttpStatuses.java
+++ b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/HttpStatuses.java
@@ -19,6 +19,9 @@
public class HttpStatuses {
- public static String OK = "200";
+ /**
+ * HTTP/1.0 - RFC 1945
+ */
+ public final static String OK = "200";
}
diff --git a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OasContext.java b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OasContext.java
index 22bc2c7..d1a80ff 100644
--- a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OasContext.java
+++ b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OasContext.java
@@ -75,7 +75,7 @@
pathItem.operation(HttpMethod.valueOf(operationCtx.getHttpMethod()), operationCtx.toOperation());
}
- // 如果没有restful资源则返回null
+ // return null if there is no restful resource
if (openAPI.getPaths() == null || openAPI.getPaths().size() == 0) {
return null;
}
diff --git a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OperationContext.java b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OperationContext.java
index 02d8352..3560b3b 100644
--- a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OperationContext.java
+++ b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/context/OperationContext.java
@@ -107,7 +107,7 @@
Content content = new Content();
MediaType mediaType = new MediaType();
- // 处理参数
+ // process parameter
List<Parameter> parameterList = parameterContexts.stream()
.map(parameterContext ->
{
@@ -164,8 +164,9 @@
if (apiResponses == null) {
return;
}
- // 处理响应
- // 没有注解被处理
+
+ // no annotations are processed
+ // generate a default response based on the method return value
if (apiResponses.get(HttpStatuses.OK) == null) {
ApiResponse apiResponse = new ApiResponse();
diff --git a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/parser/api/OpenApiAnnotationParser.java b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/parser/api/OpenApiAnnotationParser.java
index f4f722e..c527126 100644
--- a/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/parser/api/OpenApiAnnotationParser.java
+++ b/oas-generator/oas-generator-core/src/main/java/org/apache/servicecomb/toolkit/generator/parser/api/OpenApiAnnotationParser.java
@@ -36,7 +36,8 @@
void parser(Class<?> cls, OasContext context);
/**
- * 用于排序, 对于同一个类,同时只能为springmvc或者jaxrs其中一种
+ * Used for sorting
+ * For the same parsing class, only the same programming model can be parsed at the same time.
* @return
*/
int getOrder();