From 541e397ca6c8a57e9fd2475ce4ddfa68dd2b706e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Sat, 5 Sep 2026 00:21:27 +0800
Subject: [PATCH] =?UTF-8?q?task-208:=20JavaApiResponse=20=E5=8C=85?=
 =?UTF-8?q?=E8=A3=85=E5=A5=91=E7=BA=A6=EF=BC=88=E5=89=8D=E7=AB=AF=20node?=
 =?UTF-8?q?=20--test=EF=BC=9Asuccess/message/data=20=E8=A7=A3=E5=8C=85?=
 =?UTF-8?q?=E3=80=81=E5=A4=B1=E8=B4=A5=E6=8A=9B=20message=E3=80=81null=20d?=
 =?UTF-8?q?ata=E3=80=81=E5=A4=9A=E4=BD=99=E5=AD=97=E6=AE=B5=E5=AE=B9?=
 =?UTF-8?q?=E5=BF=8D=E3=80=81LegacyApiSuccess(msg)=20=E5=85=BC=E5=AE=B9?=
 =?UTF-8?q?=E3=80=81extractErrorMessage=20=E5=90=84=E5=AD=97=E6=AE=B5?=
 =?UTF-8?q?=E5=9B=9E=E9=80=80=EF=BC=89+=208=20=E6=9D=A1=E6=B5=8B=E8=AF=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../tests/contract-java-response.test.ts      | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 frontend-vue/tests/contract-java-response.test.ts

diff --git a/frontend-vue/tests/contract-java-response.test.ts b/frontend-vue/tests/contract-java-response.test.ts
new file mode 100644
index 00000000..9f43e0e9
--- /dev/null
+++ b/frontend-vue/tests/contract-java-response.test.ts
@@ -0,0 +1,63 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { AxiosError } from 'axios'
+import {
+  unwrapJavaResponse,
+  extractErrorMessage,
+  type JavaApiResponse,
+  type LegacyApiSuccess,
+} from '../src/shared/api/http.ts'
+
+/** task-208：JavaApiResponse 包装契约（success/message/data）+ LegacyApiSuccess(msg) 兼容。 */
+
+test('java success shape unwraps to data', async () => {
+  const response: JavaApiResponse<number> = { success: true, message: 'ok', data: 42 }
+  assert.equal(await unwrapJavaResponse(Promise.resolve(response)), 42)
+})
+
+test('java failure shape throws message', async () => {
+  const response: JavaApiResponse<never> = { success: false, message: '系统错误', data: null }
+  await assert.rejects(unwrapJavaResponse(Promise.resolve(response)), /系统错误/)
+})
+
+test('java failure without message defaults to 请求失败', async () => {
+  const response: JavaApiResponse<never> = { success: false, message: '', data: null }
+  await assert.rejects(unwrapJavaResponse(Promise.resolve(response)), /请求失败/)
+})
+
+test('null data does not throw on success', async () => {
+  const response: JavaApiResponse<null> = { success: true, message: 'ok', data: null }
+  assert.equal(await unwrapJavaResponse(Promise.resolve(response)), null)
+})
+
+test('extra fields are tolerated', async () => {
+  const response = { success: true, message: 'ok', data: 7, extraField: 'x', another: true }
+  assert.equal(await unwrapJavaResponse(Promise.resolve(response)), 7)
+})
+
+test('legacy success shape keeps msg-compatible fields', () => {
+  const legacy: LegacyApiSuccess<string> = { success: true, msg: 'legacy-ok', data: 'v' }
+  assert.equal(legacy.success, true)
+  assert.ok('msg' in legacy && 'data' in legacy, 'LegacyApiSuccess 应含 msg/data')
+})
+
+test('extractErrorMessage reads error field first', () => {
+  const err = new AxiosError('http', undefined, undefined, undefined,
+    { status: 500, data: { error: 'E1', message: 'M', msg: 'm' } } as never)
+  assert.equal(extractErrorMessage(err), 'E1')
+})
+
+test('extractErrorMessage falls back to message/msg/string/generic', () => {
+  const withMessage = new AxiosError('http', undefined, undefined, undefined,
+    { status: 500, data: { message: 'M', msg: 'm' } } as never)
+  assert.equal(extractErrorMessage(withMessage), 'M')
+  const withMsg = new AxiosError('http', undefined, undefined, undefined,
+    { status: 500, data: { msg: 'm' } } as never)
+  assert.equal(extractErrorMessage(withMsg), 'm')
+  const stringBody = new AxiosError('http', undefined, undefined, undefined,
+    { status: 500, data: 'plain-body' } as never)
+  assert.equal(extractErrorMessage(stringBody), 'plain-body')
+  const messageOnly = new AxiosError('boom')
+  assert.equal(extractErrorMessage(messageOnly), 'boom')
+  assert.equal(extractErrorMessage(null), '请求失败')
+})