Springboot新手开发 基本总结

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

一、创建父工程

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

• 添加pom
• 这里统一放版本号

在子项目里添加启动类

@SpringBootApplication
public class EduApplication {
    public static void main(String[] args) {
        SpringApplication.run(EduApplication.class,args);
    }
}

• 注意启动类的位置

二、整合其他技术

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();
    }

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

---

配置类

注意
在配置类加上@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配置

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

注解
@Api(value = " ")用于类；
@ApiOperation()用于方法；表示一个http请求的操作
@ApiParam(name = "id" ,value = "讲师的id",required = true)用于方法的参数列表，参数，字段说明；表示对参数的添加元数据（说明或是否必填等）

---

3、 阿里云OSS存储服务

• 创建 oss的许可证AccessKey
  
• 官方文档 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包。完成对项目工程的改造。. 在前后端分离的微服务中，公共模块，大多承担的角色是，根据前端所需返回的数据类型，定义出一个或几个共同的类，满足前端类型所需
  

• 最后需要在业务模块启动类上加上注解 来扫描到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)

• 编写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.删除 配置文件的日志配置
• 2.resource文件中创建logback-spring.xml粘贴以下代码即可
  代码查看线路1 =====>点击查看代码
  代码查看线路2 =====>点击查看代码

---

最后

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