You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by bu...@apache.org on 2014/02/10 14:19:42 UTC
svn commit: r897156 - in /websites/production/camel/content:
cache/main.pageCache endpoint-annotations.html
Author: buildbot
Date: Mon Feb 10 13:19:42 2014
New Revision: 897156
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/endpoint-annotations.html
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/endpoint-annotations.html
==============================================================================
--- websites/production/camel/content/endpoint-annotations.html (original)
+++ websites/production/camel/content/endpoint-annotations.html Mon Feb 10 13:19:42 2014
@@ -75,26 +75,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2 id="EndpointAnnotations-EndpointAnnotations">Endpoint Annotations</h2>
-
-<p>As of <strong>Camel 2.12</strong> you can annotate <a shape="rect" href="endpoint.html">Endpoint</a> and Consumer classes so that their configuration documentation can be automatically generated by the camel-package-maven-plugin (rather like maven plugin goals get their parameters documented automatically).</p>
-
-<p>The documentation is then included into the jar as org/apache/camel/component/scheme.html as well as appearing in the maven site documentation as a project report.</p>
-
-<h3 id="EndpointAnnotations-Supportedannotations">Supported annotations</h3>
-
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Annotation</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>@UriEndpoint</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies that an endpoint is annotated with @UriParam and/or @UriParams annotations. Also specifies the default scheme to use in the generated documentation and the associated Consumer class for this endpoint</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>@UriParam</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used to annotate a parameter value; usually specified via ?foo=bar syntax in the URI strings in Camel. Used currently only on field declarations but in the future could be used on setter methods too. If no name is specified then the name of the field/setter property is used.</p></td></tr><tr><td colspan=
"1" rowspan="1" class="confluenceTd"><p>@UriParams</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies that a field is a nested object of one or more configuration parameters; then the class of this field should be annotated with one or more @UriParam or @UriParams annotations</p></td></tr></tbody></table></div>
-
-
-<p>For example here is the <a shape="rect" class="external-link" href="https://github.com/apache/camel/blob/trunk/camel-core/src/main/java/org/apache/camel/component/timer/TimerEndpoint.java#L40" rel="nofollow">TimerEndpoint</a>, notice the use of these annotations and in its base classes.</p>
-
-<p>Not only are the annotations useful for automatically generating the documentation; we can use them to refine the validation of the code during configuration and they can be useful for tool providers so they can more easily introspect the configuration options. See the <a shape="rect" href="componentconfiguration.html">ComponentConfiguration</a> documentation on the tooling aspect.</p>
-
-<h3 id="EndpointAnnotations-UsingtheUriEndpointComponentbaseclass">Using the UriEndpointComponent base class</h3>
-
-<p>If you use the @UriEndpoint annotation on your Endpoint along with one or more @UriParam / @UriParams annotations on your class (or any base classes of your endpoint) its recommended that your Component class inherit from the UriEndpointComponent base class as that means your Component will automatically generate better metadata for the <a shape="rect" href="componentconfiguration.html">ComponentConfiguration</a> API.</p>
-
-<p>This will allow your component to work better inside tools which make use of the <a shape="rect" href="componentconfiguration.html">ComponentConfiguration</a> API to generate nice forms and so forth.</p></div>
+<div class="wiki-content maincontent"><h2 id="EndpointAnnotations-EndpointAnnotations">Endpoint Annotations</h2><p>As of <strong>Camel 2.12</strong> you can annotate <a shape="rect" href="endpoint.html">Endpoint</a> and Consumer classes so that their configuration documentation can be automatically generated by the camel-package-maven-plugin (rather like maven plugin goals get their parameters documented automatically).</p><p>The documentation is then included into the jar as org/apache/camel/component/scheme/scheme.html where scheme is the component name.</p><h3 id="EndpointAnnotations-Supportedannotations">Supported annotations</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Annotation</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>@UriEndpoint</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies th
at an endpoint is annotated with @UriParam and/or @UriParams annotations. Also specifies the default scheme to use in the generated documentation and the associated Consumer class for this endpoint</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>@UriParam</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used to annotate a parameter value; usually specified via ?foo=bar syntax in the URI strings in Camel. Used currently only on field declarations but in the future could be used on setter methods too. If no name is specified then the name of the field/setter property is used.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>@UriParams</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies that a field is a nested object of one or more configuration parameters; then the class of this field should be annotated with one or more @UriParam or @UriParams annotations</p></td></tr></tbody></table></div><p>For example here is t
he <a shape="rect" class="external-link" href="https://github.com/apache/camel/blob/trunk/camel-core/src/main/java/org/apache/camel/component/timer/TimerEndpoint.java#L40" rel="nofollow">TimerEndpoint</a>, notice the use of these annotations and in its base classes.</p><p>Not only are the annotations useful for automatically generating the documentation; we can use them to refine the validation of the code during configuration and they can be useful for tool providers so they can more easily introspect the configuration options. See the <a shape="rect" href="componentconfiguration.html">ComponentConfiguration</a> documentation on the tooling aspect.</p><h3 id="EndpointAnnotations-UsingtheUriEndpointComponentbaseclass">Using the UriEndpointComponent base class</h3><p>If you use the @UriEndpoint annotation on your Endpoint along with one or more @UriParam / @UriParams annotations on your class (or any base classes of your endpoint) its recommended that your Component class inherit fro
m the UriEndpointComponent base class as that means your Component will automatically generate better metadata for the <a shape="rect" href="componentconfiguration.html">ComponentConfiguration</a> API.</p><p>This will allow your component to work better inside tools which make use of the <a shape="rect" href="componentconfiguration.html">ComponentConfiguration</a> API to generate nice forms and so forth.</p></div>
</td>
<td valign="top">
<div class="navigation">