package cn.lihu.jh.server.ecg;
|
|
import org.springframework.context.annotation.Bean;
|
import org.springframework.context.annotation.Configuration;
|
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
|
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
|
|
/**
|
* 前端静态资源映射（配合"前端打进 jar"的合并部署方案）。
|
*
|
* <h3>作用</h3>
|
* 把 jar 内 {@code META-INF/resources/frontend/} 下的前端构建产物映射到站点根路径。
|
*
|
* <pre>
|
* URL 来源
|
* /assets/index-xxx.js -> classpath:/META-INF/resources/frontend/assets/index-xxx.js
|
* /logo.gif -> classpath:/META-INF/resources/frontend/logo.gif
|
* /favicon.ico -> classpath:/META-INF/resources/frontend/favicon.ico
|
* /static/jquery.min.js -> classpath:/META-INF/resources/frontend/static/jquery.min.js
|
* </pre>
|
*
|
* <h3>⚠ 为什么【不能】用 {@code /**} 通配（重要）</h3>
|
* 初版曾写成 {@code registry.addResourceHandler("/**")}，这是**错误**的：
|
* 一旦把 {@code /**} 指向前端目录，以下后端自带的路径会被静态资源处理器
|
* 抢先匹配，导致静态文件找不到而**直接 404**，控制器不再有机会处理：
|
* <ul>
|
* <li>{@code /doc.html}、{@code /swagger-ui/**}、{@code /v3/api-docs/**}
|
* —— Knife4j / springdoc 接口文档</li>
|
* <li>{@code /druid/**} —— Druid 监控台（其 Servlet 已启用）</li>
|
* <li>{@code /actuator/**} —— Spring Boot 监控端点</li>
|
* <li>{@code /jmreport/**} —— 积木报表（若将来启用）</li>
|
* <li>{@code /admin-api/**} —— 全部业务接口</li>
|
* <li>{@code /profile/**} —— 心电模块
|
* {@code WebConfig} 映射到文件系统上传目录</li>
|
* </ul>
|
* 因此这里改为**显式枚举前端真实存在的资源前缀**，把根路径留给后端自己。
|
*
|
* <h3>前端产物实际包含哪些顶层条目</h3>
|
* 依据 {@code dist-prod} 的实际构建结果：
|
* <pre>
|
* index.html, favicon.ico, logo.gif ← 文件
|
* bigCall.html, smallCall.html ← kiosk 页（建议删除，见部署指南）
|
* assets/ ← 带内容哈希的 js/css/字体/图片
|
* static/ ← jquery、axios、vue 等第三方静态库
|
* </pre>
|
*
|
* <h3>SPA 深层路由的兜底</h3>
|
* 本类**不负责** SPA 兜底（前端用 {@code createWebHistory()}，刷新深层路由
|
* 会 404）。兜底由 {@link SpaForwardController} 显式枚举 5 类页面路径完成，
|
* 这样既修复刷新 404，又不会把后端真实的 404 吞成 index.html。
|
*
|
* @author 心电排队装机系统
|
*/
|
@Configuration
|
public class FrontendResourceConfig implements WebMvcConfigurer {
|
|
/** 前端产物在 jar 内的位置，需与 jh-server/pom.xml 中 targetPath 保持一致 */
|
private static final String FRONTEND_LOCATION = "classpath:/META-INF/resources/frontend/";
|
|
/** 带内容哈希的资源可长缓存（30 天） */
|
private static final long CACHE_HASHED = 3600L * 24 * 30;
|
|
/** 无哈希的根级文件（logo.gif 等）短缓存，避免更新后浏览器不刷新（1 小时） */
|
private static final long CACHE_UNHASHED = 3600L;
|
|
@Override
|
public void addResourceHandlers(ResourceHandlerRegistry registry) {
|
// Vite 产出的带哈希资源目录
|
registry.addResourceHandler("/assets/**")
|
.addResourceLocations(FRONTEND_LOCATION + "assets/")
|
.setCachePeriod((int) CACHE_HASHED);
|
|
// public/ 下原样拷贝的第三方静态库（jquery、axios、vue、element-ui 等）
|
// 这些文件名不含哈希，用短缓存
|
registry.addResourceHandler("/static/**")
|
.addResourceLocations(FRONTEND_LOCATION + "static/")
|
.setCachePeriod((int) CACHE_UNHASHED);
|
|
// 根级静态文件。逐个列出，避免 /doc.html、/druid/** 等被误拦截
|
// 文件名不含哈希，用短缓存
|
registry.addResourceHandler(
|
"/favicon.ico",
|
"/logo.gif",
|
"/logo.png",
|
"/logo0.png")
|
.addResourceLocations(FRONTEND_LOCATION)
|
.setCachePeriod((int) CACHE_UNHASHED);
|
|
// 注意：index.html 不在此处映射。
|
// 它只应通过 SpaForwardController 的 forward:/frontend/index.html 访问，
|
// 避免出现"两个入口都能拿到首页"的歧义。
|
}
|
|
/**
|
* 注册前端免登录规则。
|
* <p>
|
* 必须显式声明为 Bean，框架才会通过
|
* {@code JhWebSecurityConfigurerAdapter} 收集并生效。
|
* 缺少此 Bean 的典型症状：接口都正常，但浏览器打开是白屏
|
* （{@code /logo.gif}、{@code /favicon.ico}、页面路径均返回
|
* {@code 401 账号未登录}）。
|
*
|
* @see FrontendAuthorizeRequestsCustomizer
|
*/
|
@Bean
|
public FrontendAuthorizeRequestsCustomizer frontendAuthorizeRequestsCustomizer() {
|
return new FrontendAuthorizeRequestsCustomizer();
|
}
|
}
|
