龙空技术网

SpringBoot(二) - 核心配置文件

Java码农之路 900

前言:

如今各位老铁们对“java参数文件”大致比较讲究,大家都想要剖析一些“java参数文件”的相关资讯。那么小编也在网摘上收集了一些有关“java参数文件””的相关资讯,希望小伙伴们能喜欢,我们快快来了解一下吧!

1、application.properties 和 application.yml 配置文件格式区别1.1 文件格式

application.properties

# 端口号server.port=8096

application.yml

# 服务端口server:  port: 8096
1.2 区别properties的优先级高于yml,同等配置,高优先级会覆盖低优先级,不同的配置时互补配置(增补,不管哪个配置文件中有,都可以生效);properties的核心语法是:通过 . 作为层级分隔符,配置值是用 = ,比如 server.port=9096

yml的核心语法是:通过层级+缩进的方式,同一给等级,缩进是相同的,配置使用key: value方式server:

port: 8096 #注意值前面必须有空格小结:yml格式配置,可以简化配置内容,层次清晰,更适合作为核心配置文件;2、自定义配置2.1 配置信息 yml 语法

注意:值前面必须有空格;

2.1.1 基本类型数据

user:  userId: kh96  user-Name: gala # 支持松散绑定  user_age: 17  adult: true # 是否成年  salary: 9696.0  userTel: 13501020304  birthday: 2002/10/11 10:10:10  email: kh96@163.com
2.1.2 数组,List,Set
user:	hobbies:    # 爱好 list集合        - springboot        - linux        - mysql        - ssm        - jvaweb        - springvloud    #行内写法    #hobbies:[springboot,linux,mysql,ssm,jvaweb,springvloud]
2.1.3 Map
user:	carMap:   # 爱车 map 集合        bnm: 宝马325        audi: 奥迪A41        benz: 奔驰C200    #行内写法    #carMap:{bnm: 宝马325;audi: 奥迪A41;benz: 奔驰C200}
2.1.4 实体参数
user:    userRole:        role-id: R96 ${random.uuid} #${}可以去一些内置的自定义参数        role_name: root
2.1.5 值的写法2.1.5.1 单引号:

会转义特殊字符。

user:	msg: '你好!\n小可爱!'

输出:

你好!\n小可爱!
2.1.5.2 双引号:

不会转义字符里的特殊字符,特殊字符仍然是本身的意思

user:	msg: "你好!\n小可爱!"

输出:

你好!小可爱!
2.2 获取 配置信息2.2.1 批量自动读取

使用注解@ConfigurationProperties(prefix = "xxx") ,必须配合@Component 注解获取在核心启动类上使用 @EnableConfigurationProperties(配置属性读取类.class)使用;

特点:支持松散绑定(可以自动识别驼峰,-,_),支持复杂类型绑定(实体,集合-list,set,array,map等),支持数据格式校验;

@Component + @ConfigurationProperties(prefix = "user")    或@Component+@EnableConfigurationProperties(UserProperties.class) //写在主启动类上
2.2.1.1UserProperties
@Data@Component //第一个写法,使用普通组件@ConfigurationProperties(prefix = "user")  //不能单独使用,必须配合@EnableConfigurationProperties 或指定为spring容器中的普通组件public class UserProperties {        //用户编号    private String userId;    //用户名    private String userName;    //用户年龄    private Integer userAge;    //是否成年    private boolean adult;    //工资    private  double salary;    //联系方式    private String userTel;    //生日     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GMT+8") //springMVC将将数据转成json格式,时间格式规则    private Date birthday;    //用户角色     private UserRole userRole; //实体参数    //爱好    private List<String> hobbies;    //爱车    private Map<String,String> carMap;    //邮箱    @Email //邮箱格式校验    private String email;}
2.2.1.1.2 运行结果:2.2.2 单个手动读取

用法:使用注解@Value("${xxx.xxx}");

特点:写法灵活,可以指定默认值等,但是不支持松散绑定,单个读取的配置要求指定的读取属性key必须和自定义配置一直,否者报错;

