This is an automated email from the ASF dual-hosted git repository.
robertlazarski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/axis-axis2-java-core.git
The following commit(s) were added to refs/heads/master by this push:
new 73a75cb66b docs: Remove remaining hallucinated params from springboot
and wildfly guides
73a75cb66b is described below
commit 73a75cb66bca58d03a84e04a74877dbb46098877
Author: Robert Lazarski <[email protected]>
AuthorDate: Mon May 11 03:43:56 2026 -1000
docs: Remove remaining hallucinated params from springboot and wildfly
guides
Final straggler cleanup from the xdoc audit:
- json-springboot-userguide.xml: removed memoryPressureThreshold,
enableStreamingOptimization, enableMemoryOptimization,
largePayloadThreshold from transport sender config and param list
- json-springboot-tomcat11-userguide.xml: same removals
- http2-transport-additions.xml: removed http2FallbackEnabled (3 spots),
streamingEnabled, largePayloadThreshold, serverPushEnabled,
memoryOptimized, compressionEnabled from parameter reference table
- wildfly-http2-integration-guide.xml: replaced fake
AsyncProcessingThreshold, LargePayloadThreshold,
moshiStreamingBufferSize with real param names in alignment tables
All fake params now removed across all xdoc files.
Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
---
src/site/xdoc/docs/http2-transport-additions.xml | 21 ++++++++-------------
.../docs/json-springboot-tomcat11-userguide.xml | 16 +++++-----------
src/site/xdoc/docs/json-springboot-userguide.xml | 16 +++++-----------
.../xdoc/docs/wildfly-http2-integration-guide.xml | 22 +++++++++++-----------
4 files changed, 29 insertions(+), 46 deletions(-)
diff --git a/src/site/xdoc/docs/http2-transport-additions.xml
b/src/site/xdoc/docs/http2-transport-additions.xml
index 31705f168e..990e974f50 100644
--- a/src/site/xdoc/docs/http2-transport-additions.xml
+++ b/src/site/xdoc/docs/http2-transport-additions.xml
@@ -46,14 +46,11 @@
<!-- Large Payload Optimization -->
<parameter name="maxConcurrentStreams">20</parameter>
<parameter name="initialWindowSize">2097152</parameter> <!--
2MB window -->
- <parameter name="streamingEnabled">true</parameter>
-
- <!-- Cloud-Optimized Timeouts -->
+ <!-- Timeouts -->
<parameter name="connectionTimeout">30000</parameter> <!--
30s connect -->
<parameter name="responseTimeout">300000</parameter> <!--
5min response -->
- <!-- Fallback for Load Balancers -->
- <parameter name="http2FallbackEnabled">true</parameter>
+ <!-- HTTP/2 fallback to HTTP/1.1 is automatic via TLS ALPN -->
</transportSender>
</pre>
@@ -149,10 +146,9 @@ synchronous round-trip.</p>
<tr><th>Parameter</th><th>Description</th><th>Default</th><th>Range</th></tr>
<tr><td>maxConcurrentStreams</td><td>Maximum concurrent streams per
connection. Lower values (4-8) force the connection pool to spread streams
across multiple TCP connections — better for workloads with few concurrent
large payloads. Higher values (50-100) maximize multiplexing efficiency for
many small concurrent requests.</td><td>100</td><td>1-1000</td></tr>
<tr><td>initialWindowSize</td><td>HTTP/2 per-stream flow-control window
(bytes). Determines how much data can be in-flight per stream before the sender
waits for a WINDOW_UPDATE. For payloads above 1 MB, use at least 1-2 MB to
avoid excessive round-trips. Not related to the server-side
FlushingOutputStream 64 KB flush
interval.</td><td>2097152</td><td>64KB-16MB</td></tr>
-<tr><td>serverPushEnabled</td><td>Enable HTTP/2 server
push</td><td>false</td><td>true/false</td></tr>
-<tr><td>memoryOptimized</td><td>Enable adaptive memory
management</td><td>true</td><td>true/false</td></tr>
-<tr><td>largePayloadThreshold</td><td>Threshold for large payload
optimization</td><td>52428800</td><td>10MB-500MB</td></tr>
-<tr><td>compressionEnabled</td><td>Enable intelligent
compression</td><td>true</td><td>true/false</td></tr>
+<tr><td>streamingBufferSize</td><td>Buffer size for streaming flush
interval</td><td>65536</td><td>8KB-1MB</td></tr>
+<tr><td>connectionTimeout</td><td>Connection establishment timeout
(ms)</td><td>30000</td><td>1000-60000</td></tr>
+<tr><td>responseTimeout</td><td>Response timeout for large payloads
(ms)</td><td>300000</td><td>30000-600000</td></tr>
</table>
<h3>Tuning for Different Workloads</h3>
@@ -216,8 +212,7 @@ load) and larger <code>initialWindowSize</code> (eliminates
per-stream flow-cont
<parameter name="maxFrameSize">32768</parameter>
<!-- Large Payload Optimization -->
- <parameter name="largePayloadThreshold">52428800</parameter>
- <parameter name="streamingEnabled">true</parameter>
+ <parameter name="streamingBufferSize">65536</parameter>
<parameter name="memoryOptimized">true</parameter>
<!-- Connection Management: sized for concurrent large-payload fan-out
-->
@@ -423,7 +418,7 @@ negotiation is slow on your network.</p>
<parameter name="PROTOCOL">HTTP/2.0</parameter>
<parameter name="maxConcurrentStreams">100</parameter>
<parameter name="initialWindowSize">2097152</parameter>
- <parameter name="http2FallbackEnabled">true</parameter>
+ <!-- Fallback to HTTP/1.1 is automatic via TLS ALPN negotiation -->
</transportSender>
</pre>
@@ -585,7 +580,7 @@ set the cached HTTP/2 client using the
CACHED_HTTP2_ASYNC_CLIENT property before
<p>HTTP/2 requires TLS 1.2+ with ALPN. Use OpenJDK 11+ (ALPN built in).
If ALPN negotiation fails, the transport falls back to HTTP/1.1
-automatically when <code>http2FallbackEnabled=true</code>.</p>
+automatically (no configuration flag required).</p>
</body>
</html>
diff --git a/src/site/xdoc/docs/json-springboot-tomcat11-userguide.xml
b/src/site/xdoc/docs/json-springboot-tomcat11-userguide.xml
index 0e76354fc7..94bff890a8 100644
--- a/src/site/xdoc/docs/json-springboot-tomcat11-userguide.xml
+++ b/src/site/xdoc/docs/json-springboot-tomcat11-userguide.xml
@@ -423,23 +423,17 @@ sender configuration to your axis2.xml file:</p>
<parameter name="connectionTimeout">30000</parameter>
<parameter name="responseTimeout">300000</parameter>
<parameter name="streamingBufferSize">65536</parameter>
- <parameter name="memoryPressureThreshold">0.8</parameter>
- <!-- Enterprise Big Data Configuration -->
- <parameter name="enableStreamingOptimization">true</parameter>
- <parameter name="enableMemoryOptimization">true</parameter>
- <parameter name="largePayloadThreshold">52428800</parameter>
<!-- 50MB -->
</transportSender>
</pre>
<h3>HTTP/2 Configuration Parameters</h3>
<ul>
-<li><strong>maxConcurrentStreams:</strong> Maximum concurrent HTTP/2 streams
(default: 100 for 2GB heap)</li>
-<li><strong>initialWindowSize:</strong> HTTP/2 flow control window size
(default: 64KB)</li>
-<li><strong>responseTimeout:</strong> Timeout for large payload processing
(default: 5 minutes)</li>
-<li><strong>streamingBufferSize:</strong> Buffer size for streaming operations
(default: 64KB)</li>
-<li><strong>memoryPressureThreshold:</strong> Memory usage threshold for
adaptive flow control (default: 80%)</li>
-<li><strong>largePayloadThreshold:</strong> Size threshold for streaming
optimization (default: 50MB)</li>
+<li><strong>maxConcurrentStreams:</strong> Maximum concurrent HTTP/2 streams
(default: 100)</li>
+<li><strong>initialWindowSize:</strong> HTTP/2 flow control window size
(default: 64KB, 2MB recommended for large payloads)</li>
+<li><strong>connectionTimeout:</strong> Connection establishment timeout in ms
(default: 30000)</li>
+<li><strong>responseTimeout:</strong> Timeout for large payload processing
(default: 300000 = 5 minutes)</li>
+<li><strong>streamingBufferSize:</strong> Buffer size for streaming operations
(default: 65536 = 64KB)</li>
</ul>
<h3>Client Usage with cURL</h3>
diff --git a/src/site/xdoc/docs/json-springboot-userguide.xml
b/src/site/xdoc/docs/json-springboot-userguide.xml
index 9ce1d120ac..cf65ffefef 100644
--- a/src/site/xdoc/docs/json-springboot-userguide.xml
+++ b/src/site/xdoc/docs/json-springboot-userguide.xml
@@ -324,23 +324,17 @@ sender configuration to your axis2.xml file:</p>
<parameter name="connectionTimeout">30000</parameter>
<parameter name="responseTimeout">300000</parameter>
<parameter name="streamingBufferSize">65536</parameter>
- <parameter name="memoryPressureThreshold">0.8</parameter>
- <!-- Enterprise Big Data Configuration -->
- <parameter name="enableStreamingOptimization">true</parameter>
- <parameter name="enableMemoryOptimization">true</parameter>
- <parameter name="largePayloadThreshold">52428800</parameter>
<!-- 50MB -->
</transportSender>
</pre>
<h3>HTTP/2 Configuration Parameters</h3>
<ul>
-<li><strong>maxConcurrentStreams:</strong> Maximum concurrent HTTP/2 streams
(default: 100 for 2GB heap)</li>
-<li><strong>initialWindowSize:</strong> HTTP/2 flow control window size
(default: 64KB)</li>
-<li><strong>responseTimeout:</strong> Timeout for large payload processing
(default: 5 minutes)</li>
-<li><strong>streamingBufferSize:</strong> Buffer size for streaming operations
(default: 64KB)</li>
-<li><strong>memoryPressureThreshold:</strong> Memory usage threshold for
adaptive flow control (default: 80%)</li>
-<li><strong>largePayloadThreshold:</strong> Size threshold for streaming
optimization (default: 50MB)</li>
+<li><strong>maxConcurrentStreams:</strong> Maximum concurrent HTTP/2 streams
(default: 100)</li>
+<li><strong>initialWindowSize:</strong> HTTP/2 flow control window size
(default: 64KB, 2MB recommended for large payloads)</li>
+<li><strong>connectionTimeout:</strong> Connection establishment timeout in ms
(default: 30000)</li>
+<li><strong>responseTimeout:</strong> Timeout for large payload processing
(default: 300000 = 5 minutes)</li>
+<li><strong>streamingBufferSize:</strong> Buffer size for streaming operations
(default: 65536 = 64KB)</li>
</ul>
<h3>Client Usage with cURL</h3>
diff --git a/src/site/xdoc/docs/wildfly-http2-integration-guide.xml
b/src/site/xdoc/docs/wildfly-http2-integration-guide.xml
index d3cfa50711..17a0b88428 100644
--- a/src/site/xdoc/docs/wildfly-http2-integration-guide.xml
+++ b/src/site/xdoc/docs/wildfly-http2-integration-guide.xml
@@ -197,8 +197,8 @@ depend on payload size, network conditions, and JVM
configuration):</em>
<tr>
<td><strong>Connection Management</strong></td>
<td><code>http2-max-concurrent-streams="128"</code></td>
- <td><code>AsyncProcessingThreshold="1048576"</code> (1MB)</td>
- <td>✅ WildFly manages 128 concurrent HTTP/2 streams, Moshi H2 handles
async processing for large payloads</td>
+ <td><code>maxConcurrentStreams="128"</code> (axis2.xml)</td>
+ <td>✅ WildFly manages 128 concurrent HTTP/2 streams, transport sender
matches</td>
</tr>
<tr>
<td><strong>Flow Control Window</strong></td>
@@ -209,20 +209,20 @@ depend on payload size, network conditions, and JVM
configuration):</em>
<tr>
<td><strong>Streaming Flush Buffer</strong></td>
<td><code>buffer-size="65536"</code></td>
- <td><code>moshiStreamingBufferSize="65536"</code></td>
+ <td><code>streamingBufferSize="65536"</code> (in axis2.xml)</td>
<td>✅ 64KB server-side flush interval — good TTFB, independent of
flow-control window</td>
</tr>
<tr>
<td><strong>Large Payload Handling</strong></td>
<td><code>http2-max-frame-size="16384"</code></td>
- <td><code>LargePayloadThreshold="10485760"</code> (10MB)</td>
- <td>✅ WildFly chunks large payloads efficiently, Moshi H2 applies
optimization for 10MB+ payloads</td>
+ <td>(handled by message formatter)</td>
+ <td>✅ WildFly chunks large payloads via HTTP/2 DATA frames; streaming
formatter handles large JSON</td>
</tr>
<tr>
<td><strong>Memory Optimization</strong></td>
<td><code>http2-header-table-size="4096"</code></td>
- <td><code>MemoryOptimizationThreshold="52428800"</code> (50MB)</td>
- <td>✅ Conservative header caching + aggressive JSON memory management for
large payloads</td>
+ <td>(JVM <code>-XX:MaxDirectMemorySize</code>)</td>
+ <td>✅ Conservative header caching; JVM direct memory controls HTTP/2
buffer limits</td>
</tr>
<tr>
<td><strong>Push Disabled</strong></td>
@@ -307,15 +307,15 @@ Complete HTTP/2 + JSON Optimization Stack:
<td><strong>Buffer Sizes</strong></td>
<td><code>buffer-size="32768"</code><br/><code>http2-max-frame-size="32768"</code></td>
<td><code>streamingBufferSize="32768"</code></td>
- <td><code>moshiStreamingBufferSize="32768"</code></td>
+ <td><code>streamingBufferSize="32768"</code></td>
<td>✅ <strong>ALIGNED</strong>: All using 32KB</td>
</tr>
<tr>
<td><strong>Window Sizes</strong></td>
<td><code>http2-initial-window-size="2097152"</code></td>
<td><code>initialWindowSize="2097152"</code></td>
- <td><code>AsyncProcessingThreshold="1MB"</code></td>
- <td>✅ <strong>TUNED</strong>: 2MB flow-control windows, 1MB async
threshold</td>
+ <td>(automatic)</td>
+ <td>✅ <strong>TUNED</strong>: 2MB flow-control windows across both
layers</td>
</tr>
<tr>
<td><strong>Stream Limits</strong></td>
@@ -328,7 +328,7 @@ Complete HTTP/2 + JSON Optimization Stack:
<td><strong>Large Payloads</strong></td>
<td><code>max-post-size="104857600"</code>
(100MB)<br/><code>no-request-timeout="300000"</code> (5min)</td>
<td><code>responseTimeout="300000"</code> (5min)</td>
- <td><code>LargePayloadThreshold="10MB"</code></td>
+ <td>(handled by formatter)</td>
<td>✅ <strong>COORDINATED</strong>: Timeout alignment</td>
</tr>
<tr>
