若依集成Nutz框架指南

admin

若依集成Nutz框架指南
1. Nutz框架简介

若依集成Nutz框架指南

Nutz 是一个轻量级、开源的 Java 框架，专注于帮助开发者快速构建企业级应用。框架提供了一系列实用组件，简化了开发工作。以下是 Nutz 框架的一些关键特性：

• 轻量灵活：框架本身设计简洁，核心功能不依赖复杂的第三方库，适合轻量项目的开发。
• 依赖注入与 AOP 支持：通过内置的依赖注入 (DI) 和面向切面编程 (AOP)，Nutz 可以轻松实现模块之间的解耦。
• 强大的 ORM 功能：支持主流数据库（如 MySQL、Oracle、PostgreSQL 等），简化了数据操作。
• 模块化设计：不同功能划分为独立模块，可按需加载，提升了开发的灵活性。
• 丰富的工具集：内置常用工具类、模板引擎、缓存机制等，满足多种开发需求。
• 活跃的社区支持：拥有详尽的文档和活跃的社区，开发者可以轻松获取帮助。
  
  

这些特性使得 Nutz 成为 Java 开发者在企业级项目中的理想选择。

2. 在pom.xml中添加依赖

在项目的根目录下的 pom.xml 文件中加入以下依赖：

1. <!-- Nutz 框架 -->
   
2. <dependency>
   
3.     <groupId>org.nutz</groupId>
   
4.     <artifactId>nutz-plugins-spring-boot-starter</artifactId>
   
5.     <version>1.r.68.v20201205</version>
   
6. </dependency>
   
7. 
   
8. <!-- Beetl 模板引擎 -->
   
9. <dependency>
   
10.     <groupId>com.ibeetl</groupId>
    
11.     <artifactId>beetl</artifactId>
    
12.     <version>3.10.0.RELEASE</version>
    
13. </dependency>

复制代码

3. 配置文件 application.yml 更新

在 application.yml 文件中添加以下配置：

1. nutz:
   
2.   json:
   
3.     enabled: false
   
4.     mode: compact
   
5.     compact: true
   
6.     auto-unicode: false
   
7.     date-format: yyyy-MM-dd HH:mm:ss
   
8.   dao:
   
9.     runtime:
   
10.       create: false
    
11.       migration: false
    
12.       add-column: false
    
13.       delete-column: false
    
14.       foce-create: false
    
15.       check-index: true
    
16.       basepackage:
    
17.         - com.ruoyi.domain
    
18.     sql-manager:
    
19.       mode: file
    
20.       paths:
    
21.         - sqls
    
22.     sql-template:
    
23.       enable: true
    
24.       type: beetl

复制代码

此配置文件主要定义了 Nutz 框架的 JSON 处理方式、DAO 配置和 SQL 模板的使用。

4. 指定编译版本

确保项目的 JDK 版本为 1.8。若未指定 JDK 版本，可能会导致启动时发生如下错误：

Error creating bean with name 'dao' defined in class path resource ...

编译时注意检查 JDK 版本配置，如下图所示：

若依集成Nutz框架指南

5. 启动测试

在项目成功配置依赖后，启动项目并查看控制台输出。如果没有报错，说明 Nutz 框架已经正常集成。启动测试如图：

若依集成Nutz框架指南

6. 控制器代码示例

接下来，我们编写一个简单的控制器示例来验证 Nutz 框架的运行状态。以下是 PersonController 控制器的代码：

1. package com.ruoyi.controller;
   
2. 
   
3. import com.ruoyi.common.core.domain.R;
   
4. import com.ruoyi.domain.Person;
   
5. import org.nutz.dao.Cnd;
   
6. import org.nutz.dao.Dao;
   
7. import org.springframework.beans.factory.annotation.Autowired;
   
8. import org.springframework.web.bind.annotation.GetMapping;
   
9. import org.springframework.web.bind.annotation.RequestMapping;
   
10. import org.springframework.web.bind.annotation.RestController;
    
11. 
    
12. import java.util.List;
    
13. 
    
14. @RestController
    
15. @RequestMapping("/api/v1/person")
    
16. public class PersonController {
    
17. 
    
18.     @Autowired
    
19.     private Dao dao;
    
20. 
    
21.     // 添加person
    
22.     @GetMapping("/add")
    
23.     public R<Person> add() {
    
24.         Person p = new Person();
    
25.         p.setName("ABC");
    
26.         p.setAge(20);
    
27.         Person insert = dao.insert(p);
    
28.         return R.ok(insert);
    
29.     }
    
30. 
    
31.     // 获取person列表
    
32.     @GetMapping("/list")
    
33.     public R<List<Person>> list() {
    
34.         List<Person> query = dao.query(Person.class, Cnd.NEW());
    
35.         return R.ok(query);
    
36.     }
    
37. 
    
38.     // 修改person
    
39.     @GetMapping("/update")
    
40.     public R<Object> update(Person person) {
    
41.         int update = dao.update(person);
    
42.         return R.ok(update);
    
43.     }
    
44. 
    
45.     // 删除person
    
46.     @GetMapping("/delete")
    
47.     public R<Object> delete(Person person) {
    
48.         int update = dao.delete(person);
    
49.         return R.ok(update);
    
50.     }
    
51. }

复制代码

此控制器提供了增删改查四个接口，分别用于添加、获取、更新和删除 Person 对象。

通过以上操作，若依项目已经成功集成 Nutz 框架，您可以进一步根据项目需求扩展其功能。