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]
 ----