ホームページ  >  記事  >  Java  >  プロパティ構成の詳細な紹介

プロパティ構成の詳細な紹介

零下一度
零下一度オリジナル
2017-07-26 11:13:582244ブラウズ

SpringBoot ではほとんどの手動構成が不要になりますが、特定の状況では依然として手動構成を実行する必要があります。SpringBoot は application.properties 構成ファイルを提供するため、3 番目のものも含め、特定の運用状況に合わせてデフォルト構成をカスタマイズできます。もちろんパーティー構成も。ほとんどすべての設定は application.peroperties ファイルに書き込むことができ、SpringBoot によって自動的にロードされるため、手動でロードする手間が省けます。しかし実際には、構成ファイルをカスタマイズする場合、手動でロードする必要があることが多く、SpringBoot はこれらのファイルを自動的に認識しません。

1. 設定ファイルの形式

SpringBoot は、yml ファイルとプロパティ ファイルの 2 つの形式を認識できます。application.properties ファイルを SpringBoot で自動的に識別してロードできます。 , ただし、カスタム設定ファイルの場合は、SpringBoot が yml 形式ファイルを手動で読み込む機能 (ここではアノテーション方式を指します) をまだ提供していないため、プロパティ形式ファイルを使用するのが最善です。

SpringBoot によって自動的にロードされるようにするには、application.properties 構成ファイルを指定された場所 (src/main/resource ディレクトリ) に配置する必要があります。通常、カスタマイズされた構成ファイルもこのディレクトリに配置されます。

2. 設定ファイルのロード

ロードとは、ファイルを Spring コンテナに読み込むことを意味し、アクセスできるように各設定項目を Spring コンテキスト コンテナにロードすることを意味します。

application.properties 設定ファイルは、SpringBoot プロジェクトの開始時に自動的にロードされ、その内部関連設定は SpringBoot のデフォルトの対応する設定を自動的にオーバーライドし、すべての設定項目は Spring コンテナに保存されます。

1-パブリック設定ファイル: application.properties

1 donghao.name=唯一浩哥2 donghao.sex=男3 donghao.age=80

カスタマイズされた xxx.properties 設定ファイルは SpringBoot によって自動的にロードされず、ここでの手動ロードは通常、アノテーション メソッドを指します。今日の重要なポイントの 1 つは、カスタム プロパティ ファイルをロードするためのアノテーションです: @PropertySource("classpath:xxx.properties") このアノテーションは、指定された場所にプロパティ ファイルをロードするために特別に使用されます。Spring はまだロードを提供していません。場所の yml ファイルのアノテーションを指定するため、前のステートメントがあります。

2-カスタム構成ファイル: donghao.properties

1 donghao1.name=动画2 donghao1.sex=女3 donghao1.age=22

  其实无论对于哪里的properties文件,当我们需要使用其中配置内容的时候,就在当前类的顶部加注该注解,将该配置文件加载到内存,这些配置文件一次加载即可多次使用。

3、配置项的使用

  配置项的使用其实很简单,只要是加载到Spring容器中的配置项都可以直接使用@Value("${key}")的方式来引用,一般将其配置在字段顶部,表示将配置项的值赋值给该字段。

  当然更多的情况是将这些配置项与一个JavaBean绑定起来使用,这样绑定一次,我们就可以随时使用。这里涉及到两种情况,一种是将application.properties中的配置与JavaBean绑定,一种是将自定义配置文件中的配置与Javabean绑定。

  第一种:applicaiton.properties属性绑定JavaBean

  这种情况相对简单(因为application.properties文件会被自动加载,也就是说配置项会被自动加载到内存,到Spring容器之中,省去了手动加载的配置),然后我们在要与属性绑定的JavaBean的类定义顶部加@Component注解和@ConfigurationProperties(prefix="key")注解,前者的目的是为了这个JavaBean可以被SpringBoot项目启动时候被扫描到并加载到Spring容器之中,重点是后者,这个注解一般不是单独使用的,他一般与后面要说的@EnableConfigurationProperties(JavaBean.class)配合使用,但是二者并非使用在同一位置,@ConfigurationProperties(prefix="key")注解加注在JavaBean类定义之上,按字面可以理解为属性配置注解,更直接点的说法就是属性绑定注解,官方解释是:如果想要绑定或者验证一些来源自.properties文件中的额外属性时,你可以在一个标注的@Configuration的类的注有@Bean注解的方法或者一个类之上加注这个注解。我们完全可以将其理解为绑定专用注解。它的作用就是将指定的前缀的配置项的值与JavaBean的字段绑定,这里要注意,为了绑定的成功,一般将字段的名称与配置项键的最后一个键名相同,这样整个键在去掉前缀的情况下就和字段名称一致,以此来进行绑定。

  第二种:自定义配置的属性绑定JavaBean

  这种情况与之前的基本相同,只是不能自动加载,需要手动加载,在JavaBean之上加上之前介绍的@PropertySource注解进行配置文件加载。还有一点就是将@Component改为@Configuration,为什么这么做呢?

  @Configuration注解的底层就是@Component,但是二者意义不同,@Configuration注解侧重配置之意,@Component侧重组件之意,当然配置也是项目组件之一,在这里我们要将配置文件属性与JavaBean绑定,当然更侧重配置之意。

  将配置与JavaBean绑定之后,我们就可以通过JavaBean来获取配置的内容,而且JavaBean已经被@Component注解或者@Configuration注解加载到Spring容器,我们可以使用自动注入的方式在其他类中随便使用。

  这里要注意一点:当我们在某个类中要使用这个JavaBean时,需要在这个类中指定这个JavaBean的类型,这个指定也要使用注解来制定,正是之前介绍的@EnableConfigurationProperties注解,这个注解与@ConfigurationProperties注解配套使用。官方给出的解释:这个注解是对@ConfigurationProperties的有效支持。标注有@ConfigurationProperties注解的Beans可以被使用标准的方式注册(使用@Bean注解),或者,为了方便起见,直接用使用@EnableConfigurationProperties指定注册。意思是这个注解提供了一种方便直接的注册Bean的方式。

