60

I have spring boot client that consumes a restful api. Instead of hardcoding the IP address of the REST API in the java class, is there any key entry in the application.properties I can use?

And if not, can I create a custom entry?

Thanks

4 Answers 4

124

The infrastructure that Spring Boot uses can be used in your own project in the exact same way. You commented in @zmitrok answer about a "unknown property" warning. That is because your property has no meta-data so the IDE does not know about it.

I would strongly advice you not to use @Value if you can as it is rather limited compared to what Spring Boot offers (@Value is a Spring Framework feature).

Start by creating some POJO for your IP:

@ConfigurationProperties("app.foo")
public class FooProperties {

    /**
     * IP of foo service used to blah.
     */
    private String ip = 127.0.0.1;

    // getter & setter
}

Then you have two choices

  1. Put @Component on FooProperties and enable the processing of configuration properties by adding @EnableConfigurationProperties on any of your @Configuration class (this last step is no longer necessary as of Spring Boot 1.3.0.M3)
  2. Leave FooProperties as is and add @EnableConfigurationProperties(FooProperties.class) to any of your @Configuration class which will create a Spring Bean automatically for you.

Once you've done that app.foo.ip can be used in application.properties and you can @Autowired FooProperties in your code to look for the value of the property

@Component
public MyRestClient {

    private final FooProperties fooProperties;

    @Autowired
    public MyRestClient(FooProperties fooProperties) { ... }

    public callFoo() {
       String ip = this.fooProperties.getIp();
       ...
    }

}

Okay so your key is still yellow in your IDE. The last step is to add an extra dependency that will look your code and generate the relevant meta-data at build time. Add the following to your pom.xml

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

And voilà, your key is recognized, you have javadoc and the IDE gives you the default value (the value you initialized on the field). Once you've that you can use any type the conversion service handles (i.e. URL) and the javadoc on the field is used to generate documentation for your keys.

You can also add any JSR-303 constraint validation on your field (for instance a regex to check it's a valid ip).

Check this sample project and the documentation for more details.

8
  • 4
    Wow had no clue about any of this (maybe I should start reading the doc some more), this helped a ton, thank you.
    – Kingamere
    Commented Aug 18, 2015 at 15:04
  • 1
    I followed these steps (opting for option 1 above), but Spring Tool Suite still marks my property as unknown in the application.properties file. There is a quick fix available to create the application metadata, but I assumed the spring-boot-configuration-processor was supposed to remedy that? Commented Aug 24, 2016 at 7:51
  • You'll have to ask the STS team. All I know is that it should work out-of-the-box. There's not much for us to investigate, create another thread with more details please. Commented Aug 24, 2016 at 18:14
  • 2
    @StephaneNicoll : this is an awesome feature i just discover and i want to thank you and the rest of the team for all the work you have done on spring-boot, keep up the good work ;)
    – Y.M.
    Commented Feb 7, 2017 at 19:21
  • I cant argue that this is the right and best way to do it, but just using @zmitrok works just fine as well. Just ignore the yellow warning Commented Aug 1, 2018 at 13:14
23

Instead of hardcoding the IP into the properties file, you can start the application with

-Dmy.property=127.127.10.20

And Spring Boot will automatically pick it up with

@Value("${my.property}")
private String myProperty;
6
  • Where do I add -Dmy.property ?
    – Kingamere
    Commented Aug 17, 2015 at 20:20
  • which IDE do you use? If it's Eclipse: stackoverflow.com/questions/862391/…
    – cahen
    Commented Aug 17, 2015 at 20:21
  • if you're running from the command line, just add it to the end
    – cahen
    Commented Aug 17, 2015 at 20:22
  • ahh ok thanks, and this -Dmy.property and can be added at the end of java -jar my-application.war ?
    – Kingamere
    Commented Aug 17, 2015 at 20:24
  • 1
    this i think is the way to go Commented Feb 28, 2016 at 15:03
5

You can add your own entries to the application.properties. Just make sure that the property name does not clash with the common properties listed at http://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#common-application-properties

2
  • 4
    I see, but when I enter restAPIServiceAddress as an entry it underlines it in yellow and says "is an unkown property", is that okay?
    – Kingamere
    Commented Aug 17, 2015 at 20:16
  • 5
    I just added an answer that explains what that yellow thing means. Commented Aug 18, 2015 at 7:43
0

I was facing the same issue. Since all answers are from 2015, I try to update this topic.

Let's assume, the following is your custom property in application.yml:

custom:
  client: "http://localhost:4200"

You may get the warning

Cannot resolve configuration property 'custom.client'

To fix this, you may need to create the file additional-spring-configuration-metadata.json in resources/META-INF. Once you have done that, add the following into the created file:

{
  "properties": [
    {
      "name": "custom.client",
      "type": "java.lang.String",
      "description": "Client's URL."
  }
] }

The warning should be gone.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.