TranslateFacade .md
... ...
@@ -0,0 +1,146 @@
1
+# TranslateFacade 多语言门面类
2
+封装对 `TranslateManager` 的调用，提供统一的多语言翻译入口。支持翻译获取、翻译数据变更监控、批量注册与删除、语言环境管理等功能。
3
+
4
+---
5
+
6
+## 类路径
7
+```plain
8
+java
9
+
10
+
11
+复制编辑
12
+package com.sie.snest.engine.facade;
13
+```
14
+
15
+---
16
+
17
+## 引用类
18
+```plain
19
+java
20
+
21
+
22
+复制编辑
23
+import com.sie.snest.engine.i18n.TranslateEntry;
24
+import com.sie.snest.engine.i18n.TranslateManager;
25
+import com.sie.snest.engine.model.BaseMeta;
26
+
27
+import java.util.*;
28
+```
29
+
30
+---
31
+
32
+## 方法说明
33
+### `getTranslate(BaseMeta baseMeta, String resource)`
34
+```plain
35
+java
36
+
37
+
38
+复制编辑
39
+public static String getTranslate(BaseMeta baseMeta, String resource)
40
+```
41
+
42
+获取指定资源的翻译文本。
43
+
44
+#### 参数:
45
++ `baseMeta`：元模型对象。
46
++ `resource`：资源标识（字段或属性名等）。
47
+
48
+#### 返回:
49
++ `String`：对应语言环境下的翻译文本。
50
+
51
+---
52
+
53
+### `getTranslateEntryChangeCounter()`
54
+```plain
55
+java
56
+
57
+
58
+复制编辑
59
+public static long getTranslateEntryChangeCounter()
60
+```
61
+
62
+获取翻译项变更计数器，用于判断翻译数据是否发生变化。
63
+
64
+#### 返回:
65
++ `long`：变更次数。
66
+
67
+---
68
+
69
+### `getTranslateEntryMap()`
70
+```plain
71
+java
72
+
73
+
74
+复制编辑
75
+public static Map<String, TranslateEntry> getTranslateEntryMap()
76
+```
77
+
78
+获取所有翻译内容的映射表（只读）。
79
+
80
+#### 返回:
81
++ `Map<String, TranslateEntry>`：翻译项只读映射表。
82
+
83
+---
84
+
85
+### `remove(List<String> ids)`
86
+```plain
87
+java
88
+
89
+
90
+复制编辑
91
+public static void remove(List<String> ids)
92
+```
93
+
94
+根据 ID 列表移除翻译项。
95
+
96
+#### 参数:
97
++ `ids`：待移除的翻译项 ID 列表。
98
+
99
+---
100
+
101
+### `batchRegisterGlobalTranslate(List<TranslateEntry> translateEntryList)`
102
+```plain
103
+java
104
+
105
+
106
+复制编辑
107
+public static void batchRegisterGlobalTranslate(List<TranslateEntry> translateEntryList)
108
+```
109
+
110
+批量注册全局翻译项。
111
+
112
+#### 参数:
113
++ `translateEntryList`：翻译项对象列表。
114
+
115
+---
116
+
117
+### `setDefaultLanguage(Locale locale)`
118
+```plain
119
+java
120
+
121
+
122
+复制编辑
123
+public static void setDefaultLanguage(Locale locale)
124
+```
125
+
126
+设置默认的语言环境。
127
+
128
+#### 参数:
129
++ `locale`：Java 的语言环境对象，如 `Locale.CHINA`、`Locale.US`。
130
+
131
+---
132
+
133
+### `getDefaultLanguage()`
134
+```plain
135
+java
136
+
137
+
138
+复制编辑
139
+public static Locale getDefaultLanguage()
140
+```
141
+
142
+获取当前默认语言环境。
143
+
144
+#### 返回:
145
++ `Locale`：默认语言设置。
146
+