You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by da...@apache.org on 2020/09/16 07:55:44 UTC
[camel] branch api updated (00c3d24 -> e81d5b5)
This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a change to branch api
in repository https://gitbox.apache.org/repos/asf/camel.git.
from 00c3d24 CAMEL-15478: Generated api source now includes correct return type and handles primitive arrays better.
new c0b66ca CAMEL-15478: Improved docs
new e81d5b5 CAMEL-15478: Cleanup
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../box/api/BoxCollaborationsManager.java | 3 -
.../component/box/api/BoxCommentsManager.java | 8 +-
.../component/box/api/BoxEventLogsManager.java | 6 --
.../camel/component/box/api/BoxEventsManager.java | 6 --
.../camel/component/box/api/BoxFilesManager.java | 6 --
.../camel/component/box/api/BoxFoldersManager.java | 6 --
.../camel/component/box/api/BoxGroupsManager.java | 6 --
.../camel/component/box/api/BoxSearchManager.java | 6 --
.../camel/component/box/api/BoxTasksManager.java | 6 --
.../camel/component/box/api/BoxUsersManager.java | 6 --
...CollaborationsManagerEndpointConfiguration.java | 2 +-
.../BoxCommentsManagerEndpointConfiguration.java | 4 +-
.../BoxEventLogsManagerEndpointConfiguration.java | 2 +-
.../box/BoxEventsManagerEndpointConfiguration.java | 2 +-
.../box/BoxFilesManagerEndpointConfiguration.java | 2 +-
.../BoxFoldersManagerEndpointConfiguration.java | 2 +-
.../box/BoxGroupsManagerEndpointConfiguration.java | 2 +-
.../box/BoxSearchManagerEndpointConfiguration.java | 2 +-
.../box/BoxTasksManagerEndpointConfiguration.java | 2 +-
.../box/BoxUsersManagerEndpointConfiguration.java | 2 +-
.../maven/AbstractApiMethodGeneratorMojo.java | 4 +-
.../maven/JavaSourceApiMethodGeneratorMojo.java | 14 ++--
.../org/apache/camel/maven/JavaSourceParser.java | 92 +++++++++++++---------
.../org/apache/camel/maven/SignatureModel.java | 20 ++---
.../apache/camel/maven/JavaSourceParserTest.java | 47 +++++------
25 files changed, 110 insertions(+), 148 deletions(-)
[camel] 02/02: CAMEL-15478: Cleanup
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch api
in repository https://gitbox.apache.org/repos/asf/camel.git
commit e81d5b57cdde7d1b65943a4099b647ff9ae29227
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Wed Sep 16 09:55:08 2020 +0200
CAMEL-15478: Cleanup
---
.../maven/AbstractApiMethodGeneratorMojo.java | 4 +-
.../maven/JavaSourceApiMethodGeneratorMojo.java | 14 ++--
.../org/apache/camel/maven/JavaSourceParser.java | 92 +++++++++++++---------
.../org/apache/camel/maven/SignatureModel.java | 20 ++---
.../apache/camel/maven/JavaSourceParserTest.java | 47 +++++------
5 files changed, 98 insertions(+), 79 deletions(-)
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java
index 704994f..72a7e46 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java
@@ -100,10 +100,10 @@ public abstract class AbstractApiMethodGeneratorMojo extends AbstractApiMethodBa
method = StringHelper.after(method, " ");
}
if (method != null) {
- parameters.put(method, model.getParameters());
+ parameters.put(method, model.getParameterDescriptions());
}
parser.getDescriptions().put(method, model.getMethodDescription());
- parser.addSignatureArguments(model.getSignature(), model.getArguments());
+ parser.addSignatureArguments(model.getSignature(), model.getParameterTypes());
}
parser.setSignatures(signatures);
parser.setParameters(parameters);
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java
index 3e3628a..06b877b 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java
@@ -102,7 +102,7 @@ public class JavaSourceApiMethodGeneratorMojo extends AbstractApiMethodGenerator
}
// get public method signature
- for (String method : parser.getMethods()) {
+ for (String method : parser.getMethodSignatures()) {
if (!result.containsKey(method)
&& (includeMethodPatterns == null || includeMethodPatterns.matcher(method).find())
&& (excludeMethodPatterns == null || !excludeMethodPatterns.matcher(method).find())) {
@@ -112,14 +112,14 @@ public class JavaSourceApiMethodGeneratorMojo extends AbstractApiMethodGenerator
int whitespace = method.indexOf(' ');
int leftBracket = method.indexOf('(');
String name = method.substring(whitespace + 1, leftBracket);
+
SignatureModel model = new SignatureModel();
- model.setApiDescription(parser.getApiDescription());
model.setSignature(method);
- model.setMethodDescription(parser.getMethodDescriptions().get(name));
- Map<String, String> params = parser.getParameters().get(name);
- model.setParameters(params);
- Map<String, String> args = parser.getSignaturesArguments().get(signature);
- model.setArguments(args);
+ model.setApiDescription(parser.getClassDoc());
+ model.setMethodDescription(parser.getMethodDocs().get(name));
+ model.setParameterDescriptions(parser.getParameterDocs().get(name));
+ model.setParameterTypes(parser.getParameterTypes().get(signature));
+
result.put(method, model);
}
}
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java
index dbc3fa0..b351636 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java
@@ -49,13 +49,13 @@ public class JavaSourceParser {
private static final Logger LOG = LoggerFactory.getLogger(JavaSourceParser.class);
- private List<String> methods = new ArrayList<>();
- private Map<String, String> methodText = new HashMap<>();
- private Map<String, Map<String, String>> parameters = new LinkedHashMap<>();
- private Map<String, Map<String, String>> signaturesArguments = new LinkedHashMap<>();
private String errorMessage;
- private String apiDescription;
- private final Map<String, String> methodDescriptions = new HashMap<>();
+
+ private String classDoc;
+ private List<String> methodSignatures = new ArrayList<>();
+ private final Map<String, String> methodDocs = new HashMap<>();
+ private Map<String, Map<String, String>> parameterTypes = new LinkedHashMap<>();
+ private Map<String, Map<String, String>> parameterDocs = new LinkedHashMap<>();
@SuppressWarnings("unchecked")
public synchronized void parse(InputStream in, String innerClass) throws Exception {
@@ -75,14 +75,14 @@ public class JavaSourceParser {
String rawClass = clazz.toUnformattedString();
String doc = getClassJavadocRaw(clazz, rawClass);
- apiDescription = sanitizeJavaDocValue(doc, true);
- if (apiDescription == null || apiDescription.isEmpty()) {
+ classDoc = sanitizeJavaDocValue(doc, true);
+ if (classDoc == null || classDoc.isEmpty()) {
rawClass = rootClazz.toUnformattedString();
doc = getClassJavadocRaw(rootClazz, rawClass);
- apiDescription = sanitizeJavaDocValue(doc, true);
+ classDoc = sanitizeJavaDocValue(doc, true);
}
- if (apiDescription != null && apiDescription.indexOf('.') > 0) {
- apiDescription = StringHelper.before(apiDescription, ".");
+ if (classDoc != null && classDoc.indexOf('.') > 0) {
+ classDoc = StringHelper.before(classDoc, ".");
}
List<MethodSource> ml = ((MethodHolderSource) clazz).getMethods();
@@ -103,7 +103,7 @@ public class JavaSourceParser {
doc = StringHelper.before(doc, ".");
}
if (doc != null && !doc.isEmpty()) {
- methodDescriptions.put(ms.getName(), doc);
+ methodDocs.put(ms.getName(), doc);
}
String result = resolveParameterizedType(rootClazz, clazz, ms, null, ms.getReturnType());
@@ -137,17 +137,16 @@ public class JavaSourceParser {
}
sb.append(")");
- Map<String, String> existing = parameters.get(ms.getName());
+ Map<String, String> existing = parameterDocs.get(ms.getName());
if (existing != null) {
existing.putAll(docs);
} else {
- parameters.put(ms.getName(), docs);
+ parameterDocs.put(ms.getName(), docs);
}
String signature = sb.toString();
- methods.add(signature);
- signaturesArguments.put(signature, args);
- methodText.put(ms.getName(), signature);
+ methodSignatures.add(signature);
+ parameterTypes.put(signature, args);
}
}
@@ -431,40 +430,59 @@ public class JavaSourceParser {
}
public void reset() {
- methods.clear();
- methodText.clear();
- parameters.clear();
- signaturesArguments.clear();
- methodDescriptions.clear();
+ methodSignatures.clear();
+ parameterDocs.clear();
+ parameterTypes.clear();
+ methodDocs.clear();
errorMessage = null;
- apiDescription = null;
+ classDoc = null;
}
+ /**
+ * Contains the error message if parsing failed
+ */
public String getErrorMessage() {
return errorMessage;
}
- public List<String> getMethods() {
- return methods;
- }
-
- public Map<String, Map<String, String>> getSignaturesArguments() {
- return signaturesArguments;
+ /**
+ * Contains all the method signatures, such as: public String addUser(int userId, String name)
+ */
+ public List<String> getMethodSignatures() {
+ return methodSignatures;
}
- public Map<String, String> getMethodText() {
- return methodText;
+ /**
+ * Parameter types for every method
+ *
+ * The key is the method signature, the inner map has key = parameter name, value = parameter type
+ */
+ public Map<String, Map<String, String>> getParameterTypes() {
+ return parameterTypes;
}
- public Map<String, Map<String, String>> getParameters() {
- return parameters;
+ /**
+ * Documentation for every method and their arguments (parameters).
+ *
+ * The key is the method name, the inner map has key = parameter name, value = documentation
+ */
+ public Map<String, Map<String, String>> getParameterDocs() {
+ return parameterDocs;
}
- public String getApiDescription() {
- return apiDescription;
+ /**
+ * Documentation for the class (api description)
+ */
+ public String getClassDoc() {
+ return classDoc;
}
- public Map<String, String> getMethodDescriptions() {
- return methodDescriptions;
+ /**
+ * Documentation for every method
+ *
+ * The key is the method name, the value is the documentation
+ */
+ public Map<String, String> getMethodDocs() {
+ return methodDocs;
}
}
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java
index cdc2c87..c623884 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java
@@ -27,8 +27,8 @@ public class SignatureModel {
private String apiDescription;
private String methodDescription;
private String signature;
- private Map<String, String> parameters;
- private Map<String, String> arguments;
+ private Map<String, String> parameterDescriptions;
+ private Map<String, String> parameterTypes;
public String getApiName() {
return apiName;
@@ -62,19 +62,19 @@ public class SignatureModel {
this.signature = signature;
}
- public Map<String, String> getParameters() {
- return parameters;
+ public Map<String, String> getParameterDescriptions() {
+ return parameterDescriptions;
}
- public void setParameters(Map<String, String> parameters) {
- this.parameters = parameters;
+ public void setParameterDescriptions(Map<String, String> parameterDescriptions) {
+ this.parameterDescriptions = parameterDescriptions;
}
- public Map<String, String> getArguments() {
- return arguments;
+ public Map<String, String> getParameterTypes() {
+ return parameterTypes;
}
- public void setArguments(Map<String, String> arguments) {
- this.arguments = arguments;
+ public void setParameterTypes(Map<String, String> parameterTypes) {
+ this.parameterTypes = parameterTypes;
}
}
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java b/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java
index 0f5a111..f8bda82 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java
@@ -32,14 +32,14 @@ public class JavaSourceParserTest {
final JavaSourceParser parser = new JavaSourceParser();
parser.parse(JavaSourceParserTest.class.getResourceAsStream("/AddressGateway.java"), null);
- assertEquals(4, parser.getMethods().size());
+ assertEquals(4, parser.getMethodSignatures().size());
assertEquals(
"public com.braintreegateway.Result<com.braintreegateway.Address> create(String customerId, com.braintreegateway.AddressRequest request)",
- parser.getMethods().get(0));
- assertEquals(2, parser.getParameters().get("create").size());
- assertEquals("The id of the Customer", parser.getParameters().get("create").get("customerId"));
- assertEquals("The request object", parser.getParameters().get("create").get("request"));
+ parser.getMethodSignatures().get(0));
+ assertEquals(2, parser.getParameterDocs().get("create").size());
+ assertEquals("The id of the Customer", parser.getParameterDocs().get("create").get("customerId"));
+ assertEquals("The request object", parser.getParameterDocs().get("create").get("request"));
}
@Test
@@ -47,13 +47,13 @@ public class JavaSourceParserTest {
final JavaSourceParser parser = new JavaSourceParser();
parser.parse(JavaSourceParserTest.class.getResourceAsStream("/CustomerGateway.java"), null);
- assertEquals(7, parser.getMethods().size());
+ assertEquals(7, parser.getMethodSignatures().size());
assertEquals(
"public com.braintreegateway.Result<com.braintreegateway.Customer> create(com.braintreegateway.CustomerRequest request)",
- parser.getMethods().get(1));
- assertEquals(1, parser.getParameters().get("create").size());
- assertEquals("The request", parser.getParameters().get("create").get("request"));
+ parser.getMethodSignatures().get(1));
+ assertEquals(1, parser.getParameterDocs().get("create").size());
+ assertEquals("The request", parser.getParameterDocs().get("create").get("request"));
}
@Test
@@ -61,15 +61,16 @@ public class JavaSourceParserTest {
final JavaSourceParser parser = new JavaSourceParser();
parser.parse(JavaSourceParserTest.class.getResourceAsStream("/DisputeGateway.java"), null);
- assertEquals(9, parser.getMethods().size());
+ assertEquals(9, parser.getMethodSignatures().size());
assertEquals(
"public com.braintreegateway.Result<com.braintreegateway.DisputeEvidence> addFileEvidence(String disputeId, String documentId)",
- parser.getMethods().get(1));
- assertEquals(3, parser.getParameters().get("addFileEvidence").size());
- assertEquals("The dispute id to add text evidence to", parser.getParameters().get("addFileEvidence").get("disputeId"));
+ parser.getMethodSignatures().get(1));
+ assertEquals(3, parser.getParameterDocs().get("addFileEvidence").size());
+ assertEquals("The dispute id to add text evidence to",
+ parser.getParameterDocs().get("addFileEvidence").get("disputeId"));
assertEquals("The document id of a previously uploaded document",
- parser.getParameters().get("addFileEvidence").get("documentId"));
+ parser.getParameterDocs().get("addFileEvidence").get("documentId"));
}
@Test
@@ -77,12 +78,12 @@ public class JavaSourceParserTest {
final JavaSourceParser parser = new JavaSourceParser();
parser.parse(new FileInputStream("src/test/java/org/apache/camel/component/test/TestProxy.java"), null);
- assertEquals(11, parser.getMethods().size());
+ assertEquals(11, parser.getMethodSignatures().size());
// varargs is transformed to an array type as that is what works
assertEquals(
"public String greetWildcard(String[] wildcardNames)",
- parser.getMethods().get(6));
+ parser.getMethodSignatures().get(6));
}
@Test
@@ -90,13 +91,13 @@ public class JavaSourceParserTest {
final JavaSourceParser parser = new JavaSourceParser();
parser.parse(new FileInputStream("src/test/java/org/apache/camel/component/test/NestedProxy.java"), "Order");
- assertEquals(1, parser.getMethods().size());
+ assertEquals(1, parser.getMethodSignatures().size());
assertEquals(
"public String getOrderById(int id)",
- parser.getMethods().get(0));
- assertEquals(1, parser.getParameters().get("getOrderById").size());
- assertEquals("The order id", parser.getParameters().get("getOrderById").get("id"));
+ parser.getMethodSignatures().get(0));
+ assertEquals(1, parser.getParameterDocs().get("getOrderById").size());
+ assertEquals("The order id", parser.getParameterDocs().get("getOrderById").get("id"));
}
@Test
@@ -105,13 +106,13 @@ public class JavaSourceParserTest {
parser.parse(JavaSourceParserTest.class.getResourceAsStream("/DisputeGateway.java"), null);
- String desc = parser.getApiDescription();
+ String desc = parser.getClassDoc();
assertEquals("Provides methods to interact with Dispute objects", desc);
parser.reset();
parser.parse(JavaSourceParserTest.class.getResourceAsStream("/CustomGateway.java"), null);
- desc = parser.getApiDescription();
+ desc = parser.getClassDoc();
assertEquals("Provides methods to create, delete, find, and update Customer objects", desc);
}
@@ -121,7 +122,7 @@ public class JavaSourceParserTest {
parser.parse(JavaSourceParserTest.class.getResourceAsStream("/DisputeGateway.java"), null);
- String desc = parser.getMethodDescriptions().get("addFileEvidence");
+ String desc = parser.getMethodDocs().get("addFileEvidence");
assertEquals("Add File Evidence to a Dispute, given an ID and a FileEvidenceRequest File evidence request", desc);
}
[camel] 01/02: CAMEL-15478: Improved docs
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch api
in repository https://gitbox.apache.org/repos/asf/camel.git
commit c0b66ca597ed62576b9d25b668dbbde947b051f4
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Wed Sep 16 09:36:07 2020 +0200
CAMEL-15478: Improved docs
---
.../apache/camel/component/box/api/BoxCollaborationsManager.java | 3 ---
.../org/apache/camel/component/box/api/BoxCommentsManager.java | 8 +-------
.../org/apache/camel/component/box/api/BoxEventLogsManager.java | 6 ------
.../java/org/apache/camel/component/box/api/BoxEventsManager.java | 6 ------
.../java/org/apache/camel/component/box/api/BoxFilesManager.java | 6 ------
.../org/apache/camel/component/box/api/BoxFoldersManager.java | 6 ------
.../java/org/apache/camel/component/box/api/BoxGroupsManager.java | 6 ------
.../java/org/apache/camel/component/box/api/BoxSearchManager.java | 6 ------
.../java/org/apache/camel/component/box/api/BoxTasksManager.java | 6 ------
.../java/org/apache/camel/component/box/api/BoxUsersManager.java | 6 ------
.../box/BoxCollaborationsManagerEndpointConfiguration.java | 2 +-
.../component/box/BoxCommentsManagerEndpointConfiguration.java | 4 ++--
.../component/box/BoxEventLogsManagerEndpointConfiguration.java | 2 +-
.../component/box/BoxEventsManagerEndpointConfiguration.java | 2 +-
.../camel/component/box/BoxFilesManagerEndpointConfiguration.java | 2 +-
.../component/box/BoxFoldersManagerEndpointConfiguration.java | 2 +-
.../component/box/BoxGroupsManagerEndpointConfiguration.java | 2 +-
.../component/box/BoxSearchManagerEndpointConfiguration.java | 2 +-
.../camel/component/box/BoxTasksManagerEndpointConfiguration.java | 2 +-
.../camel/component/box/BoxUsersManagerEndpointConfiguration.java | 2 +-
20 files changed, 12 insertions(+), 69 deletions(-)
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCollaborationsManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCollaborationsManager.java
index 5e537d6..44027bc 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCollaborationsManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCollaborationsManager.java
@@ -27,10 +27,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Collaborations Manager
- * <p>
* Provides operations to manage Box collaborations.
- *
*/
public class BoxCollaborationsManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCommentsManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCommentsManager.java
index 79ea1ac..4dcf6f9 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCommentsManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxCommentsManager.java
@@ -26,13 +26,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Comments Manager
- *
- * <p>
* Provides operations to manage Box comments.
- *
- *
- *
*/
public class BoxCommentsManager {
@@ -55,7 +49,7 @@ public class BoxCommentsManager {
/**
* Add comment to file.
*
- * @param fileId - the id of file to rename.
+ * @param fileId - the id of file.
* @param message - the comment's message.
* @return The commented file.
*/
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventLogsManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventLogsManager.java
index f6cc056..52eda60 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventLogsManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventLogsManager.java
@@ -29,13 +29,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Event Logs Manager
- *
- * <p>
* Provides operations to read Box enterprise (admin) event logs.
- *
- *
- *
*/
public class BoxEventLogsManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventsManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventsManager.java
index 8db5dc5..16262c1 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventsManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxEventsManager.java
@@ -24,13 +24,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Events Manager
- *
- * <p>
* Provides operations to manage Box events.
- *
- *
- *
*/
public class BoxEventsManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFilesManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFilesManager.java
index a43812c..756d509 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFilesManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFilesManager.java
@@ -39,13 +39,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Files Manager
- *
- * <p>
* Provides operations to manage Box files.
- *
- *
- *
*/
public class BoxFilesManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFoldersManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFoldersManager.java
index 9294ec9..a1fcca7 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFoldersManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxFoldersManager.java
@@ -31,13 +31,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Folders Manager
- *
- * <p>
* Provides operations to manage Box folders.
- *
- *
- *
*/
public class BoxFoldersManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxGroupsManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxGroupsManager.java
index 3a879c9..e35f6dd 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxGroupsManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxGroupsManager.java
@@ -28,13 +28,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Groups Manager
- *
- * <p>
* Provides operations to manage Box groups.
- *
- *
- *
*/
public class BoxGroupsManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxSearchManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxSearchManager.java
index 974c05e..e63d9f8 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxSearchManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxSearchManager.java
@@ -30,13 +30,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Search Manager
- *
- * <p>
* Provides operations to manage Box searches.
- *
- *
- *
*/
public class BoxSearchManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxTasksManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxTasksManager.java
index 1140188..bf3527e 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxTasksManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxTasksManager.java
@@ -29,13 +29,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Tasks Manager
- *
- * <p>
* Provides operations to manage Box tasks.
- *
- *
- *
*/
public class BoxTasksManager {
diff --git a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxUsersManager.java b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxUsersManager.java
index 4c22729..c9257f2 100644
--- a/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxUsersManager.java
+++ b/components/camel-box/camel-box-api/src/main/java/org/apache/camel/component/box/api/BoxUsersManager.java
@@ -30,13 +30,7 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Box Users Manager
- *
- * <p>
* Provides operations to manage Box users.
- *
- *
- *
*/
public class BoxUsersManager {
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCollaborationsManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCollaborationsManagerEndpointConfiguration.java
index 1fb0047..2265825 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCollaborationsManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCollaborationsManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxCollaborationsManager}.
*/
-@ApiParams(apiName = "collaborations", description = "Box Collaborations Manager Provides operations to manage Box collaborations",
+@ApiParams(apiName = "collaborations", description = "Provides operations to manage Box collaborations",
apiMethods = {@ApiMethod(methodName = "addFolderCollaboration", description="Add a collaboration to this folder"), @ApiMethod(methodName = "addFolderCollaborationByEmail", description="Add a collaboration to this folder"), @ApiMethod(methodName = "deleteCollaboration", description="Delete collaboration"), @ApiMethod(methodName = "getCollaborationInfo", description="Get collaboration information"), @ApiMethod(methodName = "getFolderCollaborations", description="Get information [...]
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCommentsManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCommentsManagerEndpointConfiguration.java
index 476b30e..141ed02 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCommentsManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxCommentsManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxCommentsManager}.
*/
-@ApiParams(apiName = "comments", description = "Box Comments Manager",
+@ApiParams(apiName = "comments", description = "Provides operations to manage Box comments",
apiMethods = {@ApiMethod(methodName = "addFileComment", description="Add comment to file"), @ApiMethod(methodName = "changeCommentMessage", description="Change comment message"), @ApiMethod(methodName = "deleteComment", description="Delete comment"), @ApiMethod(methodName = "getCommentInfo", description="Get comment information"), @ApiMethod(methodName = "getFileComments", description="Get a list of any comments on this file"), @ApiMethod(methodName = "replyToComment", descrip [...]
@UriParams
@Configurer
@@ -23,7 +23,7 @@ public final class BoxCommentsManagerEndpointConfiguration extends BoxConfigurat
@ApiParam(apiMethods = {@ApiMethod(methodName = "changeCommentMessage", description="The id of comment to change"), @ApiMethod(methodName = "deleteComment", description="The id of comment to delete"), @ApiMethod(methodName = "getCommentInfo", description="The id of comment"), @ApiMethod(methodName = "replyToComment", description="The id of comment to reply to")})
private String commentId;
@UriParam
- @ApiParam(apiMethods = {@ApiMethod(methodName = "addFileComment", description="The id of file to rename"), @ApiMethod(methodName = "getFileComments", description="The id of file")})
+ @ApiParam(apiMethods = {@ApiMethod(methodName = "addFileComment", description="The id of file"), @ApiMethod(methodName = "getFileComments", description="The id of file")})
private String fileId;
@UriParam
@ApiParam(apiMethods = {@ApiMethod(methodName = "addFileComment", description="The comment's message"), @ApiMethod(methodName = "changeCommentMessage", description="The new message for the comment"), @ApiMethod(methodName = "replyToComment", description="The message for the reply")})
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventLogsManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventLogsManagerEndpointConfiguration.java
index 11a5c6c..fa21ec3 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventLogsManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventLogsManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxEventLogsManager}.
*/
-@ApiParams(apiName = "event-logs", description = "Box Event Logs Manager",
+@ApiParams(apiName = "event-logs", description = "Provides operations to read Box enterprise (admin) event logs",
apiMethods = {@ApiMethod(methodName = "getEnterpriseEvents", description="Create an event stream with optional starting initial position and add listener that will be notified when an event is received")})
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventsManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventsManagerEndpointConfiguration.java
index 39c49ed..d841691 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventsManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxEventsManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxEventsManager}.
*/
-@ApiParams(apiName = "events", description = "Box Events Manager",
+@ApiParams(apiName = "events", description = "Provides operations to manage Box events",
apiMethods = {@ApiMethod(methodName = "listen", description="Create an event stream with optional starting initial position and add listener that will be notified when an event is received")})
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFilesManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFilesManagerEndpointConfiguration.java
index d8aa379..62479df 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFilesManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFilesManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxFilesManager}.
*/
-@ApiParams(apiName = "files", description = "Box Files Manager",
+@ApiParams(apiName = "files", description = "Provides operations to manage Box files",
apiMethods = {@ApiMethod(methodName = "checkUpload", description="Does a pre-verification before upload, to check if the filename already exists or if there is permission to upload"), @ApiMethod(methodName = "copyFile", description="Copy file to destination folder while optionally giving it a new name"), @ApiMethod(methodName = "createFileMetadata", description="Create metadata for file in either the global properties template or the specified template type"), @ApiMethod(metho [...]
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFoldersManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFoldersManagerEndpointConfiguration.java
index f93a24a..9eea40a 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFoldersManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxFoldersManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxFoldersManager}.
*/
-@ApiParams(apiName = "folders", description = "Box Folders Manager",
+@ApiParams(apiName = "folders", description = "Provides operations to manage Box folders",
apiMethods = {@ApiMethod(methodName = "copyFolder", description="Copy folder to destination folder while optionally giving it a new name"), @ApiMethod(methodName = "createFolder", description="Create a folder specified by path from parent folder with given parentFolderId, creating intermediate directories as required"), @ApiMethod(methodName = "createFolderSharedLink", description="Create a shared link to folder"), @ApiMethod(methodName = "deleteFolder", description="Delete fo [...]
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxGroupsManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxGroupsManagerEndpointConfiguration.java
index 264431c..e8d962f 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxGroupsManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxGroupsManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxGroupsManager}.
*/
-@ApiParams(apiName = "groups", description = "Box Groups Manager",
+@ApiParams(apiName = "groups", description = "Provides operations to manage Box groups",
apiMethods = {@ApiMethod(methodName = "addGroupMembership", description="Add a member to group with the specified role"), @ApiMethod(methodName = "createGroup", description="Create a new group with a specified name and optional additional parameters"), @ApiMethod(methodName = "deleteGroup", description="Delete group"), @ApiMethod(methodName = "deleteGroupMembership", description="Delete group membership"), @ApiMethod(methodName = "getAllGroups", description="Get all the groups [...]
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxSearchManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxSearchManagerEndpointConfiguration.java
index 10869bf..6b78c3c 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxSearchManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxSearchManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxSearchManager}.
*/
-@ApiParams(apiName = "search", description = "Box Search Manager",
+@ApiParams(apiName = "search", description = "Provides operations to manage Box searches",
apiMethods = {@ApiMethod(methodName = "searchFolder", description="Search folder and all descendant folders using the given query")})
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxTasksManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxTasksManagerEndpointConfiguration.java
index 12ed82e..7aead6a 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxTasksManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxTasksManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxTasksManager}.
*/
-@ApiParams(apiName = "tasks", description = "Box Tasks Manager",
+@ApiParams(apiName = "tasks", description = "Provides operations to manage Box tasks",
apiMethods = {@ApiMethod(methodName = "addAssignmentToTask", description="Add assignment for task"), @ApiMethod(methodName = "addFileTask", description="Add task to file"), @ApiMethod(methodName = "deleteTask", description="Delete task"), @ApiMethod(methodName = "deleteTaskAssignment", description="Delete task assignment"), @ApiMethod(methodName = "getFileTasks", description="Get a list of any tasks on file"), @ApiMethod(methodName = "getTaskAssignmentInfo", description="Get t [...]
@UriParams
@Configurer
diff --git a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxUsersManagerEndpointConfiguration.java b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxUsersManagerEndpointConfiguration.java
index ad2bddf..26f23e6 100644
--- a/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxUsersManagerEndpointConfiguration.java
+++ b/components/camel-box/camel-box-component/src/generated/java/org/apache/camel/component/box/BoxUsersManagerEndpointConfiguration.java
@@ -14,7 +14,7 @@ import org.apache.camel.spi.UriParams;
/**
* Camel endpoint configuration for {@link org.apache.camel.component.box.api.BoxUsersManager}.
*/
-@ApiParams(apiName = "users", description = "Box Users Manager",
+@ApiParams(apiName = "users", description = "Provides operations to manage Box users",
apiMethods = {@ApiMethod(methodName = "addUserEmailAlias", description="Add a new email alias to user's account"), @ApiMethod(methodName = "createAppUser", description="Provision a new app user in an enterprise with additional user information using Box Developer Edition"), @ApiMethod(methodName = "createEnterpriseUser", description="Provision a new user in an enterprise with additional user information"), @ApiMethod(methodName = "deleteUser", description="Delete user from an [...]
@UriParams
@Configurer