🤔 如何运行别人的 Java 项目

[TOC]

刚到公司，导师给了一个 Java 项目，搞了一下午没搞定。（卒）

⤵️ 1. 克隆项目仓库

首先使用 GitLab 将代码拉取下来。

1
2

NilEra@MS-202109171212 MINGW64 /d/LocalGit
$ git clone https://<username>:<access token>@git.xxx.com/...projectName.git

2. 配置项目信息

用 idea 打开项目后，进入 idea 进行配置。

主要注意：JDK 版本一般是 JDK1.8，maven 需要选择自己的 maven，这里我的版本为 3.6.1，如果使用 Idea 自带的 maven（虽然版本也是 3.6.1），但是可能会导致一些问题，这里我遇到的包括但不限于：

• 明明有错误但是 Reimport 后检测不出错误
• 有一些包没法正常的安装
• 有一些包虽然正常安装了，但是却没法正常检测
• 总之就是非常多的坑

选择 POM 文件，右键 Add as Maven Project

Node版本不适应，node 12-14

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

npm ERR! code 1
npm ERR! path D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-sass
npm ERR! command failed
npm ERR! command C:\windows\system32\cmd.exe /d /s /c node scripts/build.js
npm ERR! Building: D:\nvm\nodejs\node.exe D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\bin\node-gyp.js rebuild --verbose --libsass_ext= --libsass_cflags= --libsass_ldflags= --libsass_library=
npm ERR! gyp info it worked if it ends with ok
npm ERR! gyp verb cli [
npm ERR! gyp verb cli   'D:\\nvm\\nodejs\\node.exe',
npm ERR! gyp verb cli   'D:\\Inspur\\LocalGit\\base-vap\\src\\frontend\\web\\node_modules\\node-gyp\\bin\\node-gyp.js',
npm ERR! gyp verb cli   'rebuild',
npm ERR! gyp verb cli   '--verbose',
npm ERR! gyp verb cli   '--libsass_ext=',
npm ERR! gyp verb cli   '--libsass_cflags=',
npm ERR! gyp verb cli   '--libsass_ldflags=',
npm ERR! gyp verb cli   '--libsass_library='
npm ERR! gyp verb cli ]
npm ERR! gyp info using node-gyp@3.8.0
npm ERR! gyp info using node@16.20.2 | win32 | x64
npm ERR! gyp verb command rebuild []
npm ERR! gyp verb command clean []
npm ERR! gyp verb clean removing "build" directory
npm ERR! gyp verb command configure []
npm ERR! gyp verb check python checking for Python executable "python2" in the PATH
npm ERR! gyp verb `which` failed Error: not found: python2
npm ERR! gyp verb `which` failed     at getNotFoundError (D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:13:12)  
npm ERR! gyp verb `which` failed     at F (D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:68:19)
npm ERR! gyp verb `which` failed     at E (D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:80:29)
npm ERR! gyp verb `which` failed     at D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:89:16
npm ERR! gyp verb `which` failed     at D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\isexe\index.js:42:5
npm ERR! gyp verb `which` failed     at D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\isexe\windows.js:36:5
npm ERR! gyp verb `which` failed     at FSReqCallback.oncomplete (node:fs:202:21)
npm ERR! gyp verb `which` failed  python2 Error: not found: python2
npm ERR! gyp verb `which` failed     at getNotFoundError (D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:13:12)  
npm ERR! gyp verb `which` failed     at F (D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:68:19)
npm ERR! gyp verb `which` failed     at E (D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:80:29)
npm ERR! gyp verb `which` failed     at D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-gyp\node_modules\which\which.js:89:16
npm ERR! gyp verb `which` failed     at D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\isexe\index.js:42:5
npm ERR! gyp verb `which` failed     at D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\isexe\windows.js:36:5
npm ERR! gyp verb `which` failed     at FSReqCallback.oncomplete (node:fs:202:21) {
npm ERR! gyp verb `which` failed   code: 'ENOENT'
npm ERR! gyp verb `which` failed }
npm ERR! gyp verb check python checking for Python executable "python" in the PATH
npm ERR! gyp verb `which` succeeded python D:\Python311\python.EXE
npm ERR! gyp ERR! configure error
npm ERR! gyp ERR! stack Error: Command failed: D:\Python311\python.EXE -c import sys; print "%s.%s.%s" % sys.version_info[:3];
npm ERR! gyp ERR! stack   File "<string>", line 1
npm ERR! gyp ERR! stack     import sys; print "%s.%s.%s" % sys.version_info[:3];
npm ERR! gyp ERR! stack                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
npm ERR! gyp ERR! stack SyntaxError: Missing parentheses in call to 'print'. Did you mean print(...)?
npm ERR! gyp ERR! stack
npm ERR! gyp ERR! stack     at ChildProcess.exithandler (node:child_process:402:12)
npm ERR! gyp ERR! stack     at ChildProcess.emit (node:events:513:28)
npm ERR! gyp ERR! stack     at maybeClose (node:internal/child_process:1100:16)
npm ERR! gyp ERR! stack     at Process.ChildProcess._handle.onexit (node:internal/child_process:304:5)
npm ERR! gyp ERR! System Windows_NT 10.0.19043
npm ERR! gyp ERR! command "D:\\nvm\\nodejs\\node.exe" "D:\\Inspur\\LocalGit\\base-vap\\src\\frontend\\web\\node_modules\\node-gyp\\bin\\node-gyp.js" "rebuild" "--verbose" "--libsass_ext=" "--libsass_cflags=" "--libsass_ldflags=" "--libsass_library="
npm ERR! gyp ERR! cwd D:\Inspur\LocalGit\base-vap\src\frontend\web\node_modules\node-sass
npm ERR! gyp ERR! node -v v16.20.2
npm ERR! gyp ERR! node-gyp -v v3.8.0
npm ERR! gyp ERR! not ok
npm ERR! Build failed with error code: 1

