117 lines
4.1 KiB
Markdown
117 lines
4.1 KiB
Markdown
|
### 1. 上传逻辑核心步骤
|
|||
|
|
|
|||
|
|
1. **读取本地文件**：将文件读入字节数组。
|
|||
|
|
|
|||
|
|
2. **Base64 编码**：Salesforce 的 `Attachment` 对象要求 `Body` 字段必须是 Base64 编码的文本。
|
|||
|
|
|
|||
|
|
3. **构造 JSON 负载**：
|
|||
|
|
|
|||
|
|
- `ParentId`: 关联的记录 ID（如 Account, Contact, 或自定义对象的 ID）。
|
|||
|
|
|
|||
|
|
- `Name`: 文件名。
|
|||
|
|
|
|||
|
|
- `Body`: Base64 后的字符串。
|
|||
|
|
|
|||
|
|
4. **发送 POST 请求**：调用 `sobjects/Attachment/` 接口。
|
|||
|
|
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2. Java 代码实现 (基于 HttpClient)
|
|||
|
|
|
|||
|
|
这里继续使用 Java 11+ 的 `HttpClient`。为了代码简洁，使用了 `java.util.Base64`。
|
|||
|
|
|
|||
|
|
Java
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
import java.io.nio.file.Files;
|
|||
|
|
import java.io.nio.file.Path;
|
|||
|
|
import java.net.URI;
|
|||
|
|
import java.net.http.HttpClient;
|
|||
|
|
import java.net.http.HttpRequest;
|
|||
|
|
import java.net.http.HttpResponse;
|
|||
|
|
import java.util.Base64;
|
|||
|
|
import java.util.Map;
|
|||
|
|
import com.fasterxml.jackson.databind.ObjectMapper; // 建议使用 Jackson 处理 JSON
|
|||
|
|
|
|||
|
|
public class SalesforceFileUploader {
|
|||
|
|
|
|||
|
|
private static final String INSTANCE_URL = "https://your-instance.my.salesforce.com";
|
|||
|
|
private static final String ACCESS_TOKEN = "YOUR_ACCESS_TOKEN";
|
|||
|
|
|
|||
|
|
public void uploadAttachment(String parentId, String filePath, String fileName) throws Exception {
|
|||
|
|
// 1. 将文件转换为 Base64 字符串
|
|||
|
|
byte[] fileContent = Files.readAllBytes(Path.of(filePath));
|
|||
|
|
String encodedString = Base64.getEncoder().encodeToString(fileContent);
|
|||
|
|
|
|||
|
|
// 2. 准备请求体数据
|
|||
|
|
Map<String, String> payload = Map.of(
|
|||
|
|
"ParentId", parentId,
|
|||
|
|
"Name", fileName,
|
|||
|
|
"Body", encodedString
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
// 使用 Jackson 将 Map 转换为 JSON 字符串
|
|||
|
|
String jsonPayload = new ObjectMapper().writeValueAsString(payload);
|
|||
|
|
|
|||
|
|
// 3. 构建 POST 请求
|
|||
|
|
HttpClient client = HttpClient.newHttpClient();
|
|||
|
|
HttpRequest request = HttpRequest.newBuilder()
|
|||
|
|
.uri(URI.create(INSTANCE_URL + "/services/data/v58.0/sobjects/Attachment/"))
|
|||
|
|
.header("Authorization", "Bearer " + ACCESS_TOKEN)
|
|||
|
|
.header("Content-Type", "application/json")
|
|||
|
|
.POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
|
|||
|
|
.build();
|
|||
|
|
|
|||
|
|
// 4. 发送并处理响应
|
|||
|
|
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
|
|||
|
|
|
|||
|
|
if (response.statusCode() == 201) {
|
|||
|
|
System.out.println("上传成功！Salesforce ID: " + response.body());
|
|||
|
|
} else {
|
|||
|
|
System.err.println("上传失败: " + response.body());
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3. 关键字段说明
|
|||
|
|
|
|||
|
|
|**字段名**|**必填**|**说明**|
|
|||
|
|
|---|---|---|
|
|||
|
|
|**`ParentId`**|是|附件所属记录的 ID。|
|
|||
|
|
|**`Name`**|是|附件显示的名称（需带后缀，如 `report.pdf`）。|
|
|||
|
|
|**`Body`**|是|文件的 **Base64** 编码内容。|
|
|||
|
|
|**`Description`**|否|附件的简短描述。|
|
|||
|
|
|**`IsPrivate`**|否|布尔值，是否设置为私有。|
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 4. 注意事项与限制
|
|||
|
|
|
|||
|
|
- **文件大小限制**：
|
|||
|
|
|
|||
|
|
- 通过简单 REST API (JSON) 上传时，受限于请求体大小，通常建议单个文件**不超过 50MB**（Base64 编码后体积会增加约 33%）。
|
|||
|
|
|
|||
|
|
- 如果需要上传超大文件，建议使用 **Multipart/form-data** 格式，或者改用 **Salesforce Files (ContentVersion)** 对象。
|
|||
|
|
|
|||
|
|
- **堆内存消耗**：
|
|||
|
|
|
|||
|
|
- `Files.readAllBytes` 和 Base64 编码都会在 Java 内存中创建大对象。如果系统需要并发处理大量上传，建议优化为流式处理或增加 JVM 堆空间。
|
|||
|
|
|
|||
|
|
- **弃用警告**：
|
|||
|
|
|
|||
|
|
- Salesforce 官方已经不推荐在新项目中使用 `Attachment`，取而代之的是 **`ContentVersion`**（即 Salesforce Files）。`ContentVersion` 支持版本控制、更灵活的共享机制以及更大的单文件上限（最大 2GB）。
|
|||
|
|
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5. (进阶建议) 改用 ContentVersion (Files) 吗？
|
|||
|
|
|
|||
|
|
如果你的业务允许，强烈建议将 `Attachment` 替换为 `ContentVersion`。两者的主要区别是：
|
|||
|
|
|
|||
|
|
- **Attachment**: 绑定在 ParentId 上，功能单一。
|
|||
|
|
|
|||
|
|
- **ContentVersion**: 先上传文件生成 ID，再通过 `ContentDocumentLink` 关联到多个记录，功能更强大。
|