讲师中心 微信公众号
AI工具推荐 视频效率加速

Struts2 应用中配置与读取自定义属性的完整指南

小涛小哥_5433

小涛小哥_5433

发布时间:2026-03-14 18:51:12

|

391人浏览过

|

来源于php中文网

原创

Struts2 不提供类似 Spring Boot 的 @Value 或 @ConfigurationProperties 原生支持,但可通过 struts.properties、全局资源包(struts.custom.i18n.resources)及自定义 TextProvider 灵活管理应用级配置项(如 applicationId、timeout),兼顾可维护性与安全性。

struts2 不提供类似 spring boot 的 `@value` 或 `@configurationproperties` 原生支持,但可通过 `struts.properties`、全局资源包(`struts.custom.i18n.resources`)及自定义 `textprovider` 灵活管理应用级配置项(如 `applicationid`、`timeout`),兼顾可维护性与安全性。

在 Struts2 中,配置外部化属性的核心思路是将配置视为“本地化资源”(i18n resources)进行加载与解析,而非直接注入字段。这虽与 Spring Boot 的声明式注入风格不同,但通过合理设计,同样能实现类型安全、集中管理和运行时可访问的配置体系。

✅ 推荐方案:使用全局资源包(Global Resource Bundles)

这是最简洁、标准且符合 Struts2 设计哲学的方式,适用于存储非敏感的标识类配置(如 applicationId、api.timeout、service.endpoint 等)。

步骤 1:创建配置文件

新建 src/main/resources/application.properties(或 .properties 格式):

# application.properties
application.id=prod-2024-webapp
api.timeout=30000
thirdparty.service.url=https://api.example.com/v1

⚠️ 注意:.properties 文件不支持 YAML 格式;若需分环境配置,建议通过 Maven Profile 或构建时替换实现,Struts2 本身不内置多环境配置机制。

步骤 2:注册为全局资源包

在 struts.xml 中声明(推荐方式):

<struts>
  <!-- 启用全局资源模式(禁用包级扫描,提升性能) -->
  <constant name="struts.localizedTextProvider" value="global-only" />

  <!-- 指定全局资源文件(支持逗号分隔多个) -->
  <constant name="struts.custom.i18n.resources" value="application" />
</struts>

✅ value="application" 表示加载 application.properties(无需写扩展名),Struts2 会自动按 ClassLoader.getResourceAsStream("application.properties") 查找。

步骤 3:在 Action 中读取配置

所有继承 ActionSupport 的 Action 均可直接调用 getText() 方法获取值(返回 String,需自行转换类型):

public class ApiCallAction extends ActionSupport {
    private String appId;
    private int timeoutMs;

    @Override
    public String execute() throws Exception {
        this.appId = getText("application.id");           // → "prod-2024-webapp"
        this.timeoutMs = Integer.parseInt(getText("api.timeout")); // → 30000

        // 使用配置调用第三方 API...
        return SUCCESS;
    }
}

? 提示:getText(key) 在找不到 key 时默认返回原 key 字符串(如 "application.id"),便于快速发现配置遗漏;可通过重载 getText(key, defaultValue) 提供兜底值。

? 安全性说明:纯标识类属性可安全存放于 properties 文件

  • ✅ 适用场景:applicationId、clientCode、timeout、endpoint URL 等不包含密钥、令牌、密码或私钥的公开/半公开标识信息;
  • ❌ 禁止存放:API Keys、JWT Secrets、Database Passwords、OAuth Client Secrets 等敏感凭证;
  • ✅ 增强建议:
    • 将敏感配置移至 JVM 系统属性(-Dapi.key=xxx)或环境变量,并通过 System.getProperty("api.key") 读取;
    • 结合 Filter 或 Interceptor 实现启动时校验关键配置是否存在;
    • 使用 Maven profiles + resources filtering 实现不同环境打包不同 application.properties。

? 进阶:自定义 TextProvider(按需扩展)

当需要更复杂的配置逻辑(如从数据库、Consul 或加密文件动态加载),可实现自定义 TextProvider:

public class DbBackedTextProvider extends DefaultTextProvider {
    private final ConfigService configService; // 自定义服务

    public DbBackedTextProvider(ConfigService configService) {
        this.configService = configService;
    }

    @Override
    public String getText(String key, String defaultValue, Locale locale) {
        String value = configService.findValueByKey(key);
        return StringUtils.defaultString(value, defaultValue);
    }
}

并在 struts.xml 中注册:

<bean type="com.opensymphony.xwork2.TextProvider" 
      name="dbTextProvider" 
      class="com.example.DbBackedTextProvider" 
      scope="singleton" />
<constant name="struts.localizedTextProvider" value="dbTextProvider" />

✅ 总结对比表

特性 Spring Boot (@Value) Struts2(推荐方案)
配置文件 application.properties / application.yml application.properties(需注册为 i18n resource)
注入方式 字段级注解(@Value("${key}")) Action 内 getText("key") 调用
类型转换 自动(支持 int, boolean, Duration 等) 需手动解析(Integer.parseInt() 等)
多环境支持 原生(application-dev.yml) 需构建时处理(Maven profiles / CI 变量替换)
敏感信息防护 支持 @ConfigurationProperties + @Validated 强烈建议分离敏感项至系统属性/环境变量

掌握这一模式,你就能在 Struts2 项目中构建清晰、可维护、符合框架规范的配置管理体系——无需引入额外依赖,也无需违背 MVC 分层原则。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
struts框架介绍
struts框架介绍

本专题介绍了struts框架相关内容,阅读专题下面的文章了解更多详细内容。

4057

2025.08.06

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

80

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

60

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

220

2026.10.28

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

140

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

120

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

80

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

60

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

80

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn