Fix swagger-maven-plugin failing to generate FilesApi endpoints (#1786)

The swagger-maven-plugin (v3.1.8) was skipping FilesApi.java during Swagger generation because it internally expects javax.servlet classes but the project uses Jakarta EE (jakarta.servlet). This caused all /api/v1/spaces/{spaceGuid}/files endpoints to be removed from mtarest.yaml on every build.
Added javax.servlet-api as a provided dependency to satisfy the plugin's internal class resolution.

Author: IvanBorislavovDimitrov

multiapps-controller-api/pom.xml

@@ -68,6 +68,12 @@
             <artifactId>jaxb-api</artifactId>
             <scope>provided</scope>
         </dependency>
+        <!-- Required by swagger-maven-plugin during compile to process MultipartHttpServletRequest -->
+        <dependency>
+            <groupId>javax.servlet</groupId>
+            <artifactId>javax.servlet-api</artifactId>
+            <scope>provided</scope>
+        </dependency>
     </dependencies>
 
     <build>

multiapps-controller-api/src/main/resources/mtarest.yaml

@@ -426,6 +426,9 @@ definitions:
       mta_id:
         type: "string"
         readOnly: true
+      schema_version:
+        type: "string"
+        readOnly: true
       client_actions:
         type: "array"
         readOnly: true
@@ -463,6 +466,9 @@ definitions:
       file_url:
         type: "string"
         readOnly: true
+      credentials:
+        readOnly: true
+        $ref: "#/definitions/UserCredentials"
   Info:
     type: "object"
     properties:
@@ -643,3 +649,12 @@ definitions:
       name:
         type: "string"
         readOnly: true
+  UserCredentials:
+    type: "object"
+    properties:
+      username:
+        type: "string"
+        readOnly: true
+      password:
+        type: "string"
+        readOnly: true

pom.xml

@@ -60,6 +60,7 @@
         <commons-logging.version>1.3.5</commons-logging.version>
         <google-cloud.version>2.62.1</google-cloud.version>
         <google-cloud-nio.version>0.128.11</google-cloud-nio.version>
+        <javax.servlet-api.version>4.0.1</javax.servlet-api.version>
     </properties>
     <modules>
         <module>multiapps-controller-client</module>
@@ -403,6 +404,14 @@
                 <version>${servlet-api.version}</version>
                 <scope>provided</scope>
             </dependency>
+            <!-- Required by swagger-maven-plugin during compile to process MultipartHttpServletRequest. Migrate once swagger plugin supports Jakarta namespace. -->
+            <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
+            <dependency>
+                <groupId>javax.servlet</groupId>
+                <artifactId>javax.servlet-api</artifactId>
+                <version>${javax.servlet-api.version}</version>
+                <scope>provided</scope>
+            </dependency>
             <!-- https://mvnrepository.com/artifact/jakarta.annotation/jakarta.annotation-api -->
             <dependency>
                 <groupId>jakarta.annotation</groupId>