若依集成Nutz框架指南（350）

1. Nutz框架简介

Nutz框架

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

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

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

2. 在`pom.xml`中添加依赖

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

<!-- Nutz 框架 -->
<dependency>
    <groupId>org.nutz</groupId>
    <artifactId>nutz-plugins-spring-boot-starter</artifactId>
    <version>1.r.68.v20201205</version>
</dependency>

<!-- Beetl 模板引擎 -->
<dependency>
    <groupId>com.ibeetl</groupId>
    <artifactId>beetl</artifactId>
    <version>3.10.0.RELEASE</version>
</dependency>

请确保以上配置也添加到启动类工程中。

3. 配置文件 `application.yml` 更新

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

nutz:
  json:
    enabled: false
    mode: compact
    compact: true
    auto-unicode: false
    date-format: yyyy-MM-dd HH:mm:ss
  dao:
    runtime:
      create: false
      migration: false
      add-column: false
      delete-column: false
      foce-create: false
      check-index: true
      basepackage:
        - com.ruoyi.domain
    sql-manager:
      mode: file
      paths:
        - sqls
    sql-template:
      enable: true
      type: beetl

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

4. 指定编译版本

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

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

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

5. 启动测试

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

6. 控制器代码示例

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

package com.ruoyi.controller;

import com.ruoyi.common.core.domain.R;
import com.ruoyi.domain.Person;
import org.nutz.dao.Cnd;
import org.nutz.dao.Dao;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
@RequestMapping("/api/v1/person")
public class PersonController {

    @Autowired
    private Dao dao;

    // 添加person
    @GetMapping("/add")
    public R<Person> add() {
        Person p = new Person();
        p.setName("ABC");
        p.setAge(20);
        Person insert = dao.insert(p);
        return R.ok(insert);
    }

    // 获取person列表
    @GetMapping("/list")
    public R<List<Person>> list() {
        List<Person> query = dao.query(Person.class, Cnd.NEW());
        return R.ok(query);
    }

    // 修改person
    @GetMapping("/update")
    public R<Object> update(Person person) {
        int update = dao.update(person);
        return R.ok(update);
    }

    // 删除person
    @GetMapping("/delete")
    public R<Object> delete(Person person) {
        int update = dao.delete(person);
        return R.ok(update);
    }
}

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

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

开发喵星球