[python] SpringCloud Alibaba实战（5：子模块基本业务开发）

源码地址：https://gitee.com/fighter3/eshop-project.git
持续更新中……

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.2.2.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
    </parent>

<!--使用properties统一管理版本-->
  <properties>
    <java.version>1.8</java.version>
    <spring.boot.version>2.2.2.RELEASE</spring.boot.version>
  </properties>
   <!--统一管理项目依赖版本-->
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>${spring.boot.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

<mybatis.plus.version>3.4.1</mybatis.plus.version>

<!--mybatis-plus依赖-->
      <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>${mybatis.plus.version}</version>
      </dependency>
      <!--mybatis-plus代码生成器依赖-->
      <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-generator</artifactId>
        <version>${mybatis.plus.version}</version>
      </dependency>
      <!--模板引擎依赖，即使不需要生成模板，也需要引入-->
      <dependency>
        <groupId>org.apache.velocity</groupId>
        <artifactId>velocity-engine-core</artifactId>
        <version>2.2</version>
      </dependency>
      <!--mysql驱动-->
      <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
      </dependency>

为了接口测试的方便，我们还引入了swagger2的增强工具knife4j

<!--knife4j依赖-->
      <dependency>
        <groupId>com.github.xiaoymin</groupId>
        <artifactId>knife4j-spring-boot-starter</artifactId>
        <version>${knife4j-version}</version>
      </dependency>

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <dependency>
      <groupId>com.baomidou</groupId>
      <artifactId>mybatis-plus-boot-starter</artifactId>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
      <groupId>com.baomidou</groupId>
      <artifactId>mybatis-plus-generator</artifactId>
    </dependency>
    <!--模板引擎依赖，即使不需要生成模板，也需要引入-->
    <dependency>
      <groupId>org.apache.velocity</groupId>
      <artifactId>velocity-engine-core</artifactId>
      <version>2.2</version>
    </dependency>
    <!--mysql驱动-->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <scope>runtime</scope>
    </dependency>
    <dependency>
      <groupId>com.github.xiaoymin</groupId>
      <artifactId>knife4j-spring-boot-starter</artifactId>
    </dependency>
    <!--lombok-->
    <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <optional>true</optional>
    </dependency>

我们还引入了lombok用来简化代码，使用lombok可以省去生成大量getter/setter代码。在Idea中使用需要安装插件，在插件里自行搜索安装即可。

• 由于代码生成器与业务无关，所以将代码生成类建在测试目录下：
  

• 代码生成器类的相关代码
  

public class MySQLCodeGenerator {
  /**
   * <p>
   * 读取控制台内容
   * </p>
   */
  public static String scanner(String tip) {
    Scanner scanner = new Scanner(System.in);
    StringBuilder help = new StringBuilder();
    help.append("请输入" + tip + "：");
    System.out.println(help.toString());
    if (scanner.hasNext()) {
      String ipt = scanner.next();
      if (StringUtils.isNotBlank(ipt)) {
        return ipt;
      }
    }
    throw new MybatisPlusException("请输入正确的" + tip + "！");
  }
  public static void main(String[] args) {
    // 代码生成器
    AutoGenerator mpg = new AutoGenerator();
    // 全局配置
    GlobalConfig gc = new GlobalConfig();
    //设置项目位置，这里直接设置为绝对路径
    String projectPath = "D:\\WorkSpace\\IdeaProjects\\eshop-project\\eshop-user";
    //输出目录
    gc.setOutputDir(projectPath + "/src/main/java");
    gc.setAuthor("三分恶");
    gc.setOpen(false);
    gc.setSwagger2(true);   //实体属性 Swagger2 注解
    mpg.setGlobalConfig(gc);
    // 数据源配置
    DataSourceConfig dsc = new DataSourceConfig();
    dsc.setUrl("jdbc:mysql://localhost:3306/shop_user?characterEncoding=utf-8&allowMultiQueries=true&serverTimezone=GMT%2B8");
    dsc.setDriverName("com.mysql.cj.jdbc.Driver");
    dsc.setUsername("root");
    dsc.setPassword("root");
    mpg.setDataSource(dsc);
    //包配置
    PackageConfig pc = new PackageConfig();
    //模块名配置
    //pc.setModuleName(scanner("模块名"));
    pc.setParent("cn.fighter3");
    mpg.setPackageInfo(pc);
    // 自定义配置
    InjectionConfig cfg = new InjectionConfig() {
      @Override
      public void initMap() {
        // to do nothing
      }
    };

    ///策略配置
    StrategyConfig strategy = new StrategyConfig();
    strategy.setNaming(NamingStrategy.underline_to_camel);
    strategy.setColumnNaming(NamingStrategy.underline_to_camel);
    //strategy.setSuperEntityClass("你自己的父类实体,没有就不用设置!");
    //【实体】是否为lombok模型
    strategy.setEntityLombokModel(true);
    //生成 @RestController 控制器
    strategy.setRestControllerStyle(true);
    // 公共父类
    //strategy.setSuperControllerClass("你自己的父类控制器,没有就不用设置!");
    // 写于父类中的公共字段
    //strategy.setSuperEntityColumns("id");
    strategy.setInclude(scanner("表名，多个英文逗号分割").split(","));
    strategy.setControllerMappingHyphenStyle(true);
    strategy.setTablePrefix(pc.getModuleName() + "_");
    mpg.setStrategy(strategy);
    mpg.execute();
  }
}

• 生成代码很简单，直接运行代码生成器类，输入表名就行了
  

• 生成的代码如下：
  

• 在resource目录下添加配置文件application.yml，写入相关配置：
  

# 数据源配置
spring:
  datasource:
  driver-class-name: com.mysql.cj.jdbc.Driver
  url: jdbc:mysql://localhost:3306/shop_user?characterEncoding=utf-8&allowMultiQueries=true&serverTimezone=GMT%2B8
  username: root
  password: root

• 在cn.fighter3包下手动创建启动类EshopUserApplication.java：
  

@SpringBootApplication
@MapperScan("cn.fighter3.mapper")
public class EshopUserApplication {
  public static void main(String[] args) {
    SpringApplication.run(EshopUserApplication.class, args);
  }
}

• 在pom.xml文件中添加对common模块的依赖
  

<dependency>
      <groupId>cn.fighter3</groupId>
      <artifactId>eshop-common</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>

• 在common工程中创建统一的结果返回类
  

/**
 * @Author: 三分恶
 * @Date: 2021/5/16
 * @Description: 统一结果返回类
 **/
@Data
@Builder
@AllArgsConstructor
public class CommonResult<T> implements Serializable {
  private static final long serialVersionUID = 1L;
  @Tolerate
  public CommonResult() {
  }
  private Integer code;
  private String message;
  private T data;
  public static CommonResult ok() {
    return CommonResult.builder().code(200).message("请求成功").build();
  }
  public static CommonResult ok(Object data) {
    return CommonResult.builder().code(200).message("请求成功").data(data).build();
  }
  public static CommonResult error(String message) {
    return CommonResult.builder().code(500).message("响应异常").build();
  }
}

• 在ShopUserController.java中编写相关接口的代码
  

/**
 * <p>
 * 用户表 前端控制器
 * </p>
 *
 * @author 三分恶
 * @since 2021-05-16
 */
@RestController
@RequestMapping("/shop-user")
@Api(value = "用户信息接口", tags = "用户接口")
public class ShopUserController {
  @Autowired
  private IShopUserService shopUserService;
  @PostMapping("/user/add")
  @ApiOperation(value = "添加用户接口")
  public CommonResult addUser(@RequestBody ShopUser shopUser) {
    this.shopUserService.save(shopUser);
    return CommonResult.ok();
  }
  @GetMapping("/user/get-by-id")
  @ApiOperation(value = "根据id获取用户信息接口")
  public CommonResult getUserById(@RequestParam Integer id) {
    ShopUser shopUser = this.shopUserService.getById(id);
    return CommonResult.ok(shopUser);
  }
}

• 
  
  
  
  • 
    
  
  
• 在Idea中， 找到Build,Execution,Deployment >> Compiler >> Java Compiler ，把JDK版本改成8。
  
• 在Idea中， File->Project Structure，在source中将Language level 从5.0改为8。
  
  
  
  • 
    
  
  

“简单的事情重复做，重复的事情认真做，认真的事情有创造性地做！”——
我是三分恶，可以叫我老三/三分/三哥/三子，一个能文能武的全栈开发，咱们下期见！