写给正在做技术选型或迁移调研的 Java 开发者

一、写在前面

如果你会 Spring Boot，那你已经会了一大半 Solon。

Solon 不是 Spring 的分支或封装，它是独立发展的全栈应用开发框架。但在设计哲学上，Solon 遵循了 Java 主流的 IoC、AOP、MVC 范式——概念相同，注解名不同。

这篇文章把 Spring Boot 到 Solon 的注解映射、配置迁移、关键差异整理成对照表，供迁移参考。

二、IoC/DI 容器：注解对照

核心原则：Solon 将 Spring 的多个细分注解合并为少数几个核心注解。

2.1 组件注册

2.2 依赖注入

注意：Solon 的 @Inject 一个注解兼顾了 Spring 中 @Autowired、@Qualifier、@Value 三个注解的功能。

2.3 生命周期与作用域

三、Web 层：Controller 改写

3.1 注解映射

3.2 Before / After 示例

Spring Boot 写法：

@RestController
@RequestMapping("/users")
public class UserController {
    
    @Autowired
    private UserService userService;
    
    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.findById(id);
    }
    
    @PostMapping
    public User create(@RequestBody User user) {
        return userService.save(user);
    }
}

Solon 写法：

@Controller
@Mapping("/users")
public class UserController {
    
    @Inject
    private UserService userService;
    
    @Get
    @Mapping("/{id}")
    public User getUser(@Path Long id) {
        return userService.findById(id);
    }
    
    @Post
    @Mapping
    public User create(@Body User user) {
        return userService.save(user);
    }
}

3.3 关键差异：Context 替代 Servlet API

Solon 不依赖 Servlet 容器，因此 HttpServletRequest / HttpServletResponse 需替换为 Context：

// Spring 写法
public User get(HttpServletRequest request) {
    String token = request.getHeader("Token");
    String id = request.getParameter("id");
}

// Solon 写法
public User get(Context ctx) {
    String token = ctx.header("Token");
    String id = ctx.param("id");
    // ctx.redirect(url) 重定向
    // ctx.render(obj)    渲染
    // ctx.remoteIp()     客户端 IP
}

⚠️ Context 只能在方法参数中注入，不能作为字段注入。

四、配置文件迁移

4.1 文件命名

4.2 常用配置键名对照

⚠️ Solon 配置键名统一使用驼峰命名（contextPath），不是短横线（context-path）。

五、数据访问：@Db 一站式注入

5.1 多数据源配置（YAML）

solon.dataSources:
  db1:
    class: com.zaxxer.hikari.HikariDataSource
    url: jdbc:mysql://localhost/test
    driverClassName: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456
  db2:
    url: jdbc:mysql://localhost/order
    driverClassName: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456

5.2 @Db 注入

// Solon 一行搞定多数据源
@Db("db1") UserMapper userMapper;
@Db("db2") OrderMapper orderMapper;

对比 Spring Boot 多数据源需要配置：多个 DataSource + 多个 SqlSessionFactory + 多个 TransactionManager + @MapperScan... Solon 使用 @Db。

5.3 ORM 集成

5.4 事务

Solon 的 @Transaction 默认遇到任何异常都回滚，无需指定异常类型。

六、测试迁移

HttpTester 用法示例：

@SolonTest(App.class)
public class UserControllerTest extends HttpTester {
    
    @Test
    public void testGetUser() {
        // GET 请求
        String resp = path("/users/1").get();
        assertEquals(200, resp.code());
        
        // POST 请求
        String json = "{\"name\":\"test\"}";
        String resp2 = path("/users").body(json).post();
        assertContains(resp2, "test");
    }
}

七、其他常见对照

八、迁移检查清单

•  POM：spring-boot-starter-parent → solon-parent
•  POM：spring-boot-starter-* → solon-* / *-solon-plugin
•  配置：application.yml → app.yml（环境文件同理）
•  启动类：@SpringBootApplication → @SolonMain
•  启动：SpringApplication.run() → Solon.start()
•  IoC：@Autowired → @Inject
•  IoC：@Service/@Repository → @Component
•  Web：@RestController → @Controller
•  Web：@RequestMapping → @Mapping
•  Web：@PathVariable → @Path
•  Web：HttpServletRequest → Context
•  配置：@Value → @Inject("${...}")
•  数据：spring.datasource.* → solon.dataSources.*
•  数据：@Transactional → @Transaction
•  测试：@SpringBootTest → @SolonTest
•  测试：MockMvc → HttpTester

九、写在最后

这篇对照表覆盖了日常开发中最常用的 90% 场景。Solon 的注解体系并非简单的"换皮"，它在统一性（@Component / @Inject / @Condition）和简便性（@Db / 无需 @RefreshScope）上做了明显的设计取舍。

建议迁移前先通读一遍官方对比文档：solon.noear.org/article/compare-springboot

如有具体的迁移场景未覆盖，欢迎在评论区留言。