## 简介

Gradle作为项目构建工具，有很多与Maven相同功能，其中依赖管理是比较重要的项。

本次就来学习使用Gradle引入相关依赖。



## 回顾

上一篇文章【[Gradle学习-创建Springboot项目](https://oldmoon.top/post/67)】中，学习了使用不同的方式搭建Gradle-springboot项目，本片文章将在上篇的基础上，讲解Gradle的重要功能：**依赖管理**，

## dependencies

> 简述：在 Gradle 中，`dependencies` 配置项用于指定项目所依赖的外部库或模块。
> 
> 官方文档：[DependencyHandler](https://docs.gradle.org/current/dsl/org.gradle.api.artifacts.dsl.DependencyHandler.html)

### 基本语法

dependencies 配置项中可以包含多个依赖声明，每个依赖声明都可以指定依赖的库或模块的名称、版本、以及依赖的类型和范围。依赖声明的格式如下：

```groovy
implementation 'group:name:version'
```

其中，implementation：表示依赖库需要在编译和运行时都可用；group 表示依赖库所属的组，name 表示依赖库的名称，version 表示依赖库的版本号。Gradle 支持使用通配符来指定版本号，例如：

```groovy
implementation 'group:name:1.+'
```

这表示依赖库的版本号是以 1 开头的任意版本。

### 其他用法

除了上述基本语法格式，还可以使用以下格式来指定特殊的依赖项：

```groovy
implementation files('libs/foo.jar')  // 从本地文件系统中引入 jar 包
implementation project(':mylibrary')  // 引入另一个 Gradle 项目（多模块项目时常用）
```

### 关键字

上面的用法都是使用的`implementation`关键字，使用该关键字引入的依赖表示需要在编译和运行时都可用，除此之外还有其他关键字，按依赖类型和依赖范围划分如下：

#### 依赖类型

- implementation：表示依赖库需要在编译和运行时都可用；
- api：表示依赖库需要在编译时可用，但不一定需要在运行时可用；
- runtimeOnly：表示依赖库只需要在运行时可用，不需要在编译时可用；
- testImplementation：表示依赖库只需要在测试代码编译和运行时可用；
- testRuntimeOnly：表示依赖库只需要在测试代码运行时可用。

#### 依赖范围

- compileOnly：表示依赖库不会被打包到最终的构建结果中，但可以在编译时使用；
- annotationProcessor：表示依赖库只用于编译期的注解处理；
- runtimeOnly：表示依赖库只需要在运行时可用，不需要在编译时可用；
- testCompileOnly：表示依赖库只会被用于测试代码的编译，不会被打包到最终的构建结果中；
- testRuntimeOnly：表示依赖库只需要在测试代码运行时可用。

### 依赖传递

引入的依赖可以配置其传递性，Maven中也存在响应配置，Gradle中的写法如下：

```groovy
implementation ('group:name:version') {
    transitive = true  // 允许传递依赖（默认值），false:禁止传递依赖
}
```

## 示例

上一篇文章创建好了springboot项目，如果你启动测试会发现，启动虽然成功，但立即自动结束了，这是因为没有web服务的相关依赖，导致其没有作为web服务器从而一直保持运行。

本示例为：使用`implementation`引入`spring-boot-starter-web`，并编写一个 http 接口用于测试。

### 引入依赖

修改`build.gradle`文件中的`dependencis`如下：

```groovy
dependencies {
	implementation 'org.springframework.boot:spring-boot-starter',
			'org.springframework.boot:spring-boot-starter-web'

	testImplementation 'org.springframework.boot:spring-boot-starter-test'
}
```

> 其中多个依赖可以用`,`间隔，使用一个`implementation`即可，等价于下面的配置：
> 
> ```groovy
> dependencies {
> 	implementation 'org.springframework.boot:spring-boot-starter'
> 	implementation 'org.springframework.boot:spring-boot-starter-web'
> 
> 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
> }
> ```

修改后刷新依赖（上一篇文章在项目初始化时有讲到），如果使用`IDEA`，在`build.gradle`文件修改后，右上角会自动出现刷新提示按钮，点击即可刷新。

#### 拓展

细心的朋友可以发现，`implementation 'org.springframework.boot:spring-boot-starter'`与上面讲到的基本语法有所区别，`org.springframework.boot`是group，`spring-boot-starter`是name，那么version 去哪了？

答案是：**省略了**

但需要注意的是，**并不是所有依赖项都可以省略版本号**，这里可以省略version版本号的编写，是因为在`plugins`中引入了相关插件：`org.springframework.boot`和`io.spring.dependency-management`，这些插件中有一个重要的作用，就是维护了`springframeword`众多依赖的版本。

顾名思义`dependency-management`就是依赖管理的意思，如果你的某个依赖没有被这些插件所维护管理，那么引入那个依赖就必须填写版本号，否则会报错！

### 编写代码

1. 编写TestController

创建controller包，并创建`TestController`类，编写代码如下：

```java
package com.example.controller;

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

/**
 * 测试 http 接口
 *
 * @author dingdangdog
 * @date 2023/3/27 16:38
 */
@RestController
@RequestMapping("/test")
public class TestController {
    @GetMapping
    public String hello(String name) {
        return "Hello " + name;
    }
}

```

3. 编写基本配置application.yml

在`src/main/resources`文件夹下创建`application.yml`文件，该文件是Springboot默认的配置文件，也可以是`application.properties`，写法不同而已。

application.yml内容如下

```yaml
server:
  port: 8080

spring:
  application:
    name: gradle-boot-my
```

### 启动服务

以上工作完成后，运行SpringBoot的启动类即可，启动日志如下：

```log
"C:\Program Files\Java\jdk1.8.0_131\bin\java.exe" ...
Connected to the target VM, address: '127.0.0.1:13446', transport: 'socket'

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::                (v2.7.9)

2023-03-27 16:44:37.878  INFO 19252 --- [           main] com.example.BootApplication              : Starting BootApplication using Java 1.8.0_131 on DESKTOP-M8KVEAO with PID 19252 (E:\code\DingDangDog_sapce\gradle-boot-my\build\classes\java\main started by xxhu5 in E:\code\DingDangDog_sapce\gradle-boot-my)
2023-03-27 16:44:37.882  INFO 19252 --- [           main] com.example.BootApplication              : No active profile set, falling back to 1 default profile: "default"
2023-03-27 16:44:38.651  INFO 19252 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8080 (http)
2023-03-27 16:44:38.659  INFO 19252 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2023-03-27 16:44:38.659  INFO 19252 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.71]
2023-03-27 16:44:38.754  INFO 19252 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2023-03-27 16:44:38.754  INFO 19252 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 824 ms
2023-03-27 16:44:39.051  INFO 19252 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
2023-03-27 16:44:39.060  INFO 19252 --- [           main] com.example.BootApplication              : Started BootApplication in 1.6 seconds (JVM running for 2.592)
2023-03-27 16:45:07.066  INFO 19252 --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring DispatcherServlet 'dispatcherServlet'
2023-03-27 16:45:07.066  INFO 19252 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : Initializing Servlet 'dispatcherServlet'
2023-03-27 16:45:07.067  INFO 19252 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : Completed initialization in 1 ms

```

观察日志可以看到服务以`8080`端口启动成功。

### 测试接口

浏览器访问`http://localhost:8080/test?name=dingdangdog`，现象如下：

![test-api](https://images.oldmoon.top/images/dingdangdog/dingdangdog-1679910471224.jpg)


## 总结

最终服务启动成功并且接口测试成功，说明依赖正确注入并使用。通过使用Gradle进行依赖注入，可以发现以下两点：

1. Gradle对依赖管理的编写，相比Maven更加简洁。
2. Maven支持的依赖管理、依赖传递等行为，Gradle同样支持。

## 台阶

通过本文学习，对Gradle的依赖管理（引入）有了初步的认识，勉强算是迈上了一个台阶。

但还有很多不足之处，比如文中提到的依赖版本管理`version`，既然引入插件可以省略部分依赖的版本号配置，那么可不可以自己实现依赖版本管理，从而省略全部版本的配置？

答案当时是**可以**。Maven中就可以自定义依赖管理，Gradle怎么可能不行呢！这比分知识留给有兴趣的同学自行学习吧~（挖坑😁）

Gradle学习-依赖引入

## 简介

某度百科：

> Go（又称 Golang）是 Google 的 Robert Griesemer，Rob Pike 及 Ken Thompson 开发的一种静态强类型、编译型语言。Go 语言语法与 C 相近，但功能上有：内存安全，GC（垃圾回收），结构形态及 CSP-style 并发计算。

在某个开源项目中，使用了Go作为后端服务开发语言，在此背景下第一次接触Golang，历经艰难险阻终于跑起来了后端服务。。。




## 项目

- 项目名：**van-nav**
- 项目简介：一个轻量导航站，汇总你的所有服务。全平台支持，单文件部署，有配套浏览器插件。
- Github仓库：https://github.com/Mereithhh/van-nav

这是一个简洁的个人网站收藏夹，体积小，操作简单。

但是这个项目的代码显然没有经过认真整理，很多go文件零散的放在根目录，对于我这种没学过go的小白，直接无从下脚，但不管怎样，依照原有的开发经验（`ps:最重要的还是咨询了作者`），最终还是跑起来了。

## Go下载安装

Go官网：[The Go Programming Language](https://go.dev/)

Go下载：[All release](https://go.dev/dl/)

> 选在自己系统对应的版本，下载安装即可。

## go.mod

`go.mod`文件用于管理go项目所需要的三方依赖，类似于Java项目常用的Maven的`pom.xml`。

- ChatGPT的回答：

> go.mod 文件是 Go 1.11 之后引入的模块管理工具，它用于管理 Go 项目的依赖。它主要的作用有以下几个方面：
> 
> 1. 定义模块和模块版本：go.mod 文件记录了当前模块的名称、模块的版本号以及依赖的其他模块及其版本。
> 2. 自动管理依赖：通过 go mod 命令可以方便地自动安装或更新依赖模块，同时也可以方便地移除不再需要的依赖模块。
> 3. 保证构建的可重复性：在 go.mod 中指定了依赖版本号，可以保证在不同的环境中构建同一个项目时使用的依赖版本是一致的，保证了构建的可重复性。
> 4. 支持私有仓库：可以在 go.mod 中指定私有仓库地址，实现对私有依赖的支持。

### 下载依赖

当一个已存在的项目，且项目中已经有`go.mod`文件，说明该项目已经启用了 Go Modules，这时候你就可以通过 `go build`、`go run`、`go test` 等命令来构建、运行或测试你的代码。当然你应该先下载依赖：

```
go mod download
```

`go mod download` 是 Go 模块下载依赖的命令，它会下载 go.mod 文件中列出的依赖包及其依赖包的依赖包到本地缓存。通常在项目中第一次构建或添加新依赖包时，需要运行该命令。运行该命令可以保证依赖包的版本一致性，同时也能加快后续构建过程的速度。

- 下载失败

如果 `go mod download` 命令执行失败，可能是因为网络问题或者是无法连接到默认的 Go 模块代理。此时，您可以尝试切换到其他可用的代理地址，例如 Goproxy.io、Aliyun、Golang 中国等。

可以通过设置环境变量 GOPROXY 来切换 Go 模块代理地址：

```
# Mac | Linux
export GOPROXY=https://goproxy.io,direct

# Windwos
set GOPROXY=https://goproxy.io,direct
```

设置完成后，使用 `go env GOPROXY` 可以查看当前设置的代理地址。设置成功狗再试执行 `go mod download` 尝试下载依赖

## go-embed

`go:embed` 是 Go 1.16 版本新增的一个指令，用于将文件或目录嵌入到 Go 程序的二进制文件中。可以方便地将静态文件（如 HTML、CSS、JS、图片等）打包到二进制文件中，无需额外的文件读取、解析等操作。

在本项目的`main.go`中有一行代码是：
```go
//go:embed public
```

运行`go run main.go`时会报错，但看到这一行代码还很奇怪注释为什么会报错，其实并不是注释，语法就这样。。。

> 在 Go 1.16 版本中，添加了一个新的特性 `//go:embed`，它允许将文件或目录嵌入到 Go 二进制文件中。而为了确保该特性能够正确解析，需要在 `//go:embed` 前加上两个正斜杠 `//`。这样，Go 编译器就能够识别该注释，并执行对应的嵌入操作。

**根据上面的说明，`//go:embed public` 这行代码是将`public`文件夹嵌入到`Go程序`中，但是download下来的代码并没有`public`文件夹，所以报错，在根目录创建`public`文件夹，并随便创建一个文件即可。**

## undefined: XXX

解决上述`public`的报错后，再次运行`go run main.go`，会报错：

```
# command-line-arguments
.\main.go:52:25: undefined: updateCatelogDto
.\main.go:67:44: undefined: Img
.\main.go:128:22: undefined: updateToolDto  
.\main.go:146:25: undefined: Setting        
.\main.go:161:27: undefined: Token
.\main.go:176:22: undefined: updateUserDto  
.\main.go:191:22: undefined: addCatelogDto  
.\main.go:215:19: undefined: addToolDto     
.\main.go:231:31: undefined: Tool
.\main.go:248:34: undefined: Catelog
.\main.go:248:34: too many errors
```

报错的这些都是实体类型，在根目录下的 `types.go` 文件中有定义，但是为什么会报错呢？刚开始以为是没有引用，所以尝试了各种引用方式，不行。

**是在没办法，最后咨询了项目的作者，得到的答复是：运行 `go run .`**

```go
# go run .
数据库初始化成功。。。
应用启动成功，网址:   http://localhost:6412
```

## 结语

虽然最终把项目跑起来了，也自己实现了几个功能，但也只是`COPY`而已，里学会Golang还差的远那。

初次认识Golang

## 问题

Node版本太新，启动老项目时，可能会报错`Error: error:0308010C:digital envelope routines::unsupported`





## 解决

在要执行的脚本前增加以下环境参数设置：

> set NODE_OPTIONS=--openssl-legacy-provider

如：

```
set NODE_OPTIONS=--openssl-legacy-provider && react-scripts start
```

使用`&&`连接两条指令。

Node项目报错 error:0308010C

## 简介

本文用于记录VScode开发工具的一些必要插件，按照编程语言分类。




## 通用插件

- `Prettier - Code formatter`：代码格式化插件，可以自动将代码格式化成规范的风格，减少手动调整代码风格的时间。

## Git

- `GitLens`：提供了 Git 相关的功能，方便管理和查看代码提交历史等信息。

## Docker

- `Docker`：docker官方提供的插件，可以查看docker容器、镜像，并且提供操作式的快速构建docker镜像相关功能。

## JavaScript

- `ESLint`：JavaScript 代码检查工具，可以帮助发现代码潜在的错误和漏洞。因为前段很多框架都是基于JS开发的，所以在很多场景都可以安装使用。

## TypeScript

## Vue

- `Vue Language Features (Volar)`：支持 Vue.js 模板语法高亮、错误检查、智能补全和重构；支持使用模板、脚本和样式标记之间的快速导航等等，算是Vue开发的必备插件。

- `TypeScript Vue Plugin (Volar)`：提供了在 Vue.js 应用中使用 TypeScript 的一些工具和特性，包括类型推断、智能提示、语法高亮、快速修复等等。

## React

- `ES7+ React/Redux/React-Native snippets`：提供了一组 `React/Redux/React-Native` 开发所需的代码片段，可用于加快开发速度，减少重复性劳动。该插件包含了多个模板和代码片段，涵盖了 React 组件、Redux 模块、React-Native 模块等等，开发者只需要在代码中输入相应的快捷命令，就可以快速生成常见的代码结构。比如输入`imr`，就可以快速导入 React 模块；输入`rnfc`，就可以快速生成 React-Native 的 class 组件。

## Golang

- `Go`：官方提供的插件，可以提供丰富的 Golang 开发功能，包括代码自动补全、调试、测试等功能。

## uni-app

- `uni-helper`：Uni-app开发工具包，内含多个uni-app插件。
- `uniapp小程序扩展`：可能是最好用的uniapp小程序扩展，自动提示标签可用属性，鼠标悬浮查询属性文档等。

VScode插件记录

## 简介

> 作为程序员，Xshell和Xftp应该都用过吧。
> 
> Xshell和Xftp官方提供个人版，可以免费下载使用。





## 文件目录

NETSTRING官方有一个文件夹目录地址，记录一下，省的以后每次下载还要申请。

文件目录（`该目录每月更新，可能你读到这篇文章时，目录已经失效`）：[Xshell](https://download.xshell.com/ddc89225/)，其中有众多Xftp和Xshell的安装包，需要找最新版本下载，文件名用`p`结尾的是个人版，如`Xftp-7.0.0063p.exe`，`Xshell-7.0.0065p.exe`。

- 其中不仅有Xftp和Xshell安装包，注意辨别。
- 不保证链接可用，如果链接失效，还是乖乖重新申请，申请地址在下面：

## 免费版申请

免费版申请地址：[家庭/校园免费](https://www.xshell.com/zh/free-for-home-school/)

申请时填写你的邮箱，官方会把下载链接发送到你的邮箱。

Xshell&Xftp官方下载地址