Nutz 的 Spring Boot 启动器 nutz-spring-boot-starter

Apache
Java
跨平台
2020-01-18
Kerbores

疫情之下,程序员如何转型?共享数字化转型加速度,就在微软在线技术峰会>>>

概述

nutz-spring-boot-starter 是提供在 spring-boot 环境下使用 nutz 相关功能的插件,使用 spring-boot auto configuration 机制实现,引入 jar 即可使用。so easy!!!

功能

提供在spring-boot环境下使用Nutz的一组启动器,包含但不限于以下功能:

  • nutz-dao集成
    • 自动注入nutz-dao
    • 提供nutz-dao的sqlmanager支持
    • 提供nutz-dao的sqltpl支持
    • 提供自动DDL的支持
    • BaseService支持
  • nutz-json支持
  • nutz.cn 内网穿透福利ngrok的支持

开始使用

使用之前请确保熟悉使用 spring-boot 进行项目开发,本文档仅限于 nutz-spring-boot-starter 插件的相关描述,如有 spring-boot 相关问题请查阅 https://spring.io/projects/spring-boot 

依赖添加

nutz-spring-boot-starter release 版本已发布至 maven 中央仓库,使用 maven 进行依赖管理请添加如下依赖信息:

<dependency>
	<groupId>org.nutz</groupId>
	<artifactId>nutz-spring-boot-starter</artifactId>
	<version>2.2.3.RELEASE</version>
</dependency>

snapshot 版本发布至 https://jfrog.nutz.cn/artifactory/snapshots, 如需使用请添加如下仓库设置内容:

<repositories>
	<repository>
		<id>nutz</id>
		<url>https://jfrog.nutz.cn/artifactory/jcenter</url>
	</repository>
	<repository>
		<id>nutz-snapshots</id>
		<url>https://jfrog.nutz.cn/artifactory/snapshots</url>
		<snapshots>
			<enabled>true</enabled>
			<updatePolicy>always</updatePolicy>
		</snapshots>
		<releases>
			<enabled>false</enabled>
		</releases>
	</repository>
</repositories>

使用其他依赖管理工具请根据 maven 配置进行调整。

使用 dao

引入 jar 包在配置了数据源的前提下将自动注入 Dao 对象,nutz-dao 的具体使用请参考 https://www.nutzam.com

配置

使用过程中可以对 nutz-dao 的自动建表和变更、自定义 sql 和 sql template 相关信息进行定制化配置,具体参照下文详细说明。

自动建表

自动建表和变更是 nutz 提供的自动 ddl 功能,解决在开发过程中数据表频繁表更导致代码和数据库定义的频繁更改问题。因可能进行字段删除等相关操作导致数据丢失,建议在生成环境禁用相关功能。相关配置项目详细说明如下:

nutz:
  dao:
    runtime:
      create: true #是否自动建表 默认true
      migration: true #是否自动变更 默认true
      add-column: true # 是否添加列 默认true
      delete-column: true # 是否删除列 默认true
      foce-create: false # 是否删表重建,注意此功能会删除全部表及数据,一般应用于demo或测试 默认false
      check-index: true # 是否检查索引 默认true
      basepackage: # 相关实体所在包
        - org.nutz.demo.bean

根据 nutz 官方描述,相关包下配置了@Table 注解的实体均会自动创建表,自动建表有以下局限性:

  • 不生成外键,我们也不推荐用外键
  • 只能解决一般建表需求,复杂的表结构请通过自定义 sql 完成
  • 由于 spring-boot 资源扫描原因,如打包后使用需要在包名配置前加上 BOOT-INF.classes.

自定义 sql

Nutz.Dao 提供了大多数简单的操作,在 80%以上的情况下,你并不需要编写 SQL,因为 Nutz.Dao 会自动替你 生成可以使用的 SQL。但是,在某些特殊的情况下,尤其是考虑到效率等问题,直接写作 SQL 仍然是程序员们 的一个杀手锏,有了这个杀手锏,程序员们永远可以针对任何数据库做他们想要的任何操作。

nutz-dao 默认扫描 sqls 目录下的全部.sql/.sqls/.sqlx 文件相关,自定义配置及说明如下:

nutz:
  dao:
    sql-manager:
      mode: file #自定义sql管理模式 file和xml
      paths: # 自定义sql文件路径
        - sqls

sql template

sql template 是使用模版引擎在 nutz-dao 的自定义 sql 相关参数注入之前对原始 sql 进行处理的机制,能实现类似 mybatis 的动态 sql 效果。目前内置支持 BEETL、 FREEMARKER、JETBRICK 和 VELOCITY 四种模版引擎。

使用前需要自行引入相关模板引擎依赖,同时不提供对模板引擎本身的任何配置支持。相关配置及说明如下:

