当前位置: 首页 > news >正文

使用 OpenRewrite 简化 Java 和 SpringBoot 迁移

大家好,这里是架构资源栈!点击上方关注,添加“星标”,一起学习大厂前沿架构!

移民的挑战

随着 Spring Boot 2.x 等旧版本即将到期且不再获得支持,迁移到较新版本对于安全性、兼容性和性能改进至关重要。但是,迁移过程面临着一些挑战:

1. 重大变更:主要版本升级通常会引入重大变更。例如,Spring Boot 3.x 需要Java 17并从 迁移javax.*jakarta.* packages

**2. 弃用的 API:**许多常用的 API 和模式已被弃用并需要替换。

**3. 手动更新:**传统迁移需要手动更新依赖项、重构代码和修复兼容性问题。

**4. 耗时:**大型代码库可能需要数周或数月才能迁移,从而增加项目成本和风险。

**5. 测试负担:**必须彻底测试每个更改以确保功能保持完好。

那么,我们如何才能简化和加速迁移过程呢?这就是 OpenRewrite 发挥作用的地方。

开放重写

OpenRewrite是一款开源的自动化代码重构工具,可帮助开发人员减少技术负担。它为框架迁移、安全修复和代码样式提供了预构建的重构方案,将工作量从几小时缩短到几分钟。

Gradle 和 Maven 插件可轻松将这些更改应用于存储库。OpenRewrite 社区最初专注于 Java,目前正在积极扩展对更多语言和框架的支持。

主要特点

  • **自动重构:**自动更新代码语法、依赖关系和模式
  • **基于配方:**使用声明性配方来定义转换规则
  • **风格保存:**保留原始代码格式和注释
  • **大规模变更:**可以一致地处理整个代码库
  • **可扩展:**支持针对特定迁移需求的自定义配方

它是如何工作的?

  • OpenRewrite 修改代表源代码的无损语义树 (LST),并将它们转换回源代码。

  • 您可以查看更改并根据需要提交。

  • 修改是使用访问者进行的,访问者被分组到菜谱中。

  • 配方可确保变化最小,并保持原始格式。

实践

在本文中,我将演示如何使用 OpenRewrite 将使用 Java 8、Spring Boot 2.x 和 JUnit 4 构建的简单 CRUD Spring Boot 应用程序迁移到 Java 21、Spring Boot 3.3 和 JUnit 5。

代码库

1)pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.7.14</version><relativePath/></parent><groupId>com.example</groupId><artifactId>demo</artifactId><version>0.0.1-SNAPSHOT</version><name>demo</name><description>Demo project for Spring Boot Migration</description><properties><java.version>1.8</java.version></properties><dependencies>// dependencies: starter web, data-jpa, etc</dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>

Enter fullscreen mode Exit fullscreen mode

2)UserController.java
@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserRepository userRepository;@Autowiredprivate UserService userService;@RequestMapping(method = RequestMethod.GET)public List<User> getAllUsers() {return userRepository.findAll();}@RequestMapping(method = RequestMethod.POST)public ResponseEntity<?> createUser(@Valid @RequestBody User user) {User savedUser = userRepository.save(user);return ResponseEntity.ok().build();}@RequestMapping(value = "/{id}", method = RequestMethod.GET)public ResponseEntity<User> getUserById(@PathVariable("id") Long id) {User user = userRepository.findById(id).orElse(null);return user != null ? ResponseEntity.ok(user) : ResponseEntity.notFound().build();}@RequestMapping(value = "/username")public ResponseEntity<User> getUserByUsername(@RequestParam String username) {User user = userService.findByUsername(username);return user != null ? ResponseEntity.ok(user) : ResponseEntity.notFound().build();}}

Enter fullscreen mode Exit fullscreen mode

3)UserService.java
@Service
public class UserService {@Autowiredprivate UserRepository userRepository;public User findByUsername(String username) {return userRepository.findByUsernameNative(username);}
}

Enter fullscreen mode Exit fullscreen mode

4)UserRepository.java
@Repository
public interface UserRepository extends JpaRepository<User, Long> {@Query(value = "SELECT * FROM users WHERE username = ?1", nativeQuery = true)User findByUsernameNative(String username);}

Enter fullscreen mode Exit fullscreen mode

5)用户.java
import javax.persistence.*;
import javax.validation.constraints.NotNull;@Entity
@Table(name = "users")
public class User {@Id@GeneratedValue(strategy = GenerationType.AUTO)private Long id;@NotNull@Column(nullable = false)private String username;@Columnprivate String email;// setter, getter
}

Enter fullscreen mode Exit fullscreen mode

6)UserControllerTest.java
@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureMockMvc
public class UserControllerTest {@Autowiredprivate MockMvc mockMvc;@Autowiredprivate UserRepository userRepository;@Beforepublic void setup() {userRepository.deleteAll();}@Testpublic void testCreateUser() throws Exception {String userJson = "{"username":"testuser","email":"test@example.com"}";mockMvc.perform(MockMvcRequestBuilders.post("/api/users").contentType(MediaType.APPLICATION_JSON).content(userJson)).andExpect(MockMvcResultMatchers.status().isOk());}@Testpublic void testGetUser() throws Exception {User user = new User();user.setUsername("testuser");user.setEmail("test@example.com");userRepository.save(user);mockMvc.perform(MockMvcRequestBuilders.get("/api/users/" + user.getId())).andExpect(MockMvcResultMatchers.status().isOk()).andExpect(MockMvcResultMatchers.jsonPath("$.username").value("testuser"));}
}

