<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Spring Boot Reference Guide</title><link rel="stylesheet" type="text/css" href="css/manual-singlepage.css"><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="book"><div class="titlepage"><div><div><h1 class="title"><a name="d0e3"></a>Spring Boot Reference Guide</h1></div><div><div xmlns:d="http://docbook.org/ns/docbook" class="authorgroup"><h2>Authors</h2><span class="author"><span class="firstname">Phillip</span> <span class="surname">Webb</span></span>, <span class="author"><span class="firstname">Dave</span> <span class="surname">Syer</span></span>, <span class="author"><span class="firstname">Josh</span> <span class="surname">Long</span></span>, <span class="author"><span class="firstname">Stéphane</span> <span class="surname">Nicoll</span></span>, <span class="author"><span class="firstname">Rob</span> <span class="surname">Winch</span></span>, <span class="author"><span class="firstname">Andy</span> <span class="surname">Wilkinson</span></span>, <span class="author"><span class="firstname">Marcel</span> <span class="surname">Overdijk</span></span>, <span class="author"><span class="firstname">Christian</span> <span class="surname">Dupuis</span></span>, <span class="author"><span class="firstname">Sébastien</span> <span class="surname">Deleuze</span></span>, <span class="author"><span class="firstname">Michael</span> <span class="surname">Simons</span></span>, <span class="author"><span class="firstname">Vedran</span> <span class="surname">Pavić</span></span>, <span class="author"><span class="firstname">Jay</span> <span class="surname">Bryant</span></span>, <span class="author"><span class="firstname">Madhura</span> <span class="surname">Bhave</span></span></div></div><div><p class="releaseinfo">2.0.0.RELEASE</p></div><div><p class="copyright">Copyright © 2012-2018 </p></div><div><div class="legalnotice"><a name="d0e134" href="htmlsingle.html#d0e134"></a><p>
Copies of this document may be made for your own use and for distribution to
others, provided that you do not charge any fee for such copies and further
provided that each copy contains this Copyright Notice, whether distributed in
print or electronically.
</p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="part"><a href="htmlsingle.html#boot-documentation">I. Spring Boot Documentation</a></span></dt><dd><dl><dt><span class="chapter"><a href="htmlsingle.html#boot-documentation-about">1. About the Documentation</a></span></dt><dt><span class="chapter"><a href="htmlsingle.html#boot-documentation-getting-help">2. Getting Help</a></span></dt><dt><span class="chapter"><a href="htmlsingle.html#boot-documentation-first-steps">3. First Steps</a></span></dt><dt><span class="chapter"><a href="htmlsingle.html#_working_with_spring_boot">4. Working with Spring Boot</a></span></dt><dt><span class="chapter"><a href="htmlsingle.html#_learning_about_spring_boot_features">5. Learning about Spring Boot Features</a></span></dt><dt><span class="chapter"><a href="htmlsingle.html#_moving_to_production">6. Moving to Production</a></span></dt><dt><span class="chapter"><a href="htmlsingle.html#_advanced_topics">7. Advanced Topics</a></span></dt></dl></dd><dt><span class="part"><a href="htmlsingle.html#getting-started">II. Getting Started</a></span></dt><dd><dl><dt><span class="chapter"><a href="htmlsingle.html#getting-started-introducing-spring-boot">8. Introducing Spring Boot</a></span></dt><dt><span class="chapter"><a href="htmlsingle.html#getting-started-system-requirements">9. System Requirements</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#getting-started-system-requirements-servlet-containers">9.1. Servlet Containers</a></span></dt></dl></dd><dt><span class="chapter"><a href="htmlsingle.html#getting-started-installing-spring-boot">10. Installing Spring Boot</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#getting-started-installation-instructions-for-java">10.1. Installation Instructions for the Java Developer</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#getting-started-maven-installation">10.1.1. Maven Installation</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-gradle-installation">10.1.2. Gradle Installation</a></span></dt></dl></dd><dt><span class="section"><a href="htmlsingle.html#getting-started-installing-the-cli">10.2. Installing the Spring Boot CLI</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#getting-started-manual-cli-installation">10.2.1. Manual Installation</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-sdkman-cli-installation">10.2.2. Installation with SDKMAN!</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-homebrew-cli-installation">10.2.3. OSX Homebrew Installation</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-macports-cli-installation">10.2.4. MacPorts Installation</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-cli-command-line-completion">10.2.5. Command-line Completion</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-cli-example">10.2.6. Quick-start Spring CLI Example</a></span></dt></dl></dd><dt><span class="section"><a href="htmlsingle.html#getting-started-upgrading-from-an-earlier-version">10.3. Upgrading from an Earlier Version of Spring Boot</a></span></dt></dl></dd><dt><span class="chapter"><a href="htmlsingle.html#getting-started-first-application">11. Developing Your First Spring Boot Application</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-pom">11.1. Creating the POM</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-dependencies">11.2. Adding Classpath Dependencies</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-code">11.3. Writing the Code</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-annotations">11.3.1. The @RestController and @RequestMapping Annotations</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-auto-configuration">11.3.2. The @EnableAutoConfiguration Annotation</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-main-method">11.3.3. The “main” Method</a></span></dt></dl></dd><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-run">11.4. Running the Example</a></span></dt><dt><span class="section"><a href="htmlsingle.html#getting-started-first-application-executable-jar">11.5. Creating an Executable Jar</a></span></dt></dl></dd><dt><span class="chapter"><a href="htmlsingle.html#getting-started-whats-next">12. What to Read Next</a></span></dt></dl></dd><dt><span class="part"><a href="htmlsingle.html#using-boot">III. Using Spring Boot</a></span></dt><dd><dl><dt><span class="chapter"><a href="htmlsingle.html#using-boot-build-systems">13. Build Systems</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#using-boot-dependency-management">13.1. Dependency Management</a></span></dt><dt><span class="section"><a href="htmlsingle.html#using-boot-maven">13.2. Maven</a></span></dt><dd><dl><dt><span class="section"><a href="htmlsingle.html#using-boot-maven-parent-pom">13.2.1. Inheriting the Starter Parent</a></span></dt><dt><span class="section"><a href="htmlsingle.html#using-boot-maven-without-a-parent">13.2.2. Using Spring Boot without the Parent POM</a></span></dt><dt><span class="sectio