nutz:
  dao:
    sql-template:
      enable: true #是否启用 默认false
      type: beetl #模板引擎类型,默认beetl

使用 json

json 支持是使用 nutz-json 对 spring-mvc HttpMessageConverter 扩展实现对象序列化和反序列化的的功能,相关功能默认启用。

定制 json

使用过程中可以对 json 格式进行自定义,相关配置说明如下:

nutz:
  json:
    enabled: true #是否启用,默认true
    mode: compact #json模式,默认compact
    ignore-null: true # 是否忽略空对象
    compact: true # 是否启用压缩模式
    date-format: yyyy-MM-dd Hh🇲🇲ss # 日期格式化
    ... #更多相关配置参照ide提示进行即可

使用 ngrok

ngrok 是由 https://nutz.cn 提供的内网穿透支持,可以用于本地项目的演示或者类似微信开发类公网接口的调试。相关配置如下:

nutz:
  ngrok:
    port: 8080 #代理的本地端口,默认使用server.port信息
    token: abcdef #ngrok token 请到 https://nutz.cn 申请

支持和维护

相关技术支持请联系作者:kerbores#gmail.com

的码云指数为
超过 的项目
加载中

评论(0)

暂无评论

nutz-spring-boot-starter 2.2.4.RELEASE 发布

nutz-spring-boot-starter 2.2.4.RELEASE发布了,主要包含以下更新内容: spring-boot版本升级至 2.2.4.RELEASE 删除部分标注过期的方法 添加通用service相关方法注释内容 用新的API进行demo改...

02/05 08:55

nutz-spring-boot-starter 2.2.3.RELEASE 发布

nutz-spring-boot-starter 2.2.3.RELEASE发布了,可以直接从maven中央库下载使用,坐标如下: <dependency> <groupId>org.nutz</groupId> <artifactId>nutz-spring-boot-starter</artifa...

01/19 09:39

没有更多内容

加载失败,请刷新页面

没有更多内容

暂无问答

创建自己的Spring Boot starter

创建自己的Spring Boot starter

2017/10/25 11:01
165
0
spring boot 自定义 starter

本文用于 spring boot starter 开发。源码参见 https://gitee.com/emperors/spring-boot-integration/tree/master/hello-spring-boot-starter 本工程依赖 <properties> <project.build.sour...

2018/06/28 12:18
95
0
【Spring Boot】16.自定义starter

自定义starter 自定义starter: 这个场景需要使用到的依赖是什么? 如何编写自动配置? 以我们web场景启动器的自动配置类WebMVCAutoConfiguration类为例: @Configuration @ConditionalOnWeb...

2018/12/27 09:23
262
0
【Spring Boot 系列 自定义启动器Starter】

对应常用的功能组件,我们可以将其制作成一个Starter.这样在整个系统中都能达到只需要导入依赖即可使用功能,无需其他配置。 1、Starter命名规则 1.1、官方命名方式 前缀:spring-boot-start...

2018/09/14 19:48
423
0
spring boot(2)起步依赖spring-boot-starter-*详解

spring-boot-starter --The core Spring Boot starter, including auto-configuration support, logging and YAML. --Spring Boot starter核心模块,包括自动配置支持,日志和YAML。 spring...

2017/10/25 20:31
723
0
Spring Boot的启动器Starter详解

Spring Boot的启动器Starter详解 Spring Boot应用启动器基本的一共有44种,具体如下: 1)spring-boot-starter 这是Spring Boot的核心启动器,包含了自动配置、日志和YAML。 2)spring-boot...

2018/02/22 13:12
450
0
dubbo-spring-boot-starter小试牛刀

序 本文主要展示一下dubbo-spring-boot-starter的使用。 maven <dependency> <groupId>com.alibaba.spring.boot</groupId> <artifactId>dubbo-spring-boot-starter</artifactId>......

2018/08/05 21:50
297
0
应用框架(Spring-Boot入门与Starter)

Spring-Boot入门 Spring Boot 应用架构部署 了解Spring boot starter parent 我们的应用pom会从spring-boot-starter-parent继承什么?......

2019/06/19 19:58
180
0
bucket4j-spring-boot-starter小试牛刀

序 本文主要研究一下如何使用bucket4j-spring-boot-starter进行限流 maven <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actua......

2018/09/02 16:20
832
0
spring-boot-unitils-starter完全spring boot化

针对配置的问题进行改进,使其完全遵循spring boot规则 一、问题 在上一篇文章中,我们的配置都是放在unitils.properties,如下: unitils.modules=database,dbunit,springBoot unitils.mod...

2018/07/10 00:08
714
0

没有更多内容

加载失败,请刷新页面

返回顶部
顶部