3-绑定JavaBean:Donghao.java

 1 package com.donghao.model; 2  3 import org.springframework.boot.context.properties.ConfigurationProperties; 4 import org.springframework.context.annotation.Configuration; 5 import org.springframework.context.annotation.PropertySource; 6  7 @Configuration 8 @PropertySource("classpath:donghao.properties") 9 @ConfigurationProperties(prefix="donghao1")10 public class Donghao {11     private String name;12     private String sex;13     private String age;14     public String getName() {15         return name;16     }17     public void setName(String name) {18         this.name = name;19     }20     public String getSex() {21         return sex;22     }23     public void setSex(String sex) {24         this.sex = sex;25     }26     public String getAge() {27         return age;28     }29     public void setAge(String age) {30         this.age = age;31     }32 }

4-定义控制器:DonghaoController

 1 package com.donghao.controller; 2  3 import org.springframework.beans.factory.annotation.Autowired; 4 import org.springframework.beans.factory.annotation.Value; 5 import org.springframework.boot.context.properties.EnableConfigurationProperties; 6 import org.springframework.web.bind.annotation.RequestMapping; 7 import org.springframework.web.bind.annotation.RestController; 8  9 import com.donghao.model.Donghao;10 11 @RestController12 @RequestMapping("/donghao")13 @EnableConfigurationProperties(Donghao.class)14 public class DonghaoController {15     16     @Autowired17     Donghao donghao;18     19     @Value("${donghao.name}")20     private String name;21     22     @Value("${donghao.sex}")23     private String sex;24     25     @Value("${donghao.age}")26     private String age;27 28     29     @RequestMapping("/hello")30     public String hello(){31         return "我的名字叫"+name+",我是"+sex+"生,今年"+age+"岁了!";32     }33     34     @RequestMapping("/ss")35     public String ss(){36         return donghao.getName()+donghao.getSex()+donghao.getAge();37     }38 }

5-定义启动入口类:DonghaoApplication.java

 1 package com.donghao; 2  3 import org.springframework.boot.SpringApplication; 4 import org.springframework.boot.autoconfigure.SpringBootApplication; 5  6 @SpringBootApplication 7 public class DonghaoApplication { 8  9     public static void main(String[] args) {10         11         SpringApplication.run(DonghaoApplication.class, args);12         13     }14 15 }

プログラムを開始した後、ブラウザは http://localhost:8080/donghao/hello にアクセスし、結果は次のようになります。

ブラウザは http://localhost:8080/donghao/ss にアクセスします

私 ここで強調しておきたいのは、ロードと使用は関連していないということです。ロードの目的は使用することですが、ロードと使用には強い関連性がありません。ロードすることはできますが、実用的ではないため、ロードのプロセスを比較する必要があります。使用されるプロセスは個別に分析されます。これらのアノテーションは相互に強い関連性を持ちません。カスタム構成ファイルをロードするだけの場合は、1 つの @PropertySource アノテーションだけで十分です。注釈を使用する必要がある場合は、さまざまな使用方法を選択できます。この注釈は直接代入するために使用します。 Springコンテナに属性設定の値を指定したフィールドに代入する方法ももちろんあります。

もう 1 つの注意点は、パブリック構成ファイル application.properties とカスタム構成ファイル xxx.properties で同じ構成項目に異なる値を構成しないでください。パブリック構成ファイルの優先順位が最も高く、独自の設定ファイルを上書きします。このようにして、パブリック設定ファイル内の特定の設定が起動時に Spring コンテナに読み込まれ、その後、同じ名前の設定項目が読み込まれます。別のカスタム構成ファイルでは 2 つの値が異なりますが、システムは 2 つの優先順位をチェックし、高い方が残り、低い方が退席し、最終的にカスタム構成ファイル内の値は無効になります。

以上がプロパティ構成の詳細な紹介の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

声明:
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。