Springboot新手开发 基本总结

前言
作者简介:我是笑霸final,一名热爱技术的在校学生。
个人主页:个人主页1 || 笑霸final的主页2
系列专栏:后端专栏
如果文章知识点有错误的地方,请指正!和大家一起学习,一起进步
如果感觉博主的文章还不错的话,点赞 + 关注 + 收藏

在这里插入图片描述

目录

  • 一、创建父工程
    • 在子项目里添加启动类
  • 二、整合其他技术
    • 1、整合 mybatis-plus 持久层
      • 分页功能
    • 2、整合swagger
    • 3、 阿里云OSS存储服务
    • 4、使用EasyExcel读取Excel内容
  • 三、common模块
    • 1.统一返回数据格式
    • 2.数据自动填充
    • 3.统一异常处理
      • 全局异常处理
      • 自定义异常处理
    • 4.统一日志处理
  • 最后

一、创建父工程

创建过程就不用多说 我们来详细说一下 pom.xml 文件

  • 添加pomSpringboot新手开发 基本总结_第1张图片
  • 这里统一放版本号 Springboot新手开发 基本总结_第2张图片

在子项目里添加启动类

@SpringBootApplication
public class EduApplication {
    public static void main(String[] args) {
        SpringApplication.run(EduApplication.class,args);
    }
}
  • 注意启动类的位置Springboot新手开发 基本总结_第3张图片

二、整合其他技术

1、整合 mybatis-plus 持久层

导入坐标


            <dependency>
                <groupId>com.baomidougroupId>
                <artifactId>mybatis-plus-boot-starterartifactId>
                <version>${mybatis-plus.version}version>
            dependency>

            
            <dependency>
                <groupId>org.apache.velocitygroupId>
                <artifactId>velocity-engine-coreartifactId>
                <version>${velocity.version}version>
            dependency>

代码生成器
详细请看另一博客:点此跳转

 public static void main(String[] args) {

        // 1、创建代码生成器
        AutoGenerator mpg = new AutoGenerator();

        // 2、全局配置
        // 全局配置
        GlobalConfig gc = new GlobalConfig();
        String projectPath = System.getProperty("user.dir");
        //gc.setOutputDir(projectPath + "/src/main/java");
        //代码生成的路径E:\学习\学习项目\硅谷课堂\ggkt_parent
        gc.setOutputDir("E:\\programming\\java\\学习项目\\guli_paret\\service\\service_edu\\src\\main\\java");
        gc.setServiceName("%sService");	//去掉Service接口的首字母I
        gc.setAuthor("xbfinal");
        gc.setOpen(false);
        mpg.setGlobalConfig(gc);

        // 3、数据源配置
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setUrl("jdbc:mysql://localhost:3306/guli?serverTimezone=GMT%2B8");
        dsc.setDriverName("com.mysql.cj.jdbc.Driver");
        dsc.setUsername("root");//数据库账号
        dsc.setPassword("123456");//数据库密码
        dsc.setDbType(DbType.MYSQL);
        mpg.setDataSource(dsc);

        // 4、包配置
        PackageConfig pc = new PackageConfig();
        pc.setParent("com.xbfinal");
        pc.setModuleName("eduservice"); //模块名
        pc.setController("controller");
        pc.setEntity("entity");
        pc.setService("service");
        pc.setMapper("mapper");
        mpg.setPackageInfo(pc);

        // 5、策略配置
        StrategyConfig strategy = new StrategyConfig();
        strategy.setInclude("edu_teacher");
        strategy.setNaming(NamingStrategy.underline_to_camel);//数据库表映射到实体的命名策略
        strategy.setColumnNaming(NamingStrategy.underline_to_camel);//数据库表字段映射到实体的命名策略
        strategy.setEntityLombokModel(true); // lombok 模型 @Accessors(chain = true) setter链式操作
        strategy.setRestControllerStyle(true); //restful api风格控制器
        strategy.setControllerMappingHyphenStyle(true); //url中驼峰转连字符
        mpg.setStrategy(strategy);

        // 6、执行
        mpg.execute();
    }

运行上面代码就能生成相应的结构了


配置类
Springboot新手开发 基本总结_第4张图片

注意
在配置类加上@MapperScan("mapper路径") 才能识别出mapper的位置
逻辑删除需要配置bean

@Configuration
@MapperScan("com.xbfinal.eduservice.mapper")
public class EduConfig {

    /**
     * 逻辑删除插件
     */
    @Bean
    public ISqlInjector sqlInjector(){
        return new LogicSqlInjector();
    }
}


