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 8cdb2352a9 AXIS2-6100 Add REST support for OpenAPI (formerly known as
Swagger)
8cdb2352a9 is described below
commit 8cdb2352a9351679b054dc446ec567193ba9d0ee
Author: Robert Lazarski <[email protected]>
AuthorDate: Sun Dec 21 15:00:10 2025 -1000
AXIS2-6100 Add REST support for OpenAPI (formerly known as Swagger)
---
src/site/xdoc/docs/openapi-rest-userguide.xml | 4 +++-
src/site/xdoc/docs/toc.xml | 2 +-
src/site/xdoc/index.xml | 6 ++++++
3 files changed, 10 insertions(+), 2 deletions(-)
diff --git a/src/site/xdoc/docs/openapi-rest-userguide.xml
b/src/site/xdoc/docs/openapi-rest-userguide.xml
index 4c06eda8b6..46cbe0ef13 100644
--- a/src/site/xdoc/docs/openapi-rest-userguide.xml
+++ b/src/site/xdoc/docs/openapi-rest-userguide.xml
@@ -45,7 +45,7 @@ interactive <a
href="https://swagger.io/tools/swagger-ui/";>Swagger UI</a> docume
(Spring Boot, Express.js, etc.) while maintaining API compatibility for
frontend applications
such as Excel Add-ins, React apps, and TypeScript clients.</p>
-<p><strong>New in Axis2 2.0:</strong> Complete OpenAPI 3.0.1 integration with
automatic specification
+<p><strong>New in Axis2 2.0.1:</strong> Complete OpenAPI 3.0.1 integration
with automatic specification
generation, Swagger UI support, and flexible generation modes
(AUTOMATIC/STATIC/HYBRID) designed
for real-world enterprise usage patterns.</p>
@@ -136,6 +136,8 @@ distribution</a>.</p>
<p>The sample provides a complete financial services API demonstrating
authentication,
data management, and calculation services with full OpenAPI 3.0.1
documentation.</p>
+<p><strong>Testing the Sample:</strong> The swagger-server sample includes
comprehensive unit tests for all service components and models. To run the
tests, navigate to the sample directory and execute <code>mvn test</code>. The
test suite covers authentication flows, data validation, JSON
serialization/deserialization, and service method functionality. Individual
test classes can be found in
<code>src/test/java/org/apache/axis2/samples/swagger</code> and provide
excellent examples of ho [...]
+
<h2>Creating OpenAPI REST Services</h2>
<p>The guide demonstrates how to create secure, OpenAPI-documented REST
services using
diff --git a/src/site/xdoc/docs/toc.xml b/src/site/xdoc/docs/toc.xml
index f0baaae985..cb58716d1d 100644
--- a/src/site/xdoc/docs/toc.xml
+++ b/src/site/xdoc/docs/toc.xml
@@ -54,7 +54,7 @@ Guide</a></li>
Guide</a></li>
<li><a href="adv-userguide.html">Advanced User's
Guide</a></li>
-<li><strong><a href="openapi-rest-userguide.html">OpenAPI REST Services
Guide</a></strong>
+<li><a href="openapi-rest-userguide.html">OpenAPI REST Services Guide</a>
<ul>
<li>7.1 <a href="openapi-rest-userguide.html#Introduction">Getting Started
with OpenAPI</a></li>
<li>7.2 <a
href="openapi-rest-userguide.html#OpenAPI_Integration_Features">OpenAPI
Integration Features</a></li>
diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
index f59f661e7c..e6e33e5415 100644
--- a/src/site/xdoc/index.xml
+++ b/src/site/xdoc/index.xml
@@ -160,6 +160,12 @@ supports the creation of Web Services using JavaScript
Object Notation, with <a
build POJO based services that receive and return JSON.</p>
</li>
<li>
+<p style="margin-bottom: 0in"><strong>OpenAPI support</strong> - Axis2
+supports automatic generation of <a href=
+"https://spec.openapis.org/oas/latest.html";>OpenAPI 3.0</a> specifications for
REST and JSON services, with integrated <a href=
+"https://swagger.io/tools/swagger-ui/";>Swagger UI</a> for interactive API
documentation and testing, enabling modern API development workflows.</p>
+</li>
+<li>
<p style="margin-bottom: 0in"><strong>Composition and
Extensibility</strong> - Modules and phases improve support for
composability and extensibility. Modules support composability and
