使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)

这是一个大胆的决定

这里是导航

  • 技术栈
  • 开发工具
  • 一、创建gradle父子项目(`deity`)
    • 1.0 简单流程示意
    • 1.1、IDEA中主要图示
      • 1.1.1 项目结构图
      • 1.1.2 IDEA中 Gradle配置
    • 1.2、`deity`父项目build.gradle文件
    • 1.3、`deity`父项目settings.gradle文件
    • 1.4、子项目build.gradle
    • 1.5、子项目中的 application.yml 配置
      • 1.5.1、`mall-Ares` application.yml
      • 1.5.2、`mall-angel`application.yml
    • 1.6、测试Controller
      • 1.6.1、`mall-Ares`测试代码
      • 1.6.2、`mall-angel`测试代码
    • 1.7、测试是否启动
  • 二、创建gitee仓库,推送到远端
    • 2.1、登录gitee新建仓库(`deity`)
      • 2.1.1、得到如下命令(新建仓库,使用`创建git仓库` 即可)
    • 2.2、git执行命令
      • 2.2.1、IDEA中可以验证代码是否上传仓库成功
      • 2.2.2、在gitee仓库中查看代码是否上传成功
    • 2.3、git 常用知识浅谈
  • 三、Nacos 服务注册 SpringCloud Alibaba
    • 3.1、启动win下的单机nacos
    • 3.2、给项目创建一个命名空间
    • 3.3、引入新的需要的依赖
      • 3.3.1 子项目依赖更新图
    • 3.4、 启动类添加 @EnableDiscoveryClient 注解
    • 3.5 、创建bootstrap.yml进行配置
    • 3.6、在nacos管理平台中查看注册进入的服务

技术栈

技术 版本
spring-boot 3.0.2
spring-cloud 2022.0.2
spring-cloud-alibaba 2022.0.0.0-RC2
mybatis-plus-boot-starter 3.5.3.1
mysql-connector-java 8.0.32

开发工具

技术 版本
java 17
gradle 7.6.1
IDEA 2022.2.4
Nvcat 15
MySQL 8.0.32