@Component + @ConfigurationProperties(prefix = "user")
2.2.2.1 UserProperties
@Data@Component@PropertySource(value = "classpath:user.properties")//@EnableConfigurationProperties(UserProperties.class) //第二种方式,核心启动类上,增加指定开启自动配置读取,但是一般不怎么使用,且容易忘记public class UserProperties {        //用户编号    @Value("${user.userId}")    private String userId;    //用户名    @Value("${user.user-Name}")    private String userName;        //昵称	@Value("#{userValues.userName}") //获取的是容器中已有的实体的值	//@Value("#{'xiaoming'}") //可以赋默认值    private String niceName;    //用户年龄        @Value("${user.user_age}")//    @Value("16") //直接赋值    private Integer userAge;    //是否成年    @Value("#{(${user.user_age}>17)?true:false}") //spel 表达式    private boolean adult;    //工资    @Value("#{${user.salary}*10}")  //#{} 和 ${}套用    private  double salary;    //联系方式    @Value("${user.userTel}")    private String userTel;    //生日     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GMT+8") //springMVC将将数据转成json格式,时间格式规则    @Value("${user.birthday}")    private Date birthday;    //用户角色     //@Value("${user.userRole}")  //不可以单个手动获取石参数    private UserRole userRole; //实体参数    //爱好    //@Value("${user.hobbies}") //不可以单个手动获取复杂参数    private List<String> hobbies;    //爱车    //@Value("${user.carMap}")    private Map<String,String> carMap;    //邮箱    @Email //邮箱格式校验    @Value("${user.email:abc@kgc.com}") //添加默认值,配置信息没有就使用默认值    private String email;}
2.2.2.2运行结果:2.2.3 ${} 和 #{} 的区别${}:用于读取核心配置文件中的自定义配置,也可以给属性指定默认值 (${xxx.xx:default值});#{}:不可以读取核心配置文件中的自定义配置,可以给属性发指定默认值#{default值} (可以使用表达式),还可以读取容器中已用实体的属性值;两种读取自定义配置的方式,是可以混用的,但是实际开发中,尽量使用其中一种,,一般都是少量配置,单个读取,多个读取,使用批量读取;3、自定义配置文件并获取配置信息3.1xxx.properties3.1.1 student.properties
student.studentId=19130010student.studentName=huayustudent.studentClass=计算机科学与技术(2)student.graduationSchool=金陵科技学院student.graduationTime=2023/7/1 12:12:12student.nativePlace=南京student.hasGirFriends=true
3.1.2 StudentProperties.java
@Data@Component @ConfigurationProperties(prefix = "student")  public class StudentProperties {    // 学号    private String studentId;    // 姓名    private String studentName;    // 班级    private String studentClass;    // 毕业院校    private String graduationSchool;    // 毕业时间    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GMT+8")    private Date graduationTime;    // 籍贯    private String nativePlace;    // 有没有女朋友    private boolean hasGirFriends;}
3.1.3 StudentValues.java
@Data@Component //第一个写法,使用普通组件@PropertySource(value = "classpath:student.properties")//单个从student.properties 中获取参数public class StudentValues {    // 学号    @Value("${student.studentId}")    private String studentId;    // 姓名    @Value("${student.studentName}")    private String studentName;    // 班级    @Value("${student.studentClass}")    private String studentClass;    // 毕业院校    @Value("${student.graduationSchool}")    private String graduationSchool;    // 毕业时间    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GMT+8")    @Value("${student.graduationTime}")    private Date graduationTime;    // 籍贯    @Value("${student.nativePlace}")    private String nativePlace;    // 有没有女朋友    @Value("${student.hasGirFriends}")    private boolean hasGirFriends;}
3.2 xxx.yml3.2.1 student.yml
student:  studentId: 19130010  studentName: huayu  studentClass: 计算机科学与技术(2)  graduationSchool: 金陵科技学院  graduationTime: 2023/7/1 12:12:12  nativePlace: 南京  hasGirFriends: true
3.2.2 StudentProperties.java
@Data@Component@ConfigurationProperties(prefix = "student") @PropertySource(value = "classpath:student.yml",encoding = "utf-8",factory = YamlPropertySourceFactory.class) //从自定义的 student.yml 中获取public class StudentProperties {......}
3.2.3 StudentValues.java
@Data@Component @PropertySource(value = "classpath:my.yml", factory = YamlPropertySourceFactory.class) //从自定义的 student.yml 中获取public class StudentValues {......}
3.2.4 YamlPropertySourceFactory.java yml配置映射类

@PropertySource读取不能直接自定义yaml配置文件,需要自定义一个继承 PropertySourceFactory 的 YamlPropertySourceFactory 编写配置映射类

public class YamlPropertySourceFactory implements PropertySourceFactory {    @Override    public PropertySource<?> createPropertySource(String name, EncodedResource encodedResource) {        Resource resource = encodedResource.getResource();        YamlPropertiesFactoryBean factory = new YamlPropertiesFactoryBean();        factory.setResources(resource);        Properties props = factory.getObject();        return new PropertiesPropertySource(resource.getFilename(), props);    }}
3.3 测试3.3.1 testStudentProperties3.3.2 testStudentValues4、*@Configuration配置类的用法,可以实现自定义组件加入容器4.1 实体
@Data@Builder@AllArgsConstructor@NoArgsConstructorpublic class UserRole {    //角色    private String roleId;    //角色名称    private String roleName;}
4.2 UserRoleConfig 配置类
@Configuration //凡是被此注解修饰的类,就是一个配置类,在项目启动是,自动加载,功能跟spring的核心配置文件xml文件是同等的public class UserRoleConfig {    //手动添加自定义对象,放入容器中以前spring框架,通过xml配置文件,添加<bean id="xx" class="xx">...</bran>    @Bean //标注的方法,会自动将当前方法返回的实例对象放入容器中,默认的bean的id值就是方法名    public UserRole userRole1(){        return UserRole.builder()                .roleId("R001")                .roleName("admin")                .build();    }    @Bean    public UserRole userRole2(){        return UserRole.builder()                .roleId("R002")                .roleName("admin")                .build();    }}
4.3 测试类
@RestControllerpublic class SpringBootConfigController {    @Autowired    @Qualifier("userRole2")    UserRole userRole;        //可以实现自定义实体加入容器    @GetMapping("/testUserRole")    public UserRole testUserRole(){        return userRole;    }}    

运行结果:

5、激活环境5.1 多套环境配置文件

激活环境 (实际开发中,主要有三个环境:开发环境,测试环境,生产环境(线上环境),还有一个环境,灰度环境,也是线上环境,叫预上限环境);

好处:可以隔离不同环境的不同配置,需要使用哪个环境,就直接切换核心配置文件;

application-devp.propertiesapplication-prod.propertiesapplication-test.properties
5.2 激活环境

active: test # 指定当前的profiles值,环境是什么是通过核心配置文件名中,application-${profiles},profiles写的是什么就是什么环境;

spring:  profiles:    active: test  #激活测试环境
6、核心配置文件加载位置
优先级从高到底依次为:    项目根路径下的config目录    项目根路径下    类路径(resource)下的    类路径(resource)下

注意:模块项目的 项目根路径 是 父项目的根路径;

7、邮件发送 和 短信测试发送7.1 邮件发送7.1.1 依赖

<!--   spring-boot-starter-mail start  --><dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-mail</artifactId></dependency><!--   spring-boot-starter-mail end  -->
7.1.2 邮件配置信息7.1.3 类里面写配置信息

配置信息直接写在 对象里面;

@GetMapping("/sendEmail")public String sendEmail(@RequestParam(value = "setToEmail",required = false) String setToEmail){    System.out.println("--------------[mail/mailSend] start------------------");    try {        MimeMessage message=javaMailSender.createMimeMessage();        MimeMessageHelper helper=new MimeMessageHelper(message,true);        helper.setFrom("2663092414@qq.com","2663092414");        helper.setTo(setToEmail);        helper.setSubject("KH-96-王松—核心配置文件读取");        helper.setText("正在使用SpringBoot读取自定义核心配置,发送邮件成功!<br/>"+studentProperties.toString(),true);        javaMailSender.send(message);    } catch (Exception e) {        System.out.println("邮件发送失败"+ e.getMessage());        e.printStackTrace();    }    System.out.println("--------------[mail/mailSend] end------------------");    return studentProperties.toString();}//实例化javaMailSender 并写入配置信息private static JavaMailSenderImpl javaMailSender;static {    javaMailSender = new JavaMailSenderImpl();    javaMailSender.setHost("smtp.qq.com");//链接服务器    //javaMailSender.setPort(25);//默认使用25端口发送    javaMailSender.setUsername("2663092414@qq.com");//账号    javaMailSender.setPassword("dwxlbkrmdyagebhe");//授权码    javaMailSender.setDefaultEncoding("UTF-8");    Properties properties = new Properties();    //properties.setProperty("mail.debug", "true");//启用调试    //properties.setProperty("mail.smtp.timeout", "1000");//设置链接超时    //设置通过ssl协议使用465端口发送、使用默认端口(25)时下面三行不需要    properties.setProperty("mail.smtp.auth", "true");//开启认证    properties.setProperty("mail.smtp.socketFactory.port", "465");//设置ssl端口    properties.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");    javaMailSender.setJavaMailProperties(properties);}
7.1.4 application.yaml中写配置信息7.1.4.1 application.yaml
spring:  mail:    default-encoding: UTF-8    host: smtp.qq.com    port: 587    username: xxxxxx@qq.com    password: 授权码
7.1.4.2 请求方法
@GetMapping("/sendEmail2")public String sendEmail2(@RequestParam(value = "setToEmail",required = false) String setToEmail){    SimpleMailMessage mailMessage = new SimpleMailMessage();    mailMessage.setFrom("xxxxxx@qq.com"); //发送邮箱    mailMessage.setTo("xxxxxx@qq.com"); //目标邮箱    mailMessage.setText("你好 hello world");    mailMessage.setSubject("测试 Springboot 邮箱服务");    mailSender.send(mailMessage);    return "====完成发送!====";}
7.2 短信测试发送7.2.1 依赖
<!-- SMS star --><dependency>    <groupId>com.aliyun</groupId>    <artifactId>dysmsapi20170525</artifactId>    <version>2.0.9</version></dependency><dependency>    <groupId>com.aliyun</groupId>    <artifactId>tea</artifactId>    <version>1.1.14</version></dependency><!-- SMS end -->
7.2.2 代码

其中:accessKeyId ,accessKeySecret 填写自己的用户 AccessKey,最好用子用户 AccessKey;

public class Sample {    /**     * 使用AK&SK初始化账号Client     *     * @param accessKeyId     * @param accessKeySecret     * @return Client     * @throws Exception     */    public static com.aliyun.dysmsapi20170525.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()                // 您的 AccessKey ID                .setAccessKeyId(accessKeyId)                // 您的 AccessKey Secret                .setAccessKeySecret(accessKeySecret);        // 访问的域名        config.endpoint = "dysmsapi.aliyuncs.com";        return new com.aliyun.dysmsapi20170525.Client(config);    }    public static void main(String[] args_) throws Exception {        java.util.List<String> args = java.util.Arrays.asList(args_);        com.aliyun.dysmsapi20170525.Client client = Sample.createClient("accessKeyId", "accessKeySecret");  //accessKeyId ,accessKeySecret 填写自己的用户信息                com.aliyun.dysmsapi20170525.models.SendSmsRequest sendSmsRequest = new com.aliyun.dysmsapi20170525.models.SendSmsRequest()                .setSignName("阿里云短信测试")                .setTemplateCode("SMS_154950909")                .setPhoneNumbers("发送短信的手机号")                .setTemplateParam("{\"code\":\"131313\"}");        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();        try {            // 复制代码运行请自行打印 API 的返回值            SendSmsResponse sendSmsResponse = client.sendSmsWithOptions(sendSmsRequest, runtime);        } catch (TeaException error) {            // 如有需要,请打印 error            String errerMsg = Common.assertAsString(error.message);        } catch (Exception _error) {            TeaException error = new TeaException(_error.getMessage(), _error);            // 如有需要,请打印 error            String errorMsg = Common.assertAsString(error.message);        }    }}

标签: #java参数文件