feat: Add report section "Updated Phases for Graceful Shutdown"

Author: fabapp2

components/sbm-recipes-boot-upgrade/src/main/resources/recipes/27_30/report/sbu30-report.yaml

@@ -668,6 +668,39 @@
         #    - Your Name[@your-gh-handle]
 
 
+        #
+        # Generated from https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Migration-Guide#updated-phases-for-graceful-shutdown
+        #
+        - title: "Updated Phases for Graceful Shutdown"
+          helper:
+            type: org.springframework.sbm.boot.upgrade_27_30.report.helper.ConditionOnlyHelper
+            condition:
+              type: org.springframework.sbm.build.migration.conditions.AnyEffectiveDependencyExistMatchingRegex
+              dependencies:
+                - 'org\.springframework\.boot\:spring-boot\:.*'
+
+          change: |-
+            The phases used by the `SmartLifecycle` implementations for graceful shutdown have been updated.
+            Graceful shutdown now begins in phase `SmartLifecycle.DEFAULT_PHASE - 2048` and the web server is stopped in phase `SmartLifecycle.DEFAULT_PHASE - 1024`.
+            Any `SmartLifecycle` implementations that were participating in graceful shutdown should be updated accordingly.
+
+          affected: |-
+            Actually, we don't know if the scanned application is really affected by this change.
+            But we found a dependency matching regex `org\.springframework\.boot\:spring-boot\:.*`.
+            This indicates that the scanned application might be affected.
+          remediation:
+            description: |-
+              [IMPORTANT]
+              ====
+              This section has been automatically generated from the https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Migration-Guide#updated-phases-for-graceful-shutdown[Spring Boot 3.0 Migration Guide^, role="ext-link"]. +
+              **Please consider contributing to issue https://github.com/spring-projects-experimental/spring-boot-migrator/issues/630[#630^, role="ext-link"]**
+              ====
+          projects:
+            - spring-web
+          gitHubIssue: 630
+        #  contributors:
+        #    - Your Name[@your-gh-handle]
+
       footer: |-
         We want to say thank you to all Contributors:
         

components/sbm-recipes-boot-upgrade/src/test/java/org/springframework/sbm/boot/upgrade_27_30/report/helper/UpdatedPhasesForGracefulShutdownReportSectionTest.java

@@ -0,0 +1,71 @@
+/*
+ * Copyright 2021 - 2022 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.sbm.boot.upgrade_27_30.report.helper;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.DisplayName;
+import org.springframework.sbm.boot.upgrade_27_30.report.SpringBootUpgradeReportTestSupport;
+import org.springframework.sbm.engine.context.ProjectContext;
+import org.springframework.sbm.project.resource.TestProjectContext;
+
+class UpdatedPhasesForGracefulShutdownReportSectionTest {
+    @Test
+    @DisplayName("Updated Phases for Graceful Shutdown should render")
+    void withSingleModuleApplicationShouldRender() {
+         ProjectContext context = TestProjectContext
+                         .buildProjectContext()
+                         .withSpringBootParentOf("2.7.5")
+                         .withBuildFileHavingDependencies("org.springframework.boot:spring-boot:2.7.5")
+                         .build();
+
+                 SpringBootUpgradeReportTestSupport.generatedSection("Updated Phases for Graceful Shutdown")
+                         .fromProjectContext(context)
+                         .shouldRenderAs("""
+                                          === Updated Phases for Graceful Shutdown
+                                          
+                                          ==== What Changed
+                                          The phases used by the `SmartLifecycle` implementations for graceful shutdown have been updated.
+                                          Graceful shutdown now begins in phase `SmartLifecycle.DEFAULT_PHASE - 2048` and the web server is stopped in phase `SmartLifecycle.DEFAULT_PHASE - 1024`.
+                                          Any `SmartLifecycle` implementations that were participating in graceful shutdown should be updated accordingly.
+                                          
+                                          ==== Why is the application affected
+                                          Actually, we don't know if the scanned application is really affected by this change.
+                                          But we found a dependency matching regex `org\\.springframework\\.boot\\:spring-boot\\:.*`.
+                                          This indicates that the scanned application might be affected.
+                                          
+                                          ==== Remediation
+                                          [IMPORTANT]
+                                          ====
+                                          This section has been automatically generated from the https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Migration-Guide#updated-phases-for-graceful-shutdown[Spring Boot 3.0 Migration Guide^, role="ext-link"]. +
+                                          **Please consider contributing to issue https://github.com/spring-projects-experimental/spring-boot-migrator/issues/630[#630^, role="ext-link"]**
+                                          ====
+                                          
+
+                                          """);
+    }
+
+    @Test
+    @DisplayName("Updated Phases for Graceful Shutdown should not render")
+    void shouldNotRender() {
+         ProjectContext context = TestProjectContext
+                         .buildProjectContext()
+                         .build();
+
+                 SpringBootUpgradeReportTestSupport.generatedSection("Updated Phases for Graceful Shutdown")
+                         .fromProjectContext(context)
+                         .shouldNotRender();
+    }
+}