Nima - alternative maven-compiler-plugin

Author: rob-bygrave

http/index.html

@@ -1368,20 +1368,15 @@ <h2 id="default">@Default</h3>
 </div>
 <h2 id="filter">@Filter</h2><hr/>
 <p>
-  Annotate methods with <code>@Filter</code> for HTTP filter web routes. Filters allow you to intercept a request before it hits a handler endpoint.
+  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)
 </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="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="c1">//... filter logic</span>
 <span class="o">}</span>
 </pre></div>
 </div>
@@ -1391,24 +1386,18 @@ <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="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="c1">//... filter logic</span>
 <span class="o">}</span>
 </pre></div>
 </div>
 
 <h4>Javalin</h4>
 <p>
-  <code>@Filter</code> correspond to Javalin <code>before</code> handlers, and can have a <code>Context</code> parameter.
+   Javalin filters correspond to <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="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="c1">//... filter logic</span>
 <span class="o">}</span>
 </pre></div>
 </div>

nima/index.html

@@ -202,6 +202,40 @@ <h4>2a. JDK 23+</h4>
 <span class="nt">&lt;/properties&gt;</span>
 </pre></div>
 </div>
+  <details>
+    <summary><code>Alternative: maven-compiler-plugin</code></summary>
+    <p>
+      Alternatively we can explicitly configure the <code>maven-compiler-plugin</code>
+      to specify the annotation processor paths:
+    </p>
+    <div class="syntax xml"><div class="highlight"><pre><span></span><span class="nt">&lt;build&gt;</span>
+  <span class="nt">&lt;plugins&gt;</span>
+
+    <span class="nt">&lt;plugin&gt;</span>
+      <span class="nt">&lt;groupId&gt;</span>org.apache.maven.plugins<span class="nt">&lt;/groupId&gt;</span>
+      <span class="nt">&lt;artifactId&gt;</span>maven-compiler-plugin<span class="nt">&lt;/artifactId&gt;</span>
+      <span class="nt">&lt;version&gt;</span>3.14.1<span class="nt">&lt;/version&gt;</span>
+      <span class="nt">&lt;configuration&gt;</span>
+        <span class="nt">&lt;annotationProcessorPaths&gt;</span>
+          <span class="nt">&lt;path&gt;</span>
+            <span class="nt">&lt;groupId&gt;</span>io.avaje<span class="nt">&lt;/groupId&gt;</span>
+            <span class="nt">&lt;artifactId&gt;</span>avaje-nima-generator<span class="nt">&lt;/artifactId&gt;</span>
+            <span class="nt">&lt;version&gt;</span>&#36;{avaje-nima.version}<span class="nt">&lt;/version&gt;</span>
+          <span class="nt">&lt;/path&gt;</span>
+          <span class="nt">&lt;path&gt;</span>
+            <span class="nt">&lt;groupId&gt;</span>io.ebean<span class="nt">&lt;/groupId&gt;</span>
+            <span class="nt">&lt;artifactId&gt;</span>querybean-generator<span class="nt">&lt;/artifactId&gt;</span>
+            <span class="nt">&lt;version&gt;</span>&#36;{ebean.version}<span class="nt">&lt;/version&gt;</span>
+          <span class="nt">&lt;/path&gt;</span>
+        <span class="nt">&lt;/annotationProcessorPaths&gt;</span>
+      <span class="nt">&lt;/configuration&gt;</span>
+    <span class="nt">&lt;/plugin&gt;</span>
+
+  <span class="nt">&lt;/plugins&gt;</span>
+<span class="nt">&lt;/build&gt;</span>
+</pre></div>
+</div>
+  </details>
 
   <h2 id="first-controller">Controller</h2>
   <p>