You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by or...@apache.org on 2024/02/17 10:42:18 UTC
(camel) 03/03: CAMEL-20410: documentation fixes for camel-platform-http-vertx
This is an automated email from the ASF dual-hosted git repository.
orpiske pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
commit ef11dd0a0e080c8e81fea86e65723a3930b52fce
Author: Otavio R. Piske <an...@gmail.com>
AuthorDate: Sat Feb 17 09:37:14 2024 +0100
CAMEL-20410: documentation fixes for camel-platform-http-vertx
- Fixed samples
- Converted to use tabs
- Fixed grammar and typos
- Fixed punctuation
- Added and/or fixed links
Signed-off-by: Otavio R. Piske <an...@gmail.com>
---
.../src/main/docs/platform-http-vertx.adoc | 19 +++++++++----------
1 file changed, 9 insertions(+), 10 deletions(-)
diff --git a/components/camel-platform-http-vertx/src/main/docs/platform-http-vertx.adoc b/components/camel-platform-http-vertx/src/main/docs/platform-http-vertx.adoc
index ad9bff498f2..6b03844f1f4 100644
--- a/components/camel-platform-http-vertx/src/main/docs/platform-http-vertx.adoc
+++ b/components/camel-platform-http-vertx/src/main/docs/platform-http-vertx.adoc
@@ -13,10 +13,10 @@ The camel-platform-http-vertx is a Vert.x based implementation of the `PlatformH
== Vert.x Route
-This implementation will by default lookup an instance of `VertxPlatformHttpRouter` on the registry however you can
+This implementation will by default lookup the instance of `VertxPlatformHttpRouter` on the registry, however, you can
configure an existing instance using the getter/setter on the `VertxPlatformHttpEngine` class.
-== Auto detection from classpath
+== Auto-detection from classpath
To use this implementation all you need to do is to add the `camel-platform-http-vertx` dependency to the classpath,
and the platform http component should auto-detect this.
@@ -32,11 +32,10 @@ and the platform http component should auto-detect this.
|`CamelVertxPlatformHttpRemoteAddress` |`io.vertx.core.net.SocketAddress` |The remote address for the connection if present on the Vert.x Web `RoutingContext`.
|=======================================================================
-Camel also populates *all* request.parameter and Camel also populates *all* request.parameter and request.headers. For
-example, given a client request with the URL,
+Camel also populates *all* `request.parameter` and Camel also populates *all* `request.headers`.
+For example, given a client request with the URL,
`\http://myserver/myserver?orderid=123`, the exchange will contain a
-header named `orderid` with the value 123.
-request.headers. For example, given a client request with the URL, `\http://myserver/myserver?orderid=123`, the exchange will contain a header named `orderid` with the value 123.
+header named `orderid` with value `123`.
== VertxPlatformHttpServer
@@ -68,7 +67,7 @@ context.start();
Platform HTTP component can act as a reverse proxy, in that case `Exchange.HTTP_URI`, `Exchange.HTTP_HOST` headers are populated from the absolute URL received on the request line of the HTTP request.
-Here's an example of a HTTP proxy that simply redirects the Exchange to the origin server.
+Here's an example of an HTTP proxy that simply redirects the Exchange to the origin server.
[source,java]
----
@@ -85,7 +84,7 @@ Camel `HttpMessage` as shown in the custom `Processor` below :
[source,java]
----
.process(exchange -> {
- // grab message as HttpMessage
+ // grab the message as HttpMessage
HttpMessage message = exchange.getMessage(HttpMessage.class);
// use getRequest() / getResponse() to access Vertx directly
// you can add custom headers
@@ -115,8 +114,8 @@ Http authentication is disabled by default. In can be enabled by calling `setEna
Default http authentication takes http-basic credentials and compares them with those provided in camel-platform-http-vertx-auth.properties file.
To be more specific, default http authentication uses https://vertx.io/docs/apidocs/io/vertx/ext/web/handler/BasicAuthHandler.html[BasicAuthHandler] and https://vertx.io/docs/vertx-auth-properties/java/[PropertyFileAuthentication].
-To set up custom authentication, you need to create custom `AuthenticationConfigEntries`, as shown in example below.
-Mind that in Vert.x order of adding `AuthenticationHandlers` matters, so `AuthenticationConfigEntries` with more specific url path are applied first.
+To set up custom authentication, you need to create custom `AuthenticationConfigEntries`, as shown in the example below.
+Mind that in Vert.x order of adding `AuthenticationHandlers` matters, so `AuthenticationConfigEntries` with a more specific url path is applied first.
[source,java]
----