npm ERR! A complete log of this run can be found in:
npm ERR!     D:\nodejs\node_cache\_logs\2024-10-17T07_55_40_886Z-debug-0.log

🐦MyBatis-Plus

[TOC]

🚪 1. 快速入门

1.1 入门案例

入门案例：基于课前资料提供的项目，实现下列功能:

• 新增用户功能
• 根据 id 查询用户
• 根据 id 批量查询用户
• 根据 id 更新用户
• 根据 id 删除用户

1.1.1 引入 MyBatis-Plus 的依赖

1
2
3
4
5
6

<!-- MyBatisPlus -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3.1</version>
</dependency>

1.1.2 定义 Mapper

自定义的 Mapper 继承 MybatisPlus提供的 BaseMapper 接口。

BaseMapper<T> 给我们提供了很多基础方法，如常用的增、删、改、查等操作。

1

public interface UserMapper extends BaseMapper<User> { }

1.1.3 直接使用

做完上面两步操作，此时我们不需要再编写复杂的 SQL 语句即可对数据库进行增、删、改、查操作。

当然对于原有 MyBatis 操作，我们也可以直接使用，因为 MyBatis-Plus 对 MyBatis 是非侵入的，体现了其润物无声的特点。

1.2 常见注解

在初次使用 MyBatis-Plus 时，我们并没有指定要执行操作的表信息和字段信息，那么 Mybatis-Plus 是如何知道我们要查询的是哪张表？表中有哪些字段呢？

MyBatisPlus 通过扫描实体类，并基于反射获取实体类信息作为数据库表信息。

在入门案例中 1.1.2 定义 Mapper 时，我们需要特别指定泛型类即 <User>。泛型中的 User 就是与数据库对应的 PO。

MyBatis-Plus 就是根据 PO 实体的信息来推断出表的信息，从而生成 SQL 的。默认情况下：

• MyBatis-Plus 会把 PO 实体的类名驼峰转下划线作为表名，如类名为 UserInfo，反射的表名为 user_info；
• MyBatis-Plus 会把 PO 实体的所有变量名驼峰转下划线作为表的字段名，并根据变量类型推断字段类型；
• MyBatis-Plus 会把名为 id 的字段作为主键。

但很多情况下，默认的实现与实际场景不符，因此 MyBatis-Plus 提供了一些注解便于我们声明表信息。

1.2.1 @TableName 注解

• 描述：表名注解，标识实体类对应的表
• 使用位置：实体类

1
2
3
4
5
6

/* 标注实体类对应的表名 */
@TableName("t_user")
public class User {
    private Long id;
    private String name;
}

@TableName 注解除了指定表名以外，还可以指定很多其它属性：

1.2.2 @TableId 注解

• 描述：主键注解，标识实体类中的主键字段
• 使用位置：实体类的主键字段

1
2
3
4
5
6

@TableName("t_user")
public class User {
    @TableId(value="id", type=IdType.AUTO)
    private Long id;
    private String name;
}

TableId 注解支持两个属性：

IdType支持的类型有：

这里比较常见的有三种：

