<mark>此插件，主要社区贡献人（人无完人）</mark>

```xml
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>activerecord-solon-plugin</artifactId>
</dependency>
```

#### 1、描述

数据扩展插件，为 Solon Data 提供基于 jfinal activerecord（[代码仓库](https://gitee.com/jfinal/activerecord)）的框架适配，以提供ORM支持。

#### 2、强调多数据源支持

* 强调多数据源的配置。例：db1，db2（只是示例，具体根据业务取名）
* 强调带 name 的 DataSource Bean
* 强调使用 @Db("name") 的数据源注解


@Db 可注入类型：

| 支持类型 | 说明 | 
| -------- | -------- | 
| Mapper.class     | 注入 Mapper。例：`@Db("db1") UserMapper userMapper`     | 
| DbPro     | 注入 DbPro。例：`@Db("db1") DbPro db1`，相当于 `Db.user("db1")`       | 
| ActiveRecordPlugin     | 注入 ActiveRecordPlugin，一般仅用于配置。例：`@Db("db1") ActiveRecordPlugin arp`      | 


#### 3、应用示例

* 数据源配置与构建（具体参考：[《数据源的配置与构建》](/article/794)）

```yml
#数据源配置块（名字按业务需要取，与 @Db 那边对起来就好）
solon.dataSources:
  db1!:
    class: "com.zaxxer.hikari.HikariDataSource"
    jdbcUrl: jdbc:mysql://localhost:3306/rock?useUnicode=true&characterEncoding=utf8&autoReconnect=true&rewriteBatchedStatements=true
    driverClassName: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456
```


* 代码应用

```java
//数据源相关的定制（可选）
@Configuration
public class Config {
    @Bean
    public void db1Init(@Db("db1") ActiveRecordPlugin arp) { //v1.10.11 后支持
        //启用开发或调试模式（可以打印sql）
        if (Solon.cfg().isDebugMode() || Solon.cfg().isFilesMode()) {
            arp.setDevMode(true);
        }
    }
    
}

//应用
@Component
public class AppService{
    @Db("db2") //v1.10.11 后支持
    DbProp db2;
    
    public void test(){
       App app = db2.template("appx_get", app_id).findFirst();
       
       //多数据源
       //db2.template("appx_get", app_id).findFirst(); //或者用 Db.use("db2")...
    }
}

//实体类
@Table(name = "appx", primaryKey = "app_id")
public class App extends Model<App> implements IBean {
    public int getAgroupId() {
        return get("agroup_id");
    }

    public String getNote() {
        return get("note");
    }

    public String getAppKey() {
        return get("app_key");
    }

    public int getAppId() {
        return get("app_id");
    }
}
```

#### 4、支持 Model 直接输出 json 

jfinal activerecord 的 Model，一般的 json 框架不适合直接将它转换成 json string。需要使用 JFinalJson 进处理。

```java
//应用加载完成事件
@Component
public class AppPluginLoadEndEventListener implements EventListener<AppPluginLoadEndEvent> {
    @Override
    public void onEvent(AppPluginLoadEndEvent e) throws Throwable {
        //定制 json 序列化输出（使用新的处理接管 "@json" 指令）
        e.app().renders().register("@json", (data, ctx) -> {
            String json = JFinalJson.getJson().toJson(data);
            ctx.outputAsJson(json);
        });
    }
}
```

**具体可参考：**

[https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4041-activerecord](https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4041-activerecord)