一、创建gradle父子项目(deity

1.0 简单流程示意

  • 打开IDEA创建 SpringBoot项目
  • 删除父项目中的src模块
  • 新建两个子项目(新建时会重新创建父项目src文件,删除即可)
    • 子项目:mall-Ares
    • 子项目:mall-angel
  • deity build.gradle 配置全局配置
  • mall-Ares 和 mall-angelbuild.gradle 负责引入依赖的jar

1.1、IDEA中主要图示

1.1.1 项目结构图

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第1张图片

1.1.2 IDEA中 Gradle配置

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第2张图片

1.2、deity父项目build.gradle文件

//所有buildscript{}块都必须出现在脚本中任何插件{}块之前
buildscript{ //构建gradle脚本自身需要的资源,可以声明的资源包括依赖项、第三方插件、maven仓库等等

    //统一依赖版本管理
    ext{
        mysqlVersion     = "8.0.32"  //mysql
        fastjsonVersion  = "2.0.29" //fastjson
        lombokVersion    = '1.18.26' //lombok
        springBootVersion= '3.0.2' //springBoot
        springCloudVersion= '2022.0.2' //springCloud
        springCloudAlibabaVersion='2022.0.0.0-RC2'//cloudAlibaba 2022.0.0.0-RC2
        mybatisPlusVersion   = '3.5.3.1' //mybatisPlus

    }

    //buildscript脚本构建时需要去寻找的仓库
    repositories { //从前往后顺序执行,找不到就向后查找
//		mavenLocal() //从maven本地仓库下载jar到gradle仓库
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/grails-core'}
        maven { url 'https://maven.aliyun.com/repository/google/' }
        maven { url 'https://maven.aliyun.com/repository/jcenter/' }
        maven { url "https://mvn.getui.com/nexus/content/repositories/releases/" }
        maven {
            url 'http://mirrors.huaweicloud.com/repository/maven/'
            allowInsecureProtocol = true
        }
        mavenCentral()
    }

    //构建用到的插件
    dependencies {
        classpath 'io.spring.gradle:dependency-management-plugin:1.1.0'//maven方式插件
    }

}

//插件要在最上边初始化
plugins{
    id 'org.springframework.boot' version '3.0.2'
    id 'io.spring.dependency-management' version '1.1.0'//创建于 2022 年 10 月 18 日。   2023.05.08目前为最新版本
    id 'idea'
}


//针对所有project的配置,包含根项目,除此之外还有subprojects 和 project,感兴趣的童鞋可以自行百度查阅
allprojects{
    apply plugin: 'java'	//项目是java项目
    apply plugin: 'idea'	//项目是idea项目
    apply plugin: 'org.springframework.boot'
    apply plugin: 'io.spring.dependency-management' //类似于maven的版本管理方式
    group = 'com.dage'
    version = '0.0.1-SNAPSHOT'
    //jdk版本
    sourceCompatibility = '17'
    targetCompatibility = '17'

    //必须在插入 java插件后 执行该命令
    configurations {
        compileJava{
            extendsFrom annotationProcessor
        }
    }

    //所有project项目的 jar获取方式
    tasks.withType(JavaCompile) {
        options.encoding = "UTF-8"
        options.deprecation = true
    }

    //全局配置时查找依赖的使用
    repositories{ //从前往后顺序执行,找不到就向后查找
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/grails-core'}
        maven { url 'https://maven.aliyun.com/repository/google/' }
        maven { url 'https://maven.aliyun.com/repository/jcenter/' }
        maven { url "https://mvn.getui.com/nexus/content/repositories/releases/" }
        maven {
            url 'http://mirrors.huaweicloud.com/repository/maven/'
            allowInsecureProtocol = true
        }
        mavenCentral()
    }
}

subprojects{// 子项目配置(可以理解为子模块的全局配置)
    sourceCompatibility = '17'
    targetCompatibility = '17'
    apply plugin: 'org.springframework.boot'
    apply plugin: 'io.spring.dependency-management' //类似于maven的版本管理方式

    //子model统一jar引入
    dependencies {
        annotationProcessor 'org.projectlombok:lombok' //注释处理器
        implementation 'org.projectlombok:lombok'//引入lombok依赖
    }

    //提供类似 Maven 的依赖管理和排除的 Gradle 插件
    //使用类似于maven的方式(io.spring.dependency-management) 统一版本管理
    //https://docs.spring.io/dependency-management-plugin/docs/current/reference/html/#pom-generation  学习网址
    //DSL 允许您使用:分隔的字符串来声明依赖管理,以配置托管依赖的坐标
    dependencyManagement {
        dependencies{//统一版本管理
            //DSL 允许您使用:分隔的字符串来声明依赖管理,以配置托管依赖的坐标
            dependency "mysql:mysql-connector-java:${mysqlVersion}"
            dependency "org.projectlombok:lombok:${lombokVersion}"
            dependency "com.baomidou:mybatis-plus-boot-starter:${mybatisPlusVersion}"
            dependency "com.baomidou:mybatis-plus-generator:${mybatisPlusVersion}"
            dependency "org.springframework.boot:spring-boot-starter-web:${springBootVersion}"
            dependency "org.apache.velocity:velocity-engine-core:${velocityVersion}"

        }

        imports {
            //引入 spring-cloud统一包管理
            mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
            //引入 spring-cloud-alibaba统一包管理
            mavenBom "com.alibaba.cloud:spring-cloud-alibaba-dependencies:${springCloudAlibabaVersion}"
            //引入 spring-boot统一包管理
            mavenBom "org.springframework.boot:spring-boot-dependencies:${springBootVersion}"
        }
    }

}


//禁止根项目一切行为(不影响模块)
//禁用以后执行build的时候不会构建parent项目
tasks.forEach {
    it.enabled = false
}


/**
 * Gradle打标准jar包
 * 根项目需禁用springboot插件,否则会构建失败
 * 光禁用BootJar是不行的,还要启用Jar。
 * GroovyDSL的写法,对KotlinDSL无效
 */
bootJar{enabled = false}

jar{enabled=true}
/**    KotlinDSL写法
 * tasks.bootJar {enabled = false}
 * tasks.jar {enabled = true}
 */


tasks.named('test') {
    useJUnitPlatform()
}

1.3、deity父项目settings.gradle文件

注意这里,子项目是没有settings.gradle文件的。全局只有一个settings.gradle文件

pluginManagement {
    repositories {
        //        mavenLocal() //从maven本地仓库下载jar到gradle仓库 【两者】
        maven { url 'https://maven.aliyun.com/repository/public/' }
        // 新增
        maven {url 'https://maven.aliyun.com/repository/grails-core'}
        maven { url 'https://maven.aliyun.com/repository/google/' }
        maven { url 'https://maven.aliyun.com/repository/jcenter/' }
        maven { url "https://mvn.getui.com/nexus/content/repositories/releases/" }
        maven {
            url 'http://mirrors.huaweicloud.com/repository/maven/'
            allowInsecureProtocol = true
        }
        maven { url 'https://repo.spring.io/milestone' }
        maven { url 'https://repo.spring.io/snapshot' }
        mavenCentral() //maven中央仓库
        gradlePluginPortal()
    }
}


rootProject.name = 'deity'
include 'mall-Ares'
include 'mall-angel'


此时我们在看 settings.gradle 文件,就会发现,已经自动生成了子模块引入目录

1.4、子项目build.gradle

mall-Ares 和 mall-angel两个子项目

这里注意,子项目只需要这么多配置参数,如果需要其他jar继续在dependencies {}中引入即可。(所有子项目配置均一致)


//子项目需要的jar包
dependencies {
    //SpringBoot启动项引入
    implementation 'org.springframework.boot:spring-boot-starter-web'

}

// 动态移除对kotlin构建插件的权限,避免子模块构建报错
tasks.register("prepareKotlinBuildScriptModel") {}

1.5、子项目中的 application.yml 配置

1.5.1、mall-Ares application.yml

server:
  port: 8082

1.5.2、mall-angelapplication.yml

server:
  port: 8083

1.6、测试Controller

1.6.1、mall-Ares测试代码

package com.dage.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("test/")
public class TestController {

    @RequestMapping("one")
    public String one(){
        return "欢迎来到java17";
    }
}

1.6.2、mall-angel测试代码

package com.dage.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;


@RestController
@RequestMapping("test/")
public class TestController {
    @RequestMapping("one")
    public String one(){
        return "欢迎来到gradle7.6.1";
    }
}

1.7、测试是否启动

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第3张图片
使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第4张图片

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第5张图片

二、创建gitee仓库,推送到远端

2.1、登录gitee新建仓库(deity

仓库名称要项目名称一致,这里仓库名称为:deity

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第6张图片

2.1.1、得到如下命令(新建仓库,使用创建git仓库 即可)

简易的命令行入门教程:
Git 全局设置:

git config --global user.name "xxx"
git config --global user.email "[email protected]"
创建 git 仓库:

mkdir gods
cd gods
git init 
touch README.md
git add.
git commit -m "first commit"
git remote add origin https://gitee.com/xxxxxxxx/gods.git
git push -u origin "master"
已有仓库?

cd existing_git_repo
git remote add origin https://gitee.com/xxxxxxx/gods.git
git push -u origin "master"

这里是需要 使用 git的,需要自己去安装,这里不做阐述
这里使用 git add. 把所有文件添加到暂存区

2.2、git执行命令

在项目根目录下执行命令
这里记得吧 xxxxx更换为自己的地址

  1. 打开git,进入项目文件中
  2. git init 初始化git
  3. touch README.md 创建版本文件
  4. git status 查看当前工作区文件状态
  5. git add . 上传所有文件到 暂存区
  6. git commit -m " 提交注释" 提交文件到本地仓库
  7. git remote add origin https://gitee.com/xxxxxxxx/gods.git 添加远程仓库origin ,建立关联
  8. git push -u origin "master" 把当前分支master 推送到远程仓库 origin

2.2.1、IDEA中可以验证代码是否上传仓库成功

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第7张图片

2.2.2、在gitee仓库中查看代码是否上传成功

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第8张图片

2.3、git 常用知识浅谈

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第9张图片
PS:图片来源

workspace:工作区,平时存放代码的位置 staging
area:暂存区/缓存区,用于临时存放你的改动,事实上它只是一个文件,保存即将提交到文件列表信息 local
repository:本地仓库,就是安全存放数据的位置,这里面有你提交到所有版本的数据。其中HEAD指向最新放入仓库的版本 remote
repository:远程仓库,托管代码的服务器

代码从修改到提交到远程仓库,一般需要经历如下5个状态:未修改,已修改,已暂存,已提交,已推送。如下所示:

未修改
       原始内容
已修改    ↓   
       工 作 区
已暂存    ↓    git add
       暂 存 区
已提交    ↓    git commit
       本地仓库
已推送    ↓    git push
       远程仓库

注意事项

git init会在项目根目录下初始化一个.git目录,git仓库必须
remote只需执行一次,yourRepository.git是你在github已有的一个仓库
.gitignore,这个文件写入所有不需要加入版本管理的文件,尤其像node_modules

三、Nacos 服务注册 SpringCloud Alibaba

3.1、启动win下的单机nacos

我这里是安装的: NACOS 2.2.2

  1. 第一步:下载nacos到本地之后,打开文件至bin目录,输入cmd进入命令窗口

  2. 第二步:输入启动命令: startup.cmd -m standalone 可以看到启动成功

Linux/Unix/Mac:命令

startup.sh -m standalone

​ Windows:命令

startup.cmd -m standalone

  1. 第三步:启动成功后,浏览器打开网址:http://localhost:8848/nacos/
  2. 默认nacos/nacos,成功查看(单机不需要登录)

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第10张图片

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第11张图片

3.2、给项目创建一个命名空间

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第12张图片

PS: 这里 命名空间ID 要着重记忆

3.3、引入新的需要的依赖

这里要在两个子项目中的dependencies{}中添加如下依赖
这是一种 基于 maven方式的 gradle插件在管理依赖,如果需要,请跳转目录:1.2

    //    SpringCloud Alibaba nacos服务发现
    implementation('com.alibaba.cloud:spring-cloud-starter-alibaba-nacos-discovery') {
        exclude group: 'org.springframework.cloud', module: 'spring-cloud-starter-netflix-ribbon'
    }
    //用于简化配置管理和外部化配置
    //可以从远程配置服务器(如 Git 存储库)中获取应用程序的配置信息,然后将这些配置信息注入到应用程序中
    implementation 'org.springframework.cloud:spring-cloud-starter-bootstrap'

3.3.1 子项目依赖更新图

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第13张图片

3.4、 启动类添加 @EnableDiscoveryClient 注解

@EnableDiscoveryClient 是 Spring Cloud 的一个注解,用于启用服务发现功能

package com.dage;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient
public class AresSpringBootApplication {

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

3.5 、创建bootstrap.yml进行配置

这里因为我有两个子项目,便于理解,我贴出了两个配置
这里的命名空间ID 就是 目录 3.2中需要注意的内容
这里要注意的一点是:application.yml中的server.port 配置我拿到了 bootstrap.yml中
所以现在 application.yml是空的。

server:
  port: 8082
spring:
  application:
    name: mall-Ares
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        enabled: true
        namespace: deity88481314 #命名空间ID

server:
  port: 8083
spring:
  application:
    name: mall-angel
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        enabled: true
        namespace: deity88481314 #命名空间ID

3.6、在nacos管理平台中查看注册进入的服务

使用Gradle7.6.1 + SpringBoot3.0.2 + java17创建微服务项目(学习)_第14张图片

测试完成

你可能感兴趣的:(微服务,微服务,学习,java)