• AUTO：利用数据库的 id 自增长
• INPUT：手动生成 id
• ASSIGN_ID：雪花算法生成 Long 类型的全局唯一 id，这是默认的ID策略

1.2.3 @TableField 注解

• 描述：普通字段注解

• 示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

@TableName("user")
public class User {
    @TableId(value="u_id", type=IdType.AUTO)
    private Long id;
    
    @TableField("username")		// 成员变量名与数据库字段名不一致
    private String name;
    
    private Integer age;
    
    @TableField("isMarried")	// 成员变量是以 `isXXX` 命名
    private Boolean isMarried;
    
    @TableField("`concat`")		// 成员变量名与数据库一致, 但是与数据库的关键字冲突
    private String concat;

    @TableField(exist = false)	// 成员变量不是数据库字段
    private String address;
}

一般情况下我们并不需要给字段添加 @TableField 注解，一些特殊情况除外：

• 成员变量名与数据库字段名不一致；
• 成员变量是以 isXXX 命名，按照JavaBean的规范，MyBatis-Plus识别字段时会把 is 去除，这就导致与数据库不符；
• 成员变量名与数据库一致，但是与数据库的关键字冲突。使用 @TableField 注解给字段名添加转义字符：``；
• 成员变量不是数据库字段，添加 exist = false

支持的其它属性如下：

1.3 常见配置

MyBatis-Plus 也支持基于 yaml 文件的自定义配置，详见官方文档：

MyBatis-Plus 官方文档

大多数的配置都有默认值，因此我们都无需配置。但还有一些是没有默认值的，例如:

• 实体类的别名扫描包
• 全局id类型

1
2
3
4
5
6
7
8
9
10

mybatis-plus:
	type-aliases-package: com.itheima.mp.domain.po		# 别名扫描包
	mapper-locations: "classpath*:/mapper/**/*.xml" 	# Mapper.xml文件地址，当前这个是默认值。
	configuration:
  		mapper-underscore-to-camel-case: true			# 是否开启下划线驼峰映射
		cache-enabled: false							# 是否开启二级缓存
	global-config:
		db-config:
		id-type: auto 									# 全局 id 类型为自增长, 可以更换为其他方法, 如 assign_id
		update-strategy: not_null						# 更新策略: 只更新非空字段

需要注意的是，MyBatis-Plus也支持手写 SQL 的，而 mapper 文件的读取地址可以通过 mapper-locations 配置：默认值是classpath*:/mapper/**/*.xml，也就是说我们只要把 mapper.xml 文件放置这个目录下就一定会被加载。

🥑 2. 核心功能

入门案例中都是以 id 为条件的简单CRUD，一些复杂条件的 SQL 语句就要用到一些更高级的功能了。

2.1 条件构造器

除了新增以外，修改、删除、查询的 SQL 语句都需要指定 WHERE 条件。因此 BaseMapper 中提供的相关方法除了以 id 作为 WHERE 条件以外，还支持更加复杂的 WHERE条件。

参数中的 Wrapper 就是条件构造的抽象类，其下有很多默认实现，继承关系如图：

Wrapper 的子类 AbstractWrapper 提供了 WHERE 中包含的所有条件构造方法：

而 QueryWrapper 在 AbstractWrapper 的基础上拓展了一个 SELETE 方法，允许指定查询字段：

而 UpdateWrapper 在 AbstractWrapper 的基础上拓展了一个 SET 方法，允许指定 SQL 中的 SET 部分：

接下来，我们就来看看如何利用 Wrapper 实现复杂查询。

2.1.1 QueryWrapper

无论是修改、删除、查询，都可以使用QueryWrapper来构建查询条件。

当前表的结构如下：

接下来看一些例子：

查询：查询出名字中带o的，存款大于等于1000元的人。代码如下：

1
2
3

SELECT id,username,info,balance
FROM user
WHERE username LIKE "%o%" AND Balance >= 100

1
2
3
4
5
6
7
8
9
10
11

@Test
void testQueryWrapper() {
    // 1. 构建查询条件 WHERE name LIKE "%o%" AND balance >= 1000
    QueryWrapper<User> wrapper = new QueryWrapper<User>()
            .select("id", "username", "info", "balance")
            .like("username", "o")
            .ge("balance", 1000);
    // 2. 查询数据
    List<User> users = userMapper.selectList(wrapper);
    users.forEach(System.out::println);
}

更新：更新用户名为 Jack 的用户的余额为 2000，代码如下：

1
2
3

UPDATE user
	SET balance=2000
	WHERE (username="Jack")

1
2
3
4
5
6
7
8
9
10

