better filter doc

Author: SentryMan

http/index.html

@@ -1368,15 +1368,20 @@ <h2 id="default">@Default</h3>
 </div>
 <h2 id="filter">@Filter</h2><hr/>
 <p>
-  Annotate methods with <code>@Filter</code> for HTTP filter web routes. Filter web routes behave similarly to void <code>@Get</code> methods (They can use header/query/cookie parameters with type conversion)
+  Annotate methods with <code>@Filter</code> for HTTP filter web routes. Filters allow you to intercept a request before it hits a handler endpoint.
 </p>
 <h4>Jex</h4>
 <p>
   Jex filters must have a <code>FilterChain</code> parameter, and optionally can add <code>Context</code>.
 </p>
 <div class="syntax java"><div class="highlight"><pre><span></span><span class="nd">@Filter</span>
 <span class="kt">void</span> <span class="nf">filter</span><span class="o">(</span><span class="n">FilterChain</span> <span class="n">chain</span><span class="o">,</span> <span class="n">Context</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
- <span class="c1">//... filter logic</span>
+  <span class="n">System</span><span class="o">.</span><span class="na field">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">&quot;before request&quot;</span><span class="o">);</span>
+  <span class="c1">// proceed to the next filter in the chain, or the endpoint handler if  at the end of</span>
+  <span class="c1">// the chain</span>
+  <span class="n">chain</span><span class="o">.</span><span class="na">proceed</span><span class="o">();</span>
+  <span class="c1">// do something after the request executes</span>
+  <span class="n">System</span><span class="o">.</span><span class="na field">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">&quot;after request&quot;</span><span class="o">);</span>
 <span class="o">}</span>
 </pre></div>
 </div>
@@ -1386,18 +1391,24 @@ <h4>Helidon</h4>
 </p>
 <div class="syntax java"><div class="highlight"><pre><span></span><span class="nd">@Filter</span>
 <span class="kt">void</span> <span class="nf">filter</span><span class="o">(</span><span class="n">FilterChain</span> <span class="n">chain</span><span class="o">,</span> <span class="n">RoutingRequest</span> <span class="n">req</span><span class="o">,</span> <span class="n">RoutingResponse</span> <span class="n">res</span><span class="o">)</span> <span class="o">{</span>
- <span class="c1">//... filter logic</span>
+  <span class="n">System</span><span class="o">.</span><span class="na field">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">&quot;before request&quot;</span><span class="o">);</span>
+  <span class="c1">// proceed to the next filter in the chain, or the endpoint handler if  at the end of</span>
+  <span class="c1">// the chain</span>
+  <span class="n">chain</span><span class="o">.</span><span class="na">proceed</span><span class="o">();</span>
+  <span class="c1">// do something after the request executes</span>
+  <span class="n">System</span><span class="o">.</span><span class="na field">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">&quot;after request&quot;</span><span class="o">);</span>
 <span class="o">}</span>
 </pre></div>
 </div>
 
 <h4>Javalin</h4>
 <p>
-   Javalin filters correspond to <code>before</code> handlers, and can have a <code>Context</code> parameter.
+  <code>@Filter</code> correspond to Javalin <code>before</code> handlers, and can have a <code>Context</code> parameter.
 </p>
 <div class="syntax java"><div class="highlight"><pre><span></span><span class="nd">@Filter</span>
 <span class="kt">void</span> <span class="nf">filter</span><span class="o">(</span><span class="n">Context</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
- <span class="c1">//... filter logic</span>
+  <span class="n">System</span><span class="o">.</span><span class="na field">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">&quot;before request&quot;</span><span class="o">);</span>
+  <span class="c1">//calling ctx.skipRemainingHandlers() allows you to avoid further processing</span>
 <span class="o">}</span>
 </pre></div>
 </div>