分页功能

  • 在配置类加上分页插件
/**
     * mp分页插件
     */
    @Bean
    public PaginationInterceptor paginationInterceptor(){
        return new PaginationInterceptor();
    }
  • 编写分页接口的方法
 		 //创建page对象 参数1页码 参数2条数
        Page<EduTeacher> page=new Page<>(current,limit);
        //调用Service.page 方法实现分页 参数1 page对象 参数2 条件
        IPage<EduTeacher> page1 = eduTeacherService.page(page, null);

插件使用方法查看官网 ===>分页插件PaginationInnerInterceptor


有条件查询分页功能

  • 第一步 把条件值传递到接口里面(把条件封装到对象中 vo)在这里插入图片描述
  • 编写方法
//由于博客笔记原因 代码我就都写controller了
 @PostMapping("pageTeacherCondition/{current}/{limit}")
    public Result pageTeacherCondition(
            @ApiParam(name = "current",value = "当前页码")
            @PathVariable("current") Long current,
            @ApiParam(name = "limit",value = "条数")
            @PathVariable("limit") Long limit ,
            @RequestBody(required = false) TeacherQuery teacherQuery){

        //1.创建page对象
        Page<EduTeacher> page=new Page<>(current,limit);
        //构建条件wrapper
        QueryWrapper<EduTeacher> wrapper = new QueryWrapper<>();
        //多条件组合查询
        String name=teacherQuery.getName();
        if (!StrUtil.isEmpty(name)){
            //模糊查询 参数1 数据库中字段的名称  参数2 条件
            wrapper.like("name",name);
        }
        //调用Service.page 方法实现分页 参数1 page对象 参数2 条件
        IPage<EduTeacher> page1 = eduTeacherService.page(page,wrapper );

        return Result.ok().addData(page1);
    }

2、整合swagger

基本情况请看 :swagger入门
注意事项:需要在 配置类打开注解@EnableSwagger2//开启Swagger配置

Springboot新手开发 基本总结_第5张图片

访问http://localhost:当前服务模块的端口号/swagger-ui.html 进入ui界面
例如 http://localhost:8001/swagger-ui.html

注解
@Api(value = " ")用于类;
@ApiOperation()用于方法;表示一个http请求的操作
@ApiParam(name = "id" ,value = "讲师的id",required = true)用于方法的参数列表,参数,字段说明;表示对参数的添加元数据(说明或是否必填等)
Springboot新手开发 基本总结_第6张图片Springboot新手开发 基本总结_第7张图片
Springboot新手开发 基本总结_第8张图片


3、 阿里云OSS存储服务

  • 创建 oss的许可证AccessKey
    Springboot新手开发 基本总结_第9张图片
  • 官方文档 SDK文档 不多说了很详细的文档 还有视频

配置文件

#阿里云 OSS
#服务器地址
aliyun.oss.file.endpoint=oss-cn-beijing.aliyuncs.com #(服务器地址)
aliyun.oss.file.keyid=AccessKey ID
aliyun.oss.file.keysecret=AccessKey Secret
#bucket可以在控制台创建,也可以用java创建

aliyun.oss.file.bucketname=xxxx    # xxxx是 bucket的name

出现问题

Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

  • 解决方案一:可以在配置文件配置数据库
  • 方案二():在启动类上添加属性,默认不去加载数据库 ======= == == = = = = = = == == =》 exclude = DataSourceAutoConfiguration.class在这里插入图片描述

4、使用EasyExcel读取Excel内容

三、common模块

  • common模块,也是公共模块,和父工程有着较多的相似性,其较大的作用在于为其他模块提供 共用 类,但不牵扯到其他模块的具体业务逻辑。
  • 需要在各个模块引入common模块jar包。完成对项目工程的改造。. 在前后端分离的微服务中,公共模块,大多承担的角色是,根据前端所需返回的数据类型,定义出一个或几个共同的类,满足前端类型所需
    Springboot新手开发 基本总结_第10张图片
  • 最后需要在业务模块启动类上加上注解 来扫描到common模块中的组件

1.统一返回数据格式

  • 项目中我们会将响应封装成json返回,一般我们会将所有接口的数据格式统一, 使前端(iOS Android, Web)对数据的操作更一致、轻松。
  • 一般情况下,统一返回数据格式没有固定的格式,只要能描述清楚返回的数据状态以及要返回的具体数据就可以。但是一般会包含状态码返回消息返回数据这几部分内容
  • 写一个interface 来定义成功和失败的状态码
/**
 * @author 笑霸final
 */
public interface ResultCode {