@Test
void testUpdateByQueryWrapper() {
    // 1.构建查询条件 WHERE name="Jack"
    QueryWrapper<User> wrapper = new QueryWrapper<User>().eq("username", "Jack");
    
    // 2.更新数据, user 中非 NULL 字段都会作为 SET 语句
    User user = new User();
    user.setBalance(2000);
    userMapper.update(user, wrapper);
}

2.1.2 UpdateWrapper

基于 BaseMapper 中的 UPDATE 方法更新时只能直接赋值，对于一些复杂的需求就难以实现。

例如：更新 id 为 1、2、4 的用户的余额，扣 200，对应的SQL应该是：

1

UPDATE user SET balance = balance - 200 WHERE id in (1, 2, 4)

SET 的赋值结果是基于字段现有值的，这个时候就要利用 UpdateWrapper 中的 setSql 功能了：

1
2
3
4
5
6
7
8
9
10
11
12

@Test
void testUpdateWrapper() {
    List<Long> ids = List.of(1L, 2L, 4L);
    // 1.生成SQL
    UpdateWrapper<User> wrapper = new UpdateWrapper<User>()
            .setSql("balance = balance - 200") 	// SET balance = balance - 200
            .in("id", ids); 					// WHERE id in (1, 2, 4)
    
    // 2.更新, 注意第一个参数可以给null, 也就是不填更新字段和数据，
    // 而是基于 UpdateWrapper 中的 setSQL 来更新
    userMapper.update(null, wrapper);
}

2.1.3 LambdaQueryWrapper

无论是 QueryWrapper 还是 UpdateWrapper 在构造条件的时候都需要写死字段名称，会出现字符串魔法值。这在编程规范中显然是不推荐的。 那怎么样才能不写字段名，又能知道字段名呢？

其中一种办法是基于变量的 getter 方法结合反射技术。因此我们只要将条件对应的字段的 getter 方法传递给 MyBatis-Plus，它就能计算出对应的变量名了。而传递方法可以使用 JDK8 中的 方法引用 和 Lambda 表达式。 因此 MyBatis-Plus 又提供了一套基于Lambda 的 Wrapper，包含两个：

• LambdaQueryWrapper
• LambdaUpdateWrapper

分别对应 QueryWrapper 和 UpdateWrapper

其使用方式如下：

1
2
3
4
5
6
7
8
9
10
11
12

@Test
void testLambdaQueryWrapper() {
    // 1.构建条件 WHERE username LIKE "%o%" AND balance >= 1000
    QueryWrapper<User> wrapper = new QueryWrapper<>();
    wrapper.lambda()
            .select(User::getId, User::getUsername, User::getInfo, User::getBalance)
            .like(User::getUsername, "o")
            .ge(User::getBalance, 1000);
    // 2.查询
    List<User> users = userMapper.selectList(wrapper);
    users.forEach(System.out::println);
}

2.2 自定义 SQL

一般企业的开发规范中，是不允许开发人员将 SQL 脱离出 Mapper 层或者 mapper.xml 文件的，但是我们想要使用 MyBatis-Plus 又想要遵守企业的开发规范，应该如何做呢？

我们可以利用 MyBatis-Plus 的 Wrapper 来构建复杂的 WHERE 条件，然后自己定义 SQL 语句中剩下的部分。

① 基于 Wrapper 构造 WHERE 条件

1
2
3
4
5
6
7
8

List<Long> ids = List.of(1L, 2L, 4L);
int amount = 200;

// 1. 构造条件
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<User>().in(User::getId, ids);

// 2. 自定义SQL方法调用
userMapper.updateBalanceByIds(wrapper, amount);

② 在 mapper 方法参数中用 @Param 注解声明 Wrapper 变量名称，这个名称必须是 ew

1

void updateBalanceByIds(@Param("ew") LambdaQueryWrapper<User> wrapper, @Param("amount") int amount);

③ 自定义 SQL，并使用 Wrapper 条件，这里 ew.customSqlSegment 是 Wrapper 的一个方法，用于获取用户自定义SQL片段。如果使用出现问题，参考博客：MyBatis-Plus ${ew.customSqlSegment} 使用的史诗级大坑-CSDN博客

1
2
3

<update id="updateBalanceByIds">
    UPDATE t_user SET balance = balance - #{amount} ${ew.customSqlSegment};
</update>

2.3 Service 接口

MyBatis-Plus 不仅提供了 BaseMapper，还提供了通用的 Service 接口及默认实现，封装了一些常用的 service 模板方法。 通用接口为 IService，默认实现为 ServiceImpl，其中封装的方法可以分为以下几类：

