# 1 AttachmentAction介绍
| 工程名 | bos-attachment |
| ------ | --------------------------------- |
| 类路径 | kd.bos.web.actions; |
| 类名 | AttachmentAction |
| 作用 | 接收附件的上传，下载-预览HTTP请求 |
# 2 方法请求格式
```java
接口格式： public void preview(HttpServletRequest request, HttpServletResponse response)
请求方式： get
请求url格式：https://feature.kingdee.com:1026/patchcore/attachment/preview.do
作用： 附件预览 (根据目前浏览器的支持性，支持文本，图片和pdf，wps文件)其它格式为下载
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ----------- | ------------------------ | ---- | ----------- |
| path | 根据该path预览远程的文件 | 是 | |
| isFromCache | 是否从缓存中获取 | 是 | false\|true |
| isMobClient | 请求是否移动端 | 否 | false\|true |
```java
接口格式： public void download(HttpServletRequest request, HttpServletResponse response)
请求方式： get
请求url格式：https://feature.kingdee.com:2024/baseline_a/attachment/download.do?path=/test/1173910536060928000/202110/test/test/1262339436264348672/attachments/a91796a195634bc8b8291d64505a6adb/test.txt
作用：附件下载
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ------ | ---------------- | -------------------- | ---- |
| path | 远程的文件的path | 当id和type为空时必录 | |
| id | 附件唯一id（t_bos_attachment\|t_bd_attachment主键） | 当path为空时必录 | |
| type | 附件类型（附件面板\|附件字段） | 当path为空时必录 | "0"\|"1" |
```java
接口格式： public void downloadAll(HttpServletRequest request, HttpServletResponse response)
请求方式： get
请求url格式：https://feature.kingdee.com:1026/patchcore/attachment/downloadAll.do
作用：下载全部附件
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ------ | ---------------------------------- | ---- | ------------------------------- |
| params | List<map>集合的json存储url,type,id | 是 | [{"url":"","type":"1","id":""}] |
```java
接口格式： public void upload(HttpServletRequest request, HttpServletResponse response)
请求方式： post
请求url格式： https://feature.kingdee.com:1026/patchcore/attachment/upload.do?appId=kdtest_gld_test&fId=kdtest_gld_ptdj2&suffix=.rar,.zip,.webp,.webp,.xls,.xlsx
作用： 当在按钮上开启上传按钮，配置上传配置，点击该按钮即可上传文件，后台触发该方法
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ----------- | ---------------------------------------------------- | ---- | ----------- |
| suffix | 支持上传的文件后缀名 | 是 | .zip |
| tempstorage | 是否存储到临时服务器 | 否 | false\|true |
| type | 判断用户是移动端还是pc端（PC端不传，移动端传mobile） | 否 | mobile |
| file | 用户上传的文件流 | 是 | |
```java
接口格式： public void uploadFile(HttpServletRequest request, HttpServletResponse response)
请求方式： post
请求url格式：https://feature.kingdee.com:1026/patchcore/attachment/uploadFile.do
作用： 上传文件到临时服务器
移动端背景：云之家移动端先将文件上传到云之家服务器，服务器返回一个downloadUrl，后端解析该url下载文件，fileExt为文件后缀,fileId为返回的文件唯一id,fileName为文件名，fileSize为文件大小，localId为云之家文件存储地址
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ------ | ----------------------------------- | ---------------------- | ------------------------------------------------------------ |
| type | 判断用户是移动端还是pc端 | 移动端必录，不录为pc端 | mobile\|null |
| files | 用户上传的文件信息List<map>集合json | 移动端必录 | [{"downloadUrl" : "", "fileExt" : "", "fileId" : "", "fileName" : "", "fileSize": "", "fileTime" : "", "localId" : ""}] |
| file | 用户上传的文件流 | pc端必录 | |
```java
接口格式： public void remove(HttpServletRequest request, HttpServletResponse response)
请求方式： post
请求url格式：https://feature.kingdee.com:1026/patchcore/attachment/remove.do
作用： 删除文件
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ------ | ---------------- | ---- | ---- |
| path | 根据path删除文件 | 是 | |
```java
接口格式： public static String checkSpeSymbol(String fileFullName, HttpServletResponse response)
作用： 获取文件名包含的特殊符号，若返回为""则文件合法，否则不合法
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ------------ | -------- | ---- | ---- |
| fileFullName | 文件名 | 是 | |
| response | 响应对象 | 是 | |
```java
接口格式： public static void writeErrorMessage(HttpServletResponse response, String errorMessage)
作用： 响应错误提示信息
```
```
请求参数：
```
| 参数名 | 作用 | 必录 | 示例 |
| ------------ | -------- | ---- | ---- |
| response | 响应对象 | 是 | |
| errorMessage | 错误信息 | 是 | |
```java
接口格式： public boolean isIEBrowser(HttpServletRequest request)
作用： 判断是否IE浏览器发起的请求
```
```
请求参数：
```
| 位置 | 参数名 | 作用 | 必录 | 示例 |
| ------ | ---------- | -------------------------------- | ---- | ---- |
| header | User-Agent | 用户代理信息（系统，浏览器信息） | 是 | |
