## 1.Forest框架介绍
- Forest是一个高层的、极简的声明式HTTP调用API框架相比于直接使用Httpclient您不再用写一大堆重复的代码了，而是像调用本地方法一样去发送HTTP请求
- 官方[gitee地址](https://gitee.com/dromara/forest)
- 官方[文档地址](https://forest.dtflyx.com/pages/1.5.36/intro/)
<img src="https://cos.haowee.cn/img/forest1.png" width="600px">


## 2.Forest框架用法
- 第一步先在项目的pom中引入forest



```    <dependency>
      <groupId>com.dtflys.forest</groupId>
      <artifactId>forest-spring-boot-starter</artifactId>
      <version>1.5.2-BETA</version>
    </dependency>
```
</br>

- 第二步在application.yml中配置参数

```forest:
  timeout: 5000 # 请求超时时间，单位为毫秒（默认为 3000）
  connect-timeout: 5000 # 连接超时时间，单位为毫秒（默认为 timeout）
  read-timeout: 5000 # 数据读取超时时间，单位为毫秒（默认为 timeout）
  variables:
    message: 127.0.0.1:7778 
```
message 这个是自定义的http接收的ip地址和端口

- 第三步定义一个client接口，填写完整具体的接收地址
```
import com.dtflys.forest.annotation.JSONBody;
import com.dtflys.forest.annotation.Post;

import java.util.Map;

public interface MsgClient {
    @Post(
            url = "http://${message}/abcd/message/sendMsg?jsonData=${0}"
    )
    Map<String, Object> sendMsg(@JSONBody String jsonData);
}

```
- 最后引用client实现发送消息
在需要发消息的时候引用MsgClient，再根据接口要求填上具体的参数名、参数参数值就可以实现消息的发送

## 请求方法

| HTTP 请求方法 | 请求注解 | 描述|
| --- | --- |---|
|GET	|@Get、@GetRequest	|获取资源|
|POST	|@Post、@PostRequest	传输实体文本|
|PUT	|@Put、@PutRequest	|上传资源|
|HEAD	|@HeadRequest	获取报文首部|
|DELETE	|@Delete、@DeleteRequest	|删除资源|
|OPTIONS	|@Options、@OptionsRequest	|询问支持的方法|
|TRACE	|@Trace、@TraceRequest	|追踪路径|
|PATCH	|@Patch、@PatchRequest	|更新资源的某一部分|
|不定方法	|@Request	|可动态传入HTTP方法|

[例子](https://forest.dtflyx.com/pages/1.5.36/http_method/#get-%E8%AF%B7%E6%B1%82)

## URL参数-GET
### 字符串模板
```java
/**
 * 直接在url字符串的问号后面部分直接写上 参数名=参数值 的形式
 * 等号后面的参数值部分可以用 {参数序号} 这种字符串模板的形式替代
 * 在发送请求时会动态拼接成一个完整的URL
 * 使用这种形式不需要为参数定义额外的注解
 * 
 * 注：参数序号是从 0 开始记的方法参数的序号
 * 0 代表第一个参数，1 代表第二个参数，以此类推
 */
@Get("http://localhost:8080/abc?a={0}&b={1}&id=0")
String send1(String a, String b);

/**
 * 直接在url字符串的问号后面部分直接写上 参数名=参数值 的形式
 * 等号后面的参数值部分可以用 {变量名} 这种字符串模板的形式替代
 * 在发送请求时会动态拼接成一个完整的URL
 * 使用这种方式需要通过 @Var 注解或全局配置声明变量
 */
@Get("http://localhost:8080/abc?a={a}&b={b}&id=0")
String send2(@Var("a") String a, @Var("b") String b);


/**
 * 如果一个一个变量包含多个Query参数，比如: "a=1&b=2&c=3"
 * 为变量 parameters 的字符串值
 * 就用 ${变量名} 这种字符串模板格式
 * 使用这种方式需要通过 @Var 注解或全局配置声明变量
 */
@Get("http://localhost:8080/abc?${parameters}")
String send3(@Var("parameters") String parameters);
```
### @Query注解
```java


/**
 * 使用 @Query 注解，可以直接将该注解修饰的参数动态绑定到请求url中
 * 注解的 value 值即代表它在url的Query部分的参数名
 */
@Get("http://localhost:8080/abc?id=0")
String send(@Query("a") String a, @Query("b") String b);


/**
 * 使用 @Query 注解，可以修饰 Map 类型的参数
 * 很自然的，Map 的 Key 将作为 URL 的参数名， Value 将作为 URL 的参数值
 * 这时候 @Query 注解不定义名称
 */
@Get("http://localhost:8080/abc?id=0")
String send1(@Query Map<String, Object> map);


/**
 * @Query 注解也可以修饰自定义类型的对象参数
 * 依据对象类的 Getter 和 Setter 的规则取出属性
 * 其属性名为 URL 参数名，属性值为 URL 参数值
 * 这时候 @Query 注解不定义名称
 */
@Get("http://localhost:8080/abc?id=0")
String send2(@Query UserInfo user);


/*
 * 接受列表参数为URL查询参数
 */
@Get("http://localhost:8080/abc")
String send1(@Query("id") List idList);

/*
 * json的方式传参
 */
@Get("http://localhost:8080/abc")
String send(@JSONQuery("id") List idList);


// 使用 Lazy 作为 Query 的参数类型
@Post("/data")
String sendData(@Query("a") String a, @Query("b") String b, @Query("token") Lazy<String> token);

```

## 请求头
动态请求头使用@Header注解
```java
/**
 * 使用 @Header 注解将参数绑定到请求头上
 * @Header 注解的 value 指为请求头的名称，参数值为请求头的值
 * @Header("Accept") String accept将字符串类型参数绑定到请求头 Accept 上
 * @Header("accessToken") String accessToken将字符串类型参数绑定到请求头 accessToken 上
 */
@Post("http://localhost:8080/hello/user?username=foo")
void postUser(@Header("Accept") String accept, @Header("accessToken") String accessToken);

/**
 * 使用 @Header 注解可以修饰 Map 类型的参数
 * Map 的 Key 指为请求头的名称，Value 为请求头的值
 * 通过此方式，可以将 Map 中所有的键值对批量地绑定到请求头中
 */
@Post("http://localhost:8080/hello/user?username=foo")
void headHelloUser(@Header Map<String, Object> headerMap);

/**
 * 使用 @Header 注解可以修饰自定义类型的对象参数
 * 依据对象类的 Getter 和 Setter 的规则取出属性
 * 其属性名为 URL 请求头的名称，属性值为请求头的值
 * 以此方式，将一个对象中的所有属性批量地绑定到请求头中
 */
@Post("http://localhost:8080/hello/user?username=foo")
void headHelloUser(@Header MyHeaderInfo headersInfo);
```

## 请求体-POST
|type	|data属性数据绑定位置	|支持的contentType或Content-Type请求头|
| --- | --- |---|
|GET	|url参数部分	|只有application/x-www-form-urlencoded|
|POST	|请求体	|任何contentType|
|PUT	|请求体	|任何contentType|
|PATCH	|请求体	|任何contentType|
|HEAD	|url参数部分	|只有application/x-www-form-urlencoded|
|OPTIONS	|url参数部分	|只有application/x-www-form-urlencoded|
|DELETE	|url参数部分	|只有application/x-www-form-urlencoded|
|TRACE	|url参数部分	|只有application/x-www-form-urlencoded|

### @Body
```java
/**
 * 默认body格式为 application/x-www-form-urlencoded，即以表单形式序列化数据
 */
@Post("http://localhost:8080/user")
String sendPost(@Body("username") String username,  @Body("password") String password);
```
### 表单
```java

/**
 * contentType属性设置为 application/x-www-form-urlencoded 即为表单格式，
 * 当然不设置的时候默认值也为 application/x-www-form-urlencoded， 也同样是表单格式。
 * 在 @Body 注解的 value 属性中设置的名称为表单项的 key 名，
 * 而注解所修饰的参数值即为表单项的值，它可以为任何类型，不过最终都会转换为字符串进行传输。
 */
@Post(
    url = "http://localhost:8080/user",
    contentType = "application/x-www-form-urlencoded"
)
String sendPost(@Body("key1") String value1,  @Body("key2") Integer value2, @Body("key3") Long value3);

```

### JSON
@JSONBody注解可以修饰对象、键值对、集合对象、字符串
```java
/**
 * 被@JSONBody注解修饰的参数会根据其类型被自定解析为JSON字符串
 * 使用@JSONBody注解时可以省略 contentType = "application/json"属性设置
 */
@Post("http://localhost:8080/hello/user")
String helloUser(@JSONBody User user);

//键值对
/**
 * 按键值对分别修饰不同的参数
 * 这时每个参数前的 @JSONBody 注解必须填上 value 属性或 name 属性的值，作为JSON的字段名称
 */
@Post("http://localhost:8080/hello/user")
String helloUser(@JSONBody("username") String username, @JSONBody("password") String password);

//集合对象
/**
 * 被@JSONBody注解修饰的Map类型参数会被自定解析为JSON字符串
 */
@Post(url = "http://localhost:8080/hello/user")
String helloUser(@JSONBody Map<String, Object> user);

//字符串
/**
 * 直接修饰一个JSON字符串
 */
@Post("http://localhost:8080/hello/user")
String helloUser(@JSONBody String userJson);
```
除了@JSONBody注解，使用@Body注解也可以，只要将contentType属性或Content-Type请求头指定为application/json便可。

Forest - 声明式HTTP客户端框架

# hutool工具类 [官网](https://www.hutool.cn/)  [API文档](https://plus.hutool.cn/apidocs/)
:::info{title="优点"}
Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。
:::
![hutool1](https://cos.haowee.cn/img/hutool1.png)

主要使用点日期的获取年月日等各种时间（DateUtil），两个类进行拷贝（BeanUtil）方法为copyProperties方法。

# pom文件中引入
```
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.12</version>
</dependency>

```

hutool包含的具体工具类，涵盖开发的百分之九十，防止重复造轮子，提高程序开发效率。
# 1.工具类
- 字符串工具-StrUtil
- 16进制工具-HexUtil
- Escape工具-EscapeUtil
- Hash算法-HashUtil
- URL工具-URLUtil
- XML工具-XmlUtil
- 对象工具-ObjectUtil
- 反射工具-ReflectUtil
- 泛型类型工具-TypeUtil
- 分页工具-PageUtil
- 剪贴板工具-ClipboardUtil
- 类工具-ClassUtil
- 类加载工具-ClassLoaderUtil
- 枚举工具-EnumUtil
- 命令行工具-RuntimeUtil
- 数字工具-NumberUtil
- 数组工具-ArrayUtil
- 随机工具-RandomUtil
- 唯一ID工具-IdUtil
- 压缩工具-ZipUtil
- 引用工具-ReferenceUtil
- 正则工具-ReUtil
- 身份证工具-IdcardUtil
- 信息脱敏工具-DesensitizedUtil
- 社会信用代码工具-CreditCodeUtil
- SPI加载工具-ServiceLoaderUtil

# 2.日期时间
- 类型转换工具类-Convert
- 自定义类型转换-ConverterRegistry
- 日期时间工具-DateUtil
- 日期时间对象-DateTime
- 农历日期-ChineseDate
- LocalDateTime工具-LocalDateTimeUtil
- 计时器工具-TimeInterval
# 3.IO流相关
- IO工具类-IoUtil
- 文件工具类-FileUtil
- 文件类型判断-FileTypeUtil
- 文件监听-WatchMonitor
- 文件读取-FileReader
- 文件写入-FileWriter
- 文件追加-FileAppender
- 文件跟随-Tailer
- 文件名工具-FileNameUtil
- 资源工具-ResourceUtil
- ClassPath资源访问-ClassPathResource
# 4.语言特性
- HashMap扩展-Dict
- 单例工具-Singleton
# 5.断言-Assert
- 二进码十进数-BCD
- 控制台打印封装-Console
- 字段验证器-Validator
- 字符串格式化-StrFormatter
- 树结构工具-TreeUtil
# 6.JavaBean
- Bean工具-BeanUtil
# 7.DynaBean
表达式解析-BeanPath
Bean描述-BeanDesc
空检查属性获取-OptinalBean
# 8.集合类
- 集合工具-CollUtil
- 列表工具-ListUtil
- Iterator工具-IterUtil
- 有界优先队列-BoundedPriorityQueue
- 线程安全的HashSet-ConcurrentHashSet
# 9.Map
- Map工具-MapUtil
- 双向查找Map-BiMap
- 可重复键值Map-TableMap
# 10.Codec编码
- Base62编码解码-Base62
- Base64编码解码-Base64
- Base32编码解码-Base32
# 11.文本操作
- CSV文件处理工具-CsvUtil
- 可复用字符串生成器-StrBuilder
- Unicode编码转换工具-UnicodeUtil
- 字符串切割-StrSpliter
# 12.注解
- 注解工具-AnnotationUtil
# 13.比较器
- 比较工具-CompareUtil
- 版本比较器-VersionComparator
# 14.异常
- 异常工具-ExceptionUtil
- 其它异常封装
# 15.数学
- 数学相关-MathUtil
# 16.线程和并发
- 线程工具-ThreadUtil
- 自定义线程池-ExecutorBuilder
- 高并发测试-ConcurrencyTester
# 17.图片
- 图片工具-ImgUtil
- 图片编辑器-Img
# 18.网络
- 网络工具-NetUtil
- URL生成器-UrlBuilder
# 19.源码编译
- 源码编译工具-CompilerUtil.md
- 缓存（Hutool-cache）
- 缓存工具-CacheUtil
- 先入先出-FIFOCache
- 最少使用-LFUCache
- 最近最久未使用-LRUCache
- 超时-TimedCache
- 弱引用-WeakCache
- 文件缓存-FileCache
- 20.JSON（Hutool-json）
- JSON工具-JSONUtil
- JSON对象-JSONObject
- JSON数组-JSONArray
# 21.加密解密（Hutool-crypto）
- 加密解密工具-SecureUtil
- 对称加密-SymmetricCrypto
- 非对称加密-AsymmetricCrypto
- 摘要加密-Digester
- 消息认证码算法-HMac
- 签名和验证-Sign
- 国密算法工具-SmUtil
# 22.DFA查找（Hutool-dfa）
- DFA查找
# 23.HTTP客户端（Hutool-http）
- Http客户端工具类-HttpUtil
- Http请求-HttpRequest
- Http响应-HttpResponse
- HTML工具类-HtmlUtil
- UA工具类-UserAgentUtil
- 简易Http服务器-SimpleServer
# 24.定时任务（Hutool-cron）
- 全局定时任务-CronUtil
# 25.扩展（Hutool-extra）
- 邮件工具-MailUtil
- 二维码工具-QrCodeUtil
- Servlet工具-ServletUtil
- 模板引擎封装-TemplateUtil
- Jsch(SSH)工具-JschUtil
- FTP封装-Ftp
- Emoji工具-EmojiUtil
- 中文分词封装-TokenizerUtil
- Spring工具-SpringUtil
- Cglib工具-CglibUtil
- 拼音工具-PinyinUtil
- 布隆过滤（Hutool-bloomFilter）
- 切面代理工具-ProxyUtil
- Script工具-ScriptUtil
- 图形验证码（Hutool-captcha）
- Office文档操作（Hutool-poi）
- Excel工具-ExcelUtil
- Excel读取-ExcelReader
- 流方式读取Excel2003-Excel03SaxReader
- 流方式读取Excel2007-Excel07SaxReader
- Excel生成-ExcelWriter
- Excel大数据生成-BigExcelWriter
- Word生成-Word07Writer
- 系统调用（Hutool-system）
- 系统属性调用-SystemUtil
- Oshi封装-OshiUtil

Hutool工具类属性汇总

:::tip{title="提示"}
服务器的带宽不足，会导致访问网站很慢，这时我们就需要使用CDN为自己的网站进行加速，其原理加速云服务器事先对网站的资源进行缓存，从而提高网站的访问效率。
:::

### 由于我的域名在腾讯云，我就采用腾讯云的CDN加速服务
#### 1.进入腾讯云控制台，搜索CDN

<img src="https://cos.haowee.cn/img/cdn1.png"
width="800px">

点击立即使用，就可以进入CDN控制台

#### 2.进入控制台主页，点击添加域名

<img src=" https://cos.haowee.cn/img/cdn2.png"
width="800px">




</br>

#### 3.进入配置界面
<img src=" https://cos.haowee.cn/img/cdn3.png"
width="800px">


上部分根据自己的服务器归属地选择加速区域，加速类型的话我是个人网站，选择网页小文件，其他选项也可以根据带宽要求进行调整，源站类型的意思应该是你网站资源是自己的存储还是第三方存储，自己建站就选自己好了
源站地址就是你服务器的地址，然后点击下一步就好了

</br>


#### 4.进入缓存规则的配置，默认即可
<img src="https://cos.haowee.cn/img/cdn4.png"
width="800px">

#### 5.最后添加域名解析
点击完成会生成一个CNAME，把这个配置到域名解析里就可以实现加速访问。

<img src="https://cos.haowee.cn/img/cdn5.png"
width="800px">

为网站添加CDN加速

:::tip{title="前提"}
当我们获取到一个jar包的时候，需要导入maven时，不了解jar包的信息就写不了导入的语句
:::

### 1.可以去[maven官网](https://search.maven.org/)查询jar包的信息
只需输入jar包名称就可以查询到，如图

![maven.png](https://cos.haowee.cn/img/maven.png)

点击版本就可以看到更详细的信息

![maven2.png](https://cos.haowee.cn/img/maven2.png)

但是只能查到网络上公开的jar包信息，因为这些jar包才会被收录进去，第三方的jar就不能查询到




### 2. 解包查询信息

采用jd-dui工具，添加需要的jar包
![](https://cos.haowee.cn/img/20221013201354.png)

上面的名称sqljdbc4就是artifactid，gropid就是com.microsoft,版本号可以点开meta——inf查看版本号就可
![](https://cos.haowee.cn/img/20221013201520.png)


举个例子log4j
![](https://cos.haowee.cn/img/20221024135919.png)

```
mvn install:install-file "-DgroupId=com.ewell.medai" 
"-DartifactId=pat-integration-api" 
"-Dversion=1.0.0-RELEASE" 
-Dpackaging=jar 
-Dfile=C:\maven\pat-integration-api-1.0.0-RELEASE.jar
```

获取jar包的artifactId,groupId,version

## 问题的前提
**需求需要多个病历类型的聚合显示** 
java和oracle都可以实现
java需要遍历数组，稍显麻烦
于是我则采用Oracle的聚合函数来是实现，主要是展示一下用法

#### 1.聚合函数-wmsys.wm_concat
```
select wmsys.wm_concat(DOC_TITLE) as doc_titile
from rec_recall_doc_auth t
```
如果是同时想查询多个字段就需要用 group by进行分组

#### 结果展示
<img src="https://cdn.nlark.com/yuque/0/2023/png/32817653/1676968893132-5f14d747-bb15-4a2c-a919-a46260a7eac7.png" width='400px'>

可以看出是采用多个记录内容之间默认采用”，”进行拼接而成


#### 2.聚合函数-LISTAGG

```
select LISTAGG(DOC_TITLE, '-') within group (order by DOC_TITLE) as doc_titile

from rec_recall_doc_auth t
```
#### 结果展示

<img src="https://cdn.nlark.com/yuque/0/2023/png/32817653/1676968901747-e8539816-623a-4609-9484-589835c6c031.png" width='400px'>

可以看出是采用多个记录内容之间的拼接方式是我们自己定义的

1.Forest框架介绍

2.Forest框架用法

hutool工具类官网 API文档

pom文件中引入

由于我的域名在腾讯云，我就采用腾讯云的CDN加速服务

1.进入腾讯云控制台，搜索CDN

2.进入控制台主页，点击添加域名

1.可以去maven官网查询jar包的信息

问题的前提

1.聚合函数-wmsys.wm_concat

结果展示

2.聚合函数-LISTAGG

结果展示

1.Forest框架介绍

2.Forest框架用法

hutool工具类 官网 API文档

pom文件中引入

由于我的域名在腾讯云，我就采用腾讯云的CDN加速服务

1.进入腾讯云控制台，搜索CDN

2.进入控制台主页，点击添加域名

1.可以去maven官网查询jar包的信息

问题的前提

1.聚合函数-wmsys.wm_concat

结果展示

2.聚合函数-LISTAGG

结果展示

hutool工具类官网 API文档