AXIS2-6100 Add REST support for OpenAPI (formerly known as Swagger)

Author: robertlazarski

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 how to test REST services with custom authentication patterns and complex data models.</p>
+
 <h2>Creating OpenAPI REST Services</h2>
 
 <p>The guide demonstrates how to create secure, OpenAPI-documented REST services using

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>

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