## 简介

本文用于记录一些不是强制要求的开发规范，这些开发规范一般用于规范代码结构、名称等，使代码不再杂乱无章。

不定期更新……



## 通用

### 变量

1. **命名**：变量名建议使用驼峰式命名，如：`userName`。
2. **控制**：应该掌控变量的全部变化情况，避免出现预料之外的数值导致程序出现BUG。这不是说要掌控其值的全部确定值，而是按照规律分类，掌控其所有可能性，使其无论出现什么类型的数据都可以进行相应的操作。`PS：抛出异常也算是一种操作`。
3. **释放**：变量一般有固定的作用域，如果是需要手动控制内存释放的编程语言，要在变量超出作用域时or不再需要是，手动释放变量占用的内存；如果是具有垃圾回收机制的JVM类语言，也要了解其回收机制，确保无用的变量能被正确回收。
4. **初始化**（网友补充）：有些场景，需要注意变量值的初始化。在面向对象编程中，自定义对象变量时要格外注意，避免出现 NULL 异常。

## 前端
### BEM

该规范一般用于前端开发中，来规范元素 `class` 的命名。*BEM* 开发规范的核心思想包括以下几点：

1. 块（`Block`）：块是指页面上的独立的、可重用的组件，比如按钮 `v-button` 、导航栏 `v-tabs` 等。其中开头的 `v` 一般使框架的简称，如 `ElementUI` 的简称是 `el`。
2. 元素（`Element`）：元素是块的组成部分，它们只能在块的上下文中存在，不能单独使用。元素的命名是由块名加上双下划线再加上元素名构成的，比如 `.block__element`。
3. 修饰符（`Modifier`）：修饰符是用于修改块或元素外观、状态或行为的标记。修饰符的命名是由块或元素名加上双连字符再加上修饰符名构成的，比如 `.block--modifier` 或 `.block__element--modifier`。

一些开发规范记录

## 简介

GithubApi 官方提供一了一些SDK，node仓库的好用一些，Java的也有官方推荐的，但是用的不是很多，所以还是决定自己写以下。

本文记录几个使用 `RestTemplate` 调用 `GithubApi` 的实例。

- 环境：`Java17` + `Springboot3.2+`



## 输出List：分页请求

```java

    /**
     * 仓库发布信息列表查询URL
     */
    private static final String RELEASE_LIST_URL = "https://api.github.com/repos/{user}/{repo}/releases";
    
    /**
     * 获取仓库Releases列表
     *
     * @param user user
     * @param repo repo
     * @param pageParam 分页参数
     * @return List<GithubRelease>
     */
    public static List<GithubRelease> getReleases(String user, String repo, Map<String, Object> pageParam) {
        String url = RELEASE_LIST_URL
                .replace("{user}", user)
                .replace("{repo}", repo);
        RestTemplate restTemplate = new RestTemplate();
        // 请求信息封装
        RequestEntity<Void> requestEntity = getRequestEntity(url, null, pageParam);
        // 发送请求并获得响应
        ResponseEntity<List<GithubRelease>> responseEntity = restTemplate.exchange(requestEntity, new ParameterizedTypeReference<List<GithubRelease>>() {
        });
        return responseEntity.getBody();
    }
    
    
    private static RequestEntity<Void> getRequestEntity(String url, Map<String, String> headerMap, Map<String, Object> param) {
        HttpHeaders headers = new HttpHeaders();
        if (AitLogProperties.getGithubToken() != null) {
            headers.setBearerAuth(AitLogProperties.getGithubToken());
        }
        if (headerMap != null) {
            for (Map.Entry<String, String> entry : headerMap.entrySet()) {
                headers.add(entry.getKey(), entry.getValue());
            }
        }

        return new RequestEntity<>(headers, HttpMethod.GET, URI.create(url + mapToUrlParam(param)));
    }
```

## 输出Map/Object

```java
    /**
     * 仓库基本信息查询URL
     */
    private static final String REPO_INFO_URL = "https://api.github.com/repos/{user}/{repo}";

    /**
     * 获取仓库信息
     *
     * @param user GithubUser
     * @param repo GithubRepo
     * @return GithubRepository
     */
    public static GithubRepository getRepoInfo(String user, String repo) {
        String url = REPO_INFO_URL
                .replace("{user}", user)
                .replace("{repo}", repo);
        return get(url, null, GithubRepository.class);
    }

    /**
     * Get 请求封装
     *
     * @param  url   请求地址
     * @param  param 请求参数
     * @param  clazz 响应数据实体类型
     * @return 响应数据实体
     */
    public static <T> T get(String url, Map<String, Object> param, Class<T> clazz) {
        RestTemplate restTemplate = new RestTemplate();
        RequestEntity<Void> requestEntity = getRequestEntity(url, null, param);
        ResponseEntity<T> responseEntity = restTemplate.exchange(
                requestEntity,
                clazz
        );
        return responseEntity.getBody();
    }
```

## 输出String

```java
    /**
     * Readme URL
     */
    private static final String README_URL = "https://api.github.com/repos/{user}/{repo}/readme";

    /**
     * 获取一个仓库的Readme内容，以Html格式返回
     *
     * @param user the username of the repository owner
     * @param repo the name of the repository
     * @return the HTML content of the README file
     */
    public static String getReadmeHtml(String user, String repo) {
        String url = README_URL
                .replace("{user}", user)
                .replace("{repo}", repo);

        RestTemplate restTemplate = new RestTemplate();

        HttpHeaders headers = new HttpHeaders();
        // 设置请求头
        if (AitLogProperties.getGithubToken() != null) {
            headers.setBearerAuth(AitLogProperties.getGithubToken());
        }
        headers.setAccept(MediaType.parseMediaTypes("application/vnd.github.html+json"));

        RequestEntity<Void> requestEntity = new RequestEntity<>(headers, HttpMethod.GET, URI.create(url));
        // 发送请求并获得响应
        ResponseEntity<String> responseEntity = restTemplate.exchange(
                requestEntity,
                String.class
        );
        return responseEntity.getBody();
    }

```

Java17+Spring RestTemplate调用GithubApi

## 简介

如果Windows没有开启 `Hyper-V` 功能，会导致 `Docker Desktop` 无法正常启动，但开启了 `Hyper-V` 后，可以启动，但是报错：`No hypervisor is present on this system`。



## 解决方案

1. 管理员方式打开命令行窗口（CMD）；
2. 执行命令：`bcdedit /set hypervisorlaunchtype auto`；
3. 重启Windows；
4. 尝试启动`Docker Desktop`。

## 已知原因

如果原先时开启Hyper的，某些 Android模拟器 会提示不兼容，若点击修复，可能会执行：`bcdedit /set hypervisorlaunchtype off`，这就会导致 禁用`hyper-v`，Docker 无法正常使用。

Docker Desktop for Windows: No hypervisor is present on this system

## 简介

本文用于记录一些Git命令。




## 设置本地用户

```bash
# 设置本地(本仓库)用户名为：xxx
git config user.name xxx
# 设置本地(本仓库)用户邮箱为：xxx@qq.com
git config user.email xxx@qq.com

# 设置本地全局用户名为：xxx
git config --global user.name xxx
# 设置本地全局用户邮箱为：xxx@qq.com
git config --global user.email xxx@qq.com
```

## ADD

- 一般是commit命令的前置操作

```bash
# 将当前文件夹中的所有文件添加到git版本控制中
git add .
# 将当前文件夹中的 readme.md 文件添加到git版本控制中
git add readme.md
```

Git常用命令

这里记录老狗玩老头环时，Xbox设置的键位，万一很久没玩忘记了，可以回来瞅瞅。

B站视频演示：https://www.bilibili.com/video/BV1LGh4eBEAC

![image](https://images.oldmoon.top/images/dingdangdog/dingdangdog-1720177561.jpg)

> PS：前有重要道具。

- Y：剧情（捡起物品，开启宝箱，调查剧情等等）
- X：轻攻击
- B：战技
- A：跳跃
- Y+RT：双持右手
- Y+B/LB：双持左手
- Y+上下左右：使用对应快捷装备，上-上马；下-召唤；左-望远镜；右-腰挂提灯。
- 上：切换魔法/祷告
- 下：切换道具（药水）
- 左：切换左手武器
- 右：切换右手武器
- LT：翻滚，冲刺（静止按是后跳）
- LB：防御（`左手盾`）/ 祷告（`左手印记`）/ 魔法（`左手法杖`）
- RT：重攻击
- RB：锁定，重置镜头
- L轴：移动人物
- L轴按下：蹲下/站起，下马
- R轴：移动镜头（`人物朝向`）/ 切换锁定
- R轴按下：使用道具（喝药）
- 菜单键：跳过剧情CG动画
- 平板键：打开地图

## 重要提示

1. 如果右手拿的是 `法杖/印记` 则轻攻击是释放 `魔法/祷告`。
2. 如果双手武器都有战技，则优先释放左手武器的战技。



## 物品背包

- X：切换物品信息
- A：使用
- LB：向左切换物品类型
- RB：向右切换物品类型
- 上下左右：切换选中的物品

## 仓库

- Y：切换背包与仓库
- A：放入/取出

## 装备页面

- Y: 切换个人信息
- X: 卸下
- B: 返回
- A: 装备

## 剧情

- Y/A：跳过对话
- A：确定
- B：返回

## 地图

- X：特殊标记
- A：指引标记（蓝色光柱）
- Y：赐福一览
- Y+X+A：快速回到大赐福
- R轴按下：切换地图：地上、地下
- RB：切换地图：交界地/幽影地

艾尔登法环手柄键位