    /**
     *  自定义成功的状态码
     */
    public static Integer SUCCESS=20000;

    /**
     * 自定义失败的状态码
     */
    public static Integer ERROR=20001;
}

  • 创建统一返回结果类Result
@Data
public class Result<T> {

    @ApiModelProperty(value = "是否成功")
    private Boolean success;

    @ApiModelProperty(value = "状态码")
    private Integer code;

    @ApiModelProperty(value = "消息")
    private String message;

    @ApiModelProperty(value = "返回的数据")
    private T data;

    @ApiModelProperty(value = "动态数据")
    private Map map = new HashMap();

    /**
     * 防止直接new
     */
    private Result(){};

    /**
     * 成功的静态方法
     */
    public static<T> Result<T> ok(  ){
        Result r=new Result();
        r.success=true;
        r.code=ResultCode.SUCCESS;
        r.message="成功";
        return r;
    }

    /**
     * 失败的静态方法
     */
    public static Result failed( ){
        Result r=new Result();
        r.success=false;
        r.code=ResultCode.ERROR;
        r.message="失败";
        return r;
    }
    
    public Result addCode(Integer code){
        this.setCode(code);
        return this;
    }
    public Result addMessage(String message){
        this.setMessage(message);
        return this;
    }
    public Result<T> addData(T data){
        this.setData(data);
        return this;
    }

    /**
     * 用来操作 map = new HashMap(); 动态数据
     * @param key
     * @param value
     * @return
     */
    public Result<T> add(String key, Object value) {
        this.map.put(key, value);
        return this;
    }

}

2.数据自动填充

  • 先给需要自动填充的数据加上注解@TableField(fill = FieldFill.INSERT)或者@TableField(fill = FieldFill.INSERT_UPDATE)Springboot新手开发 基本总结_第11张图片

  • 编写MyMetaObjectHandler类去实现MetaObjectHandler接口

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        //属性名称,不是字段名称
        this.setFieldValByName("gmtCreate", new Date(), metaObject);
        this.setFieldValByName("gmtModified", new Date(), metaObject);
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.setFieldValByName("gmtModified", new Date(), metaObject);
    }
}

3.统一异常处理

全局异常处理

  • 定义一个异常类GlobalExceptionHandler并加上注解@ControllerAdvice
  • 异常处理类编写具体的对异常处理方法,在方法上添加注解@ExceptionHandler
@ControllerAdvice
@Slf4j
public class GlobalExceptionHandler {

    //全局异常处理
    @ResponseBody//返回json数据
    @ExceptionHandler(Exception.class)
    public Result error(Exception e){
        log.info("当前异常信息\n",e);
        return Result.fail("全局异常处理");
    }
}

自定义异常处理

一:创建自定义异常处理类,继承 RuntimeException

public class GgktException extends RuntimeException{
}

二:在自定义异常处理类里面创建属性

@Data
@AllArgsConstructor
@NoArgsConstructor
public class GgktException extends RuntimeException{
    private Integer code;//状态码
    private String msg;//异常信息


}

三:在全局异常处理类上添加上自定义的异常处理方法

@ControllerAdvice
@Slf4j
public class GlobalExceptionHandler {
 
    @ResponseBody//返回json数据
    @ExceptionHandler(Exception.class)   //全局异常处理Exception.class
    public Result error(Exception e){
        log.info("当前异常信息\n",e);
        return Result.fail("全局异常处理");
    }

 	@ResponseBody
    @ExceptionHandler(GgktException.class)  //自定义的异常处理方法
    public Result divError(GgktException e){
        log.info("当前异常信息\n",e.getMsg());
        return Result.fail("自定义的异常处理");
    }

四:手动抛出自定义异常

    public Result<List<Teacher>> findAllTeacher(){
        
        
        try{
            int i=1/0;
        }catch (Exception e){
            //手动抛出异常
            throw new GgktException(201,"执行了自定义异常处理");
        }
        List<Teacher> teacherList = teacherService.list();
        return Result.ok(teacherList);
    }

4.统一日志处理

在配置文件设置日志级别
logging.level.root=warn


把日志输出到文件中使用日志工具Logback用法和log4j差不多

  • 1.删除 配置文件的日志配置Springboot新手开发 基本总结_第12张图片
  • 2.resource文件中创建logback-spring.xml粘贴以下代码即可
    代码查看线路1 =====>点击查看代码
    代码查看线路2 =====>点击查看代码

最后

持续更新中 欢迎大家补充留言

你可能感兴趣的:(后端,资料,spring,boot,mybatis,java)