com.github.xiaoping1988.spring.boot:swagger-ping-spring-boot-starter

ping spring boot

License

License

Categories

Categories

Spring Boot Container Microservices Swagger Program Interface REST Frameworks
GroupId

GroupId

com.github.xiaoping1988.spring.boot
ArtifactId

ArtifactId

swagger-ping-spring-boot-starter
Last Version

Last Version

1.0.1
Release Date

Release Date

Type

Type

jar
Description

Description

ping spring boot
Project Organization

Project Organization

Pivotal Software, Inc.

Download swagger-ping-spring-boot-starter

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.xiaoping1988.spring.boot/swagger-ping-spring-boot-starter/ -->
<dependency>
    <groupId>com.github.xiaoping1988.spring.boot</groupId>
    <artifactId>swagger-ping-spring-boot-starter</artifactId>
    <version>1.0.1</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.xiaoping1988.spring.boot/swagger-ping-spring-boot-starter/
implementation 'com.github.xiaoping1988.spring.boot:swagger-ping-spring-boot-starter:1.0.1'
// https://jarcasting.com/artifacts/com.github.xiaoping1988.spring.boot/swagger-ping-spring-boot-starter/
implementation ("com.github.xiaoping1988.spring.boot:swagger-ping-spring-boot-starter:1.0.1")
'com.github.xiaoping1988.spring.boot:swagger-ping-spring-boot-starter:jar:1.0.1'
<dependency org="com.github.xiaoping1988.spring.boot" name="swagger-ping-spring-boot-starter" rev="1.0.1">
  <artifact name="swagger-ping-spring-boot-starter" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.xiaoping1988.spring.boot', module='swagger-ping-spring-boot-starter', version='1.0.1')
)
libraryDependencies += "com.github.xiaoping1988.spring.boot" % "swagger-ping-spring-boot-starter" % "1.0.1"
[com.github.xiaoping1988.spring.boot/swagger-ping-spring-boot-starter "1.0.1"]

Dependencies

compile (7)

Group / Artifact Type Version
com.github.xiaoping1988.spring.boot : swagger-ping-spring-boot-autoconfigure jar 1.0.1
org.springframework.boot : spring-boot-starter jar 1.5.6.RELEASE
org.springframework.boot : spring-boot-starter-log4j2 jar 1.5.6.RELEASE
org.springframework.boot : spring-boot-starter-web jar 1.5.6.RELEASE
org.springframework.boot : spring-boot-devtools jar 1.5.6.RELEASE
org.apache.commons : commons-lang3 jar 3.6
com.alibaba : fastjson jar 1.2.36

test (1)

Group / Artifact Type Version
org.springframework.boot : spring-boot-starter-test jar 1.5.6.RELEASE

Project Modules

There are no modules declared in this project.

ping-spring-boot

这是一个spring boot和mybatis、swagger集成的框架

帮助文档 示例项目:pring-spring-boot-sample-mybatis

spring boot和mybatis集成

maven引入如下starter

<dependency>
   <groupId>com.github.xiaoping1988.spring.boot</groupId>
   <artifactId>mybatis-ping-spring-boot-starter</artifactId>
   <version>1.0.2</version>
</dependency>

此框架实现了单表的增删改查等90%左右的功能,支持mysql和oracle数据库

实体类规范:

必须继承BaseModel或者BaseTimeModel类 BaseTimeModel已继承BaseModel类,此类有两个时间数据属性create_time(创建时间)和update_time(修改时间),实体对应的数据库表必须要有此二字段,serivce通过调用基类方法会自动更新此二字段。 所有的属性名称与数据库表字段名称保持一致

实体类的注解:

@Table: 数据库表名

@OrderBy: 排序

@Pk: 是否是主键,支持联合主键

@AutoIncrement: 如果是单一自增主键,务必在属性加上此注解

@Sequence: 如果是oracle数据库,自增主键的属性上务必加上此属性,标明自增序列

Dao层规范:

实体对应的dao必须在"实体包路径.dao"包路径下,名称必须为"实体名Dao",必须继承BaseCURDDao或者BaseQueryDao,前者支持增删改查,后者只支持查,已办视图对应的实体类Dao继承只读的Dao.

Service层规范:

必须继承BaseCURDService或者BaseQueryService,此二类已实现单表增删改查的大部分方法

自定义实体Dao的方法:

mapper文件位置在resources/mapper/,mapper文件的namespace必须是dao全路径名称,剩下的就跟平常写mybatis一样,id不能与基类dao中的方法名一样

如果想自定义一个跟实体无关的Dao,只要继承SqlMapper就行

具体可参考sample项目中的pring-spring-boot-sample-mybatis

spring boot 集成swagger

maven引入如下starter

<dependency>
    <groupId>com.github.xiaoping1988.spring.boot</groupId>
    <artifactId>swagger-ping-spring-boot-starter</artifactId>
    <version>1.0.2</version>
</dependency>

yml配置:

swagger.enable: 开启或者关闭swagger,默认为true开启

一般在生产环境关闭swagger

集成之后,就可使用swagger注解来配置接口文档,文档查看地址:http://localhost:8080/swagger-ui.html

具体可参考sample项目中的pring-spring-boot-sample-mybatis

Versions

Version
1.0.1