From 34981c30a78e8bbd7791131059a9210f9928b62c Mon Sep 17 00:00:00 2001
From: 刘光辉 <347230014@qq.com>
Date: 星期四, 17 九月 2026 09:24:09 +0800
Subject: [PATCH] Merge remote-tracking branch 'origin/master' into master
---
jnpf-biz-common/jnpf-biz-common-onlyoffice/src/main/java/jnpf/bizcommon/onlyoffice/service/OnlyOfficeService.java | 43 +++++++++++++++++++++++++++++++++++++++++++
1 files changed, 43 insertions(+), 0 deletions(-)
diff --git a/jnpf-biz-common/jnpf-biz-common-onlyoffice/src/main/java/jnpf/bizcommon/onlyoffice/service/OnlyOfficeService.java b/jnpf-biz-common/jnpf-biz-common-onlyoffice/src/main/java/jnpf/bizcommon/onlyoffice/service/OnlyOfficeService.java
new file mode 100644
index 0000000..d5023f0
--- /dev/null
+++ b/jnpf-biz-common/jnpf-biz-common-onlyoffice/src/main/java/jnpf/bizcommon/onlyoffice/service/OnlyOfficeService.java
@@ -0,0 +1,43 @@
+package jnpf.bizcommon.onlyoffice.service;
+
+import jnpf.bizcommon.onlyoffice.entity.OnlyOfficeCallbackParam;
+import jnpf.bizcommon.onlyoffice.entity.OnlyOfficeConfigParam;
+
+import java.util.Map;
+
+/**
+ * OnlyOffice 鏂囨。缂栬緫鑳藉姏銆�
+ * 鏂规瑙� {@code tasks/onlyoffice-integration-plan.md}銆�
+ */
+public interface OnlyOfficeService {
+
+ /**
+ * 绛惧彂缂栬緫鍣� config锛堝惈 HS256 JWT锛夛紝鍓嶇鎷垮幓鍠� {@code new DocsAPI.DocEditor(id, config)}銆�
+ *
+ * <p>杩囩▼涓細钀藉簱/鏇存柊缂栬緫浼氳瘽锛屽苟鍋氱紪杈戦攣鍒ゅ畾鈥斺�斿凡鏈変粬浜哄湪缂栬緫鏃堕檷绾т负鍙锛�
+ * 鍥犱负 DS 鐨勯粯璁よ涓烘槸鍚� docKey 鑷姩鍗忓悓锛岃�屽崗鍚屼笉鍦ㄦ湰鏈熻寖鍥淬��
+ *
+ * @param param 鏂囦欢涓庝笟鍔′笂涓嬫枃
+ * @return 鍙洿鎺ュ簭鍒楀寲缁欏墠绔殑 config
+ */
+ Map<String, Object> buildEditorConfig(OnlyOfficeConfigParam param);
+
+ /**
+ * 鏌ヨ鏂囦欢鏈�杩戜竴娆＄敱 Document Server 鎴愬姛鍐欏洖鐨勭姸鎬併��
+ *
+ * @param fileId jnpf-file 鏂囦欢鏍囪瘑
+ * @return version 涓� lastSaveTime锛堟绉掓椂闂存埑锛�
+ */
+ Map<String, Object> getSaveStatus(String fileId);
+
+ /**
+ * 澶勭悊 DS 鐨勪繚瀛樺洖璋冦��
+ *
+ * <p>璇ョ鐐瑰湪缃戝叧鐧藉悕鍗曞唴锛堝钩鍙拌ˉ涓� #9锛夛紝鍖垮悕鍙揪锛寋@code authorization} 鐨勯獙绛�
+ * 鏄敮涓�鐨勫畨鍏ㄨ竟鐣岋紝楠屼笉杩囧繀椤绘姏寮傚父鑰屼笉鏄檷绾ф斁杩囥��
+ *
+ * @param param 鍥炶皟浣�
+ * @param authorization Authorization 澶村師鏂囷紙褰㈠ {@code Bearer xxx}锛�
+ */
+ void handleCallback(OnlyOfficeCallbackParam param, String authorization);
+}
--
Gitblit v1.8.0