【Java后端】Spring Boot 全局域名替换
写一个 Spring Boot 全局域名替换 Demo,可以直接跑起来验证。
📂 项目结构
springboot-global-domain-demo├── src/main/java/com/example/demo│ ├── DemoApplication.java│ ├── config/AppProperties.java│ └── controller/TestController.java└── src/main/resources└── application.yml
⚙️ 配置文件 application.yml
server:port: 8081app:base-domain: https://api.example.comservices:user: ${app.base-domain}/userorder: ${app.base-domain}/order
🛠️ 配置类 AppProperties.java
package com.example.demo.config;import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;import java.util.Map;@Component
@ConfigurationProperties(prefix = "app")
public class AppProperties {private String baseDomain;private Map<String, String> services;public String getBaseDomain() {return baseDomain;}public void setBaseDomain(String baseDomain) {this.baseDomain = baseDomain;}public Map<String, String> getServices() {return services;}public void setServices(Map<String, String> services) {this.services = services;}
}
🌐 控制器 TestController.java
package com.example.demo.controller;import com.example.demo.config.AppProperties;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class TestController {private final AppProperties appProperties;public TestController(AppProperties appProperties) {this.appProperties = appProperties;}@GetMapping("/test")public String test() {String userUrl = appProperties.getServices().get("user");String orderUrl = appProperties.getServices().get("order");return "User API: " + userUrl + " | Order API: " + orderUrl;}
}
🚀 启动类 DemoApplication.java
package com.example.demo;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class DemoApplication {public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}
}
🔍 运行结果
启动应用后访问:
http://localhost:8081/test
返回结果:
User API: https://api.example.com/user | Order API: https://api.example.com/order
这样你只需要在 application.yml
改一处:
app.base-domain=https://api.newdomain.com
所有地方就会自动替换。
那么问题来了?现在这样使用的话,全局每个Controller类里都需要注入这个AppProperties
,不优雅。
如果每个 Controller
都要用 AppProperties
,那就意味着每个类都要注入一遍。这样虽然符合 Spring 的依赖注入设计,但确实会有点麻烦。
有几种 只需要注入一次,全局就能用 的做法👇:
✅ 方案一:静态常量 + @PostConstruct
在 AppProperties
初始化时,把值放到静态变量里,所有类直接静态调用。
@Component
@ConfigurationProperties(prefix = "app")
public class AppProperties {private String baseDomain;public String getBaseDomain() {return baseDomain;}public void setBaseDomain(String baseDomain) {this.baseDomain = baseDomain;}// 静态变量,供全局调用public static String BASE_DOMAIN;@PostConstructpublic void init() {BASE_DOMAIN = baseDomain;}
}
使用:
String url = AppProperties.BASE_DOMAIN + "/user";
👉 好处:所有类都能直接访问,不需要注入。
👉 缺点:静态变量属于硬编码,测试/Mock 不方便。
✅ 方案二:封装成工具类(推荐一点)
新建一个工具类,注入一次配置,然后全局静态访问。
@Component
public class DomainHolder {private static String baseDomain;@Value("${app.base-domain}")public void setBaseDomain(String baseDomain) {DomainHolder.baseDomain = baseDomain;}public static String getBaseDomain() {return baseDomain;}
}
使用:
String url = DomainHolder.getBaseDomain() + "/order";
✅ 方案三:利用 Spring 的 Environment
Spring Boot 本身有个 Environment
,可以随时取配置:
@Autowired
private Environment env;public void test() {String baseDomain = env.getProperty("app.base-domain");System.out.println(baseDomain);
}
如果不想每个地方都注入,可以同样封装成静态工具类:
@Component
public class EnvUtils {private static Environment environment;@Autowiredpublic void setEnvironment(Environment env) {EnvUtils.environment = env;}public static String get(String key) {return environment.getProperty(key);}
}
使用:
String url = EnvUtils.get("app.base-domain") + "/user";
⚡ 总结
- 如果配置只在少量地方用:直接注入
AppProperties
更优雅。 - 如果几乎所有 Controller 都要用:推荐 方案二(DomainHolder 工具类),写法简洁,还支持占位符。
- 如果想最大灵活:用
Environment
封装成工具类。
要不要我帮你写一个 方案二的完整 Demo,这样所有 Controller 里就不用再注入了?