## 简介

> 本文用于记录工作中遇到的，或道听途说的，奇奇怪怪的注解。主要包括但不限于`springboot`相关注解。
> 
> 记录内容主要包括：记录日期、所属依赖包、官方说明、源码、个人理解、用法示例。 如果个人理解有误，欢迎评论指出。



## @ConditionalOnProperty

- 记录日期：`2023-02-27`

- 所属依赖包：`org.springframework.boot.autoconfigure.condition`

- 官方说明：详见：[property-conditions](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#features.developing-auto-configuration.condition-annotations.property-conditions)

> The @ConditionalOnProperty annotation lets configuration be included based on a Spring Environment property. Use the prefix and name attributes to specify the property that should be checked. By default, any property that exists and is not equal to false is matched. You can also create more advanced checks by using the havingValue and matchIfMissing attributes.

- 源码：根据源码可知，该注解可用于类、方法，由于类注释较长，此处不贴出。

```java
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.TYPE, ElementType.METHOD })
@Documented
@Conditional(OnPropertyCondition.class)
public @interface ConditionalOnProperty {

	/**
	 * Alias for {@link #name()}.
	 * @return the names
	 */
	String[] value() default {};

	/**
	 * A prefix that should be applied to each property. The prefix automatically ends
	 * with a dot if not specified. A valid prefix is defined by one or more words
	 * separated with dots (e.g. {@code "acme.system.feature"}).
	 * @return the prefix
	 */
	String prefix() default "";

	/**
	 * The name of the properties to test. If a prefix has been defined, it is applied to
	 * compute the full key of each property. For instance if the prefix is
	 * {@code app.config} and one value is {@code my-value}, the full key would be
	 * {@code app.config.my-value}
	 * <p>
	 * Use the dashed notation to specify each property, that is all lower case with a "-"
	 * to separate words (e.g. {@code my-long-property}).
	 * @return the names
	 */
	String[] name() default {};

	/**
	 * The string representation of the expected value for the properties. If not
	 * specified, the property must <strong>not</strong> be equal to {@code false}.
	 * @return the expected value
	 */
	String havingValue() default "";

	/**
	 * Specify if the condition should match if the property is not set. Defaults to
	 * {@code false}.
	 * @return if the condition should match if the property is missing
	 */
	boolean matchIfMissing() default false;

}

```

- 个人理解

> `@ConditionalOnProperty`可以与`@Bean`结合使用，当配置项符合`@ConditionalOnProperty`限制条件时，`@Bean`才会生效。

- 用法示例：用在方法上，作用可以理解为当`spring.datasource.druid.slave.enabled`属性的值为`true`时，该方法才能够生效。

```java
@Bean
@ConfigurationProperties("spring.datasource.druid.slave")
@ConditionalOnProperty(prefix = "spring.datasource.druid.slave", name = "enabled", havingValue = "true")
public DataSource slaveDataSource(DruidProperties druidProperties)
{
    DruidDataSource dataSource = DruidDataSourceBuilder.create().build();
    return druidProperties.dataSource(dataSource);
}
```

## @CrossOrigin

- 记录日期：`2023-02-27`

- 所属依赖包：`org.springframework.web.bind.annotation`

- 官方说明：详见：[CrossOrigin](https://docs.spring.io/spring-framework/docs/6.0.5/javadoc-api/org/springframework/web/bind/annotation/CrossOrigin.html)

> Cross-origin resource sharing (CORS) is a W3C specification implemented by most browsers that lets you specify in a flexible way what kind of cross-domain requests are authorized, instead of using some less secure and less powerful approaches such as IFRAME or JSONP.
> 
> As of version 4.2, Spring MVC supports CORS. Using controller method CORS configuration with @CrossOrigin annotations in your Spring Boot application does not require any specific configuration. Global CORS configuration can be defined by registering a WebMvcConfigurer bean with a customized addCorsMappings(CorsRegistry) method, as shown in the following example:
> ```java
> @Configuration(proxyBeanMethods = false)
> public class MyCorsConfiguration {
> 
>     @Bean
>     public WebMvcConfigurer corsConfigurer() {
>         return new WebMvcConfigurer() {
> 
>             @Override
>             public void addCorsMappings(CorsRegistry registry) {
>                 registry.addMapping("/api/**");
>             }
> 
>         };
>     }
> 
> }
> ```

- 源码：可用于类、方法。源码都是英文注释，太长，有兴趣自行查看吧，要不然太水了。。。

- 个人理解

> 使用`@CrossOrigin`注解，可以解决部分因前后端分离出现的跨域问题，现在处理跨域问题的方法有很多，例如我工作中常用的处理方式是，前端在http工具类中处理。还有nginx代理处理等等，可视情况自行选用。

- 使用示例：用在类上

```java
@RestController
@CrossOrigin
@RequestMapping("/api")
public class ApiController {
//……此处具体省略代码
}
```

## @ComponentScan

> 配置Springboot自动扫描包，`@SpringbootApplication`有相同功能，所以一般无需适用，剔除某个想要的包时使用。

```java
// 剔除com.hlkj.core.*报下类的自动扫描
@ComponentScan(excludeFilters = @ComponentScan.Filter(type = FilterType.REGEX, pattern = "com.hlkj.core.*"))
```

奇奇怪怪的注解

## 简介

> 前端开发使用的包管理工具`yarn`安装。




## 安装

官方文档：[Installation | Yarn](https://yarnpkg.com/getting-started/install)

### Node.js >= 16.10

如果安装的node版本大于等于`16.10`。

使用管理员权限运行以下命令，开启核心包管理工具，cmd | powershell 均可。

> corepack enable

验证yarn，输出yarn版本：

> yarn -v

### Node.js <16.10

手动安装`corepack`相关工具

> npm i -g corepack


**其他情况安装可参考官方文档**

## Powershell开启yarn

参考文章：[解决PowerShell或vscode无法启动yarn的问题](https://blog.csdn.net/weixin_40136189/article/details/128834086)

因为在windows上，vscode使用的命令终端是powershell，但默认powershell的配置执行yarn是会报错的，如下错误信息：

```
yarn : 无法加载文件 D:\Program Files\nodejs\yarn.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.micros
oft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
所在位置 行:1 字符: 1
+ yarn -v
+ ~~~~
    + CategoryInfo          : SecurityError: (:) []，PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess
```

解决以上错误需要更改一个策略，修改方式如下：

- 方法一：
    - 打开设置 ——> 更新和安全 ——> 开发者选项，找到PowerShell
    - 勾选上“更改执行策略，以允许本地PowerShell脚本在未签名的情况下运行。”，
    - 点击应用，更改成功

- 方法二：
    - 管理员身份打开 PowerShell
    - 执行命令 set-ExecutionPolicy RemoteSigned
    - 如果提示询问是否要更改执行策略?，则选择 A 或 Y
    - 执行完毕后即可更改成功

Windows10安装yarn

```bash
# 查看当前镜像源
npm config get registry
```

```bash
# 设置淘宝镜像源
npm config set registry https://registry.npm.taobao.org
```

```
# 官方仓库
https://registry.npmjs.org/

# 淘宝仓库
https://registry.npm.taobao.org/

# cnpm
https://r.cnpmjs.org/
```

npm切换源

## 前言

> 本地克隆github仓库，出现以下报错的解决办法记录。
> ```
> Failed to connect to github.com port 443 after 21114 ms: Timed out
> ```
> 参考文章：https://blog.csdn.net/Hodors/article/details/103226958



## 解决

```sh
git config --global --unset http.proxy

git config --global --unset https.proxy
```

> 我只有拉取github的代码才出现错误，所以只执行https那一行即可。


## 后续

一个新的仓库又出现该问题，上面方法失效，目前还未解决。

### 猜测

可能因为我本地配置了`ssh`连接`github`，导致使用`https`克隆`github`代码超时？

改用`ssh`克隆代码一次就成功了。。。

配置`ssh`连接`github`可参考我的另一篇博客：[GitHub使用SSH连接](https://oldmoon.top/post/9)

## 再次后续

Github用户可以下载官方客户端`GitHub Desktop`，在网络不畅的情况下，推送成功率更高一些。

Github clone/pull 报错Timeout

## 简介

> 本文用于记录Nginx使用技巧。




## gzip压缩

> Nginx开启Gzip压缩功能，可以使网站的css、js 、xml、html 文件在传输时进行压缩，提高访问速度，进而优化Nginx性能！
> 
> Nginx可以通过`ngx_http_gzip_module`模块、`ngx_http_gzip_static_module`模块和`ngx_http_gunzip_module`模块对这些指令进行解析和处理。
> 
> 在Nginx配置文件中可以配置Gzip的使用，相关指令可以在http区域、server区域、location区域配置。
> 
> ps：如果你的服务器带宽较小，开启gzip压缩可以提升访问速度哦！


### 常用配置项

- `gzip on`：开启gzip压缩功能
- `gzip_vary on`：`on`为开启，`off`为关闭，开启后，服务器返回数据时会在头部带上"Vary:Accept-Encoding"的标识。客户端便可以知道获取到的数据是否已经被压缩，默认为关闭
- `gzip_min_length`：指定请求的数据超过某个阈值后才开启Gzip压缩功能，压缩很小的珊瑚橘反而会把数据变大，从而影响性能
- `gzip_buffers`：该指令用于设置文件使用的缓存空间大小，number为指定Nginx服务器要向服务器申请的缓存空间的个数，size 每个缓存的空间大小，从0.7版本之后默认情况下size*number的值为128，其中size去系统内存页的大小
- `gzip_disable`：支持针对不同匹配条件选择项关闭压缩功能，其中regex根据浏览器标志进行设置，支持使用正则表达式
- `gzip_http_version`：支持针对不同的http版本设置。早期的浏览器或者http不支持Gzip压缩功能,可能会出现乱码等现象。截止目前大多数客户端都支持Gzip压缩功能，因此选择默认即可
- `gzip_comp_level`
- `gzip_types`：响应报文数据格式，或者说类型，对应http响应头中的Content-type字段，如常见的有text/html、text/css、application/json、application/javaScript等。用于指定要压缩的响应报文类型。”*”表示压缩所有格式的响应报文，多种格式用空格隔开。如`text/html text/css text/plain`等

#### 配置示例

```
worker_processes 1;
 
events {
    worker_connections  1024;
}
 
http {
    include       mime.types;
    default_type  application/octet-stream;
 
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';
 
    access_log  logs/access.log  main;
    sendfile        on;
    keepalive_timeout  65;
 
 
    #开启gzip压缩功能
    gzip on;
    gzip_min_length 1024;
    gzip_buffers 4 16k;
    gzip_comp_level 2;
    gzip_types *;
    gzip_vary on;
 
    server {
        listen       80;
        server_name  localhost;
 
        location / {
            root   /data/software/nginx/html/dist;
            index  index.html index.htm;
        }
    }
}
```

## rewrite重写URL

> 实际开发中，无论出于什么原因，总是经常会有监听的uri需要替换或去除的需求，可以使用rewrite对url进行重写，以达到任何自定义的需求。

### 示例：

```
location /api/ {
    rewrite ^/api/(.*)$ /$1 break;
    proxy_pass http://backend_server;
}
# 代理为图片（文件）服务器，通过rewrite重写images为空，以达到去除请求url中/images节点的需求
location /images/ {
    rewrite ^/images/(.*)$ /$1 break;
    root /usr/local/img;
}
```

Nginx笔记

twitter:card

twitter:title

https://images.oldmoon.top/images/dingdangdog/oldmoon.png

twitter:image

努力做一只帅气、有才、豁达的老狗！

twitter:description