Claus Ibsen created CAMEL-7999:
----------------------------------
Summary: Camel Toolbox - Easy information about all Camel
components and the release for tooling
Key: CAMEL-7999
URL: https://issues.apache.org/jira/browse/CAMEL-7999
Project: Camel
Issue Type: New Feature
Components: camel-core, jmx, tooling
Reporter: Claus Ibsen
Assignee: Claus Ibsen
Fix For: 2.15.0
A Camel release contains many components, and we have the ability to let
components document which options they offer.
Though there is currently a few shortcomings that can be improved
- the component json schema is currently runtime generated, which requires to
load the component and create an instance of it. Instead we should build-time
generate it, which we do today with the camel apt compiler plugin.
- we should include documentation about the option from the javadoc, that
allows end users to fully document a component using plain java getter/settr
with javadocs, and add those @UriParam annotations for the apt compiler to
detect and leverage
- add a module that embeds all these json schema files in a single module, and
also other information, such as the xml schemas, and what else can be handy.
Then there is a single module as a one stop shop for tooling and whatnot to
gather information about a Camel release.
- allow at runtime to explain an endpoint uri what the options in use are, eg
as we got the json schema, we can add mbeans that can explain those options,
than we can use in tooling, JMX, karaf commands etc. And also IDE editors etc
- enrich the dsl xml to inject javadoc for the eips into the xml schema, so we
have documented in the xsd directly that any tooling can use. We have a old
ticket about this. But the apt compiler plugin can detect the @JAXB annotations
in the model and extract the javadoc, and generate a json schema with, and then
we can load those and enrich into the generated xsd, or enrich into the jaxb
model generator, or something.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