• save：新增
• remove：删除
• update：更新
• get：查询单个结果
• list：查询集合结果
• count：计数
• page：分页查询

2.3.1 CRUD

首先了解基本的CRUD接口。

新增：

• save 是新增单个元素
• saveBatch 是批量新增
• saveOrUpdate 是根据id判断，如果数据存在就更新，不存在则新增
• saveOrUpdateBatch 是批量的新增或修改

删除：

• removeById：根据id删除
• removeByIds：根据id批量删除
• removeByMap：根据Map中的键值对为条件删除
• remove(Wrapper<T>)：根据Wrapper条件删除
• ~~removeBatchByIds~~：暂不支持

修改：

• updateById：根据id修改
• update(Wrapper<T>)：根据UpdateWrapper修改，Wrapper中包含set和where部分
• update(T，Wrapper<T>)：按照T内的数据修改与Wrapper匹配到的数据
• updateBatchById：根据id批量修改

Get：

• getById：根据 id 查询 1 条数据
• getOne(Wrapper<T>)：根据Wrapper 查询 1 条数据
• getBaseMapper：获取Service 内的 BaseMapper 实现，某些时候需要直接调用 Mapper 内的自定义 SQL 时可以用这个方法获取到 Mapper

List：

• listByIds：根据id批量查询
• list(Wrapper<T>)：根据Wrapper条件查询多条数据
• list()：查询所有

Count：

• count()：统计所有数量
• count(Wrapper<T>)：统计符合Wrapper条件的数据数量

getBaseMapper： 当我们在service中要调用Mapper中自定义SQL时，就必须获取service对应的Mapper，就可以通过这个方法：

2.3.2 基本用法

由于 Service 中经常需要定义与业务有关的自定义方法，因此我们不能直接使用 IService，而是自定义 Service 接口，然后继承 IService 以拓展方法。同时，让自定义的 Service实现类 继承 ServiceImpl，这样就不用自己实现 IService 中的接口了。

具体方法如下：

① 首先，定义 IUserService 类，继承 IService：

1
2
3
4
5
6
7
8

package com.itheima.mp.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.itheima.mp.domain.po.User;

public interface IUserService extends IService<User> {
    // 拓展自定义方法
}

② 然后，编写 UserServiceImpl 类，继承 ServiceImpl，实现 UserService：

1
2
3
4
5
6
7
8
9
10
11
12

package com.itheima.mp.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.itheima.mp.domain.po.User;
import com.itheima.mp.domain.po.service.IUserService;
import com.itheima.mp.mapper.UserMapper;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements IUserService {

}

项目结构如下：

接下来，我们基于 RESTful 风格快速实现下面几个接口（什么是RESTful风格）：

简单理解 REST 就是：URL 中只使用名词来定位资源，用 HTTP 协议里的动词（GET、POST、PUT、DELETE）来实现资源的增删改查操作。

什么是 RESTful：

• 使用客户/服务器（B/S、 C/S）模型：客户和服务器之间通过一个统一的接口来互相通讯。
• 层次化的系统：在一个 REST 系统中，客户端并不会固定地与一个服务器打交道。
• 无状态：在一个 REST 系统中，服务端并不会保存有关客户的任何状态。也就是说，客户端自身负责用户状态的维持，并在每次发送请求时都需要提供足够的信息。
• 可缓存：REST 系统需要能够恰当地缓存请求，以尽量减少服务端和客户端之间的信息传输，以提高性能。
• 统一的接口。一个 REST 系统需要使用一个统一的接口来完成子系统之间以及服务与用户之间的交互。这使得 REST 系统中的各个子系统可以独自完成演化。

如果一个系统满足了上面所列出的五条约束，那么该系统就被称为是 RESTful 的。

🕸 3. 拓展功能

🧩 4. 插件功能

Java 注解

[TOC]

🍭 1. 注解的分类

通常来说注解分为以下三类：

1.1 元注解

用于定义注解的注解，通常用于注解的定义上，标明该注解的使用范围、生效范围等。一般我们说“元**”，都代表最基本最原始的东西。因此，元注解就是最基本不可分解的注解，我们不能去改变它，只能使用它来定义自定义的注解。

元注解包含以下五种：@Retention、@Target、@Documented、@Inherited、@Repeatable，其中最常用的是 @Retention 和@Target 下面分别介绍一下这五种元注解。

参考文章

Java 注解入门到精通，这一篇就够了 - CSDN博客