Enter fullscreen mode Exit fullscreen mode

手动迁移

在使用 OpenRewrite 之前,让我们看看如果手动迁移到 Java 21 和 Spring Boot 3.3 会发生什么。

首先,更新pom.xml

<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.3.10</version><relativePath/>
</parent><properties><java.version>21</java.version>
</properties>

Enter fullscreen mode Exit fullscreen mode

接下来,使用 Maven 清理并构建项目:

mvn clean install

有几个编译错误

好的,让我们恢复更改并使用 OpenRewrite 进行迁移。

使用 OpenRewrite 进行迁移

添加 OpenRewrite 插件

在 中pom.xml,添加 OpenRewrite Maven 插件。如果您使用的是 Gradle,则可以添加 Gradle 插件。

<build><plugins><plugin><groupId>org.openrewrite.maven</groupId><artifactId>rewrite-maven-plugin</artifactId><version>6.3.2</version></plugin></plugins>
</build>

Enter fullscreen mode Exit fullscreen mode

选择迁移方案

要发现所有可用的配方,您可以检查配方目录,其中列出了所有可用的配方,包括:Java、Spring Boot、Hibernate、Quarkus、Scala、.NET、Jenkins 等。

在这个展示中,我将使用三个配方:Java 8 到 21、Spring 2 到 3 和 JUnit 4 到 5。

让我们将食谱添加到 pom.xml 中;每个食谱都有自己的依赖项。

<plugin><groupId>org.openrewrite.maven</groupId><artifactId>rewrite-maven-plugin</artifactId><version>6.3.2</version><configuration><exportDatatables>true</exportDatatables><activeRecipes><recipe>org.openrewrite.java.migrate.UpgradeToJava21</recipe><recipe>org.openrewrite.java.spring.boot2.SpringBoot2JUnit4to5Migration</recipe><recipe>org.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_3</recipe></activeRecipes></configuration><dependencies><dependency><groupId>org.openrewrite.recipe</groupId><artifactId>rewrite-migrate-java</artifactId><version>3.4.0</version></dependency><dependency><groupId>org.openrewrite.recipe</groupId><artifactId>rewrite-spring</artifactId><version>6.3.0</version></dependency></dependencies>
</plugin>

Enter fullscreen mode Exit fullscreen mode

现在,运行 Maven 来安装 OpenRewrite 插件及其配方:

mvn clean install

预览迁移

OpenRewrite 提供了一种dryRun模式,允许开发人员在实际应用更改之前通过以下方式预览更改:

mvn rewrite:dryRun

您可以看到将用于实际迁移的更改。

应用迁移

现在,让我们进行迁移

mvn rewrite:run

使用您的 IDE 或差异检查工具来检查更改。

1.更新pom.xml:自动更新SpringBoot版本到3.3.10,Java版本到21,删除JUnit4。

2. 更新控制器
从 迁移javax.*jakarta.* packages,改为使用@GetMapping@PostMapping用于专用注释。

3. 更新单元测试
替换@Before@BeforeEach,更新包名称

限制

在这个展示中,OpenRewrite 成功迁移到 Java 21 和 Spring Boot 3.3,但它仍然存在一些限制。
由于 OpenRewrite 依赖于预定义的配方,因此它支持许多常见框架,但并非全部。

例如,如果您需要将第三方库(如 Ehcache2)迁移到 Ehcache3(Spring 3.0 中不再支持),OpenRewrite 不提供内置配方。在这种情况下,您必须编写自定义配方或手动执行迁移。

如果您创建了自定义配方,请考虑将其贡献给 OpenRewrite 社区,以帮助其他进行类似迁移的人。

概括

OpenRewrite 通过以下方式显著简化了 Java 和 Spring Boot 迁移过程:

  • 自动重复代码更改
  • 减少迁移时间和精力
  • 最大限度地减少人为错误
  • 标准化迁移方法

虽然 OpenRewrite并不能消除测试和验证的需要,但它减少了迁移所需的手动工作量。这使开发人员可以专注于更复杂的迁移方面和业务逻辑更新。

参考

  1. https://docs.openrewrite.org/
  2. https://github.com/openrewrite

原文地址:https://mp.weixin.qq.com/s/c7HMXbTJdxYWj53tKdY3hA

http://www.xdnf.cn/news/379.html

相关文章:

  • SDL基础
  • MATLAB 控制系统设计与仿真 - 34
  • 机器学习 | 细说Deep Q-Network(DQN)
  • 学习笔记十六——Rust Monad从头学
  • 【音视频】FLV格式分析
  • 让SQL飞起来:搭建企业AI应用的SQL性能优化实战
  • 2025年4月16日华为留学生笔试第二题200分
  • VS2022+QT环境配置及基本操作
  • Prometheus thanos架构
  • 2025年4月16日华为留学生笔试第三题300分
  • 自求导实现线性回归与PyTorch张量详解
  • Unity3d 6(6000.*.*)版本国区下载安装参考
  • 机器学习简介
  • python20-while和for in的美
  • 2025能源网络安全大赛CTF --- Crypto wp
  • visual studio 2022更改项目名称,灾难性故障(异常来自HRESULT)
  • 【Rust基础】使用Rocket构建基于SSE的流式回复
  • 模型加载常见问题
  • C/C++指针
  • 四大wordpress模板站
  • 第十七届“华中杯”大学生数学建模挑战赛题目A题 晶硅片产销策略优化 完整成品 代码 模型 思路 分享