Spring Boot QuickStart (1)

开始

介绍

Spring Boot 简化了基于 Spring 的应用开发，你只需要 "run" 就能创建一个独立的，产品级别的 Spring 应用。

Spring 平台及第三方库提供开箱即用的设置，这样你就可以有条不紊地开始。多数 Spring Boot 应用只需要很少的Spring 配置。你可以使用 Spring Boot 创建 Java 应用，并使用 java -jar 启动它或采用传统的 war 部署方式

系统要求

Java7 以上，通常建议尽可能使用 Java8

Maven 3.2+，Gradle 2.9+ 或 Gradle 3

内嵌容器支持 Tomcat、Jetty

安装

Maven 安装

POM 文件继承 spring-boot-starter-parent 工程，并声明一个或多个 "Start POMs" 依赖，此外 Spring Boot 提供了一个可选的 Maven 插件，用于创建可执行 jars

...
<parent>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-parent</artifactId>
   <version>1.5.3.RELEASE</version>
</parent>
    
<dependencies>
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
   </dependency>
</dependencies>
    
 <build>
   <plugins>
       <plugin>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-maven-plugin</artifactId>
       </plugin>
   </plugins>
</build>   
...

Gradle 安装

略

使用

Starters

Starters 是一个依赖描述符的集合，你可以将它包含进项目中，这样添加依赖就非常方便。你可以获取所有 Spring 及相关技术的一站式服务，而不需要翻阅示例代码，拷贝粘贴大量的依赖描述符。例如，如果你想使用 Spring 和 JPA 进行数据库访问，只需要在项目中包含spring-boot-starter-data-jpa依赖，然后你就可以开始了。

该 starters 包含很多搭建，快速运行项目所需的依赖，并提供一致的，可管理传递性的依赖集。

以下应用程序 starters 是 Spring Boot 在 org.springframework.boot group 下提供的：

名称	描述
spring-boot-starter	核心Starter，包含了自动配置，日志，YAML配置

Web

名称	描述
spring-boot-starter-web	用于使用Spring MVC构建web应用，包括RESTful。Tomcat是默认的内嵌容器
spring-boot-starter-web-services	对Spring Web服务的支持
spring-boot-starter-websocket	对Spring WebSocket支持
spring-boot-starter-mobile	用于使用Spring Mobile开发web应用
spring-boot-starter-jersey	用于使用JAX-RS和Jersey构建RESTful web应用，spring-boot-starter-web的替代方案
spring-boot-starter-hateoas	用于使用基于hypermedia-based RESTful web 应用

数据

名称	描述
spring-boot-starter-jdbc	对JDBC的支持（使用Tomcat JDBC连接池）
spring-boot-starter-data-redis	用于使用通过Jedis客户端操作的Redis
spring-boot-starter-data-mongodb	用于使用基于文档的数据库MongoDB
spring-boot-starter-data-cassandra	用于使用分布式数据库Cassandra
spring-boot-starter-data-solr	用于使用Apache Solr
spring-boot-starter-data-elasticsearch	用于使用Elasticsearch搜索
spring-boot-starter-data-couchbase	用于使用基于文档的数据库Couchbase
spring-boot-starter-data-gemfire	用于使用分布式数据存储GemFire
spring-boot-starter-data-neo4j	用于使用图数据库Neo4j
spring-boot-starter-data-ldap	用于使用 Spring Data LDAP
spring-boot-starter-data-jpa	用于使用Hibernate实现Spring Data JPA
spring-boot-starter-data-rest	用于使用 Spring Data REST

事务

名称	描述
spring-boot-starter-jta-atomikos	用于使用Atomikos实现JTA事务
spring-boot-starter-jta-bitronix	用于使用Bitronix实现JTA事务
spring-boot-starter-jta-narayana	用于使用Narayana 实现JTA事务

模板

名称	描述
spring-boot-starter-thymeleaf	用于使用Thymeleaf模板引擎构建MVC web应用
spring-boot-starter-freemarker	用于使用FreeMarker模板引擎构建MVC web应用
spring-boot-starter-mustache	用于使用Mustache模板引擎构建MVC web应用
spring-boot-starter-groovy-templates	用于使用groovy模板引擎构建MVC web应用

消息

名称	描述
spring-boot-starter-activemq	用于使用Apache ActiveMQ实现JMS消息
spring-boot-starter-artemis	用于使用Apache Artemis实现JMS消息
spring-boot-starter-amqp	用于使用AMQP与Rabbit MQ消息队列

工具

名称	描述
spring-boot-starter-mail	用于使用Java Mail和Spring框架email发送支持
spring-boot-starter-integration	用于使用Spring Integration
spring-boot-starter-security	对Spring Security的支持
spring-boot-starter-test	用于测试Spring Boot应用，支持常用测试类库，包括JUnit, Hamcrest和Mockito
spring-boot-starter-batch	用于使用Spring Batch
spring-boot-starter-cache	用于使用Spring框架的缓存支持
spring-boot-starter-actuator	为Spring Boot提供了监控与管理
spring-boot-starter-aop	用于使用Spring AOP和AspectJ实现面向切面编程
spring-boot-starter-validation	用于使用Hibernate Validator实现Java Bean校验
spring-boot-starter-logging	用于Logback支持，默认的logging starter
spingg-boot-starter-log4j2	用于Log4j2支持，用于替换默认的logging

社会化

名称	描述
spring-boot-starter-social-linkedin	用于使用Spring Social Linkedin的支持
spring-boot-starter-social-facebook	用于使用Spring Social Facebook的支持
spring-boot-starter-social-twitter	用于使用Spring Social Twitter的支持

社区 Starters

下面可以获取一个社区贡献的 starters 列表：

https://github.com/spring-pro...

名称	描述
grpc-spring-boot-starter	用于支持gRPC
mybatis-spring-boot	用于支持Mybatis
okhttp-spring-boot	用于支持OkHttp

组织代码

下面是个典型的结构，建议把应用的main类放到包的顶层

com
 +- example
     +- myproject
         +- Application.java
         |
         +- domain
         |   +- Customer.java
         |   +- CustomerRepository.java
         |
         +- service
         |   +- CustomerService.java
         |
         +- web
             +- CustomerController.java

@SpringBootApplication注解

@SpringBootApplication注解等价于以默认属性使用：
@Configuration
@EnableAutoConfiguration
@ComponentScan

运行

通过 jar 运行

 java -jar target/myproject-0.0.1-SNAPSHOT.jar

通过 Maven 插件运行

mvn spring-boot:run

可以使用一些有用的环境变量：

export MAVEN_OPTS=-Xmx1024m -XX:MaxPermSize=128M

热交换

彻底的的解决可以使用：Spring Loaded 项目或 JRebel

spring-boot-devtools 支持应用的快速重启

配置

Application 属性文件

SpringApplication将从以下位置加载 application.properties 文件，并把它们添加到Spring：

1. 当前目录下的/config 子目录。

2. 当前目录。

3. classpath下的/config包。

4. classpath根路径（root）。

命令行属性

SpringApplication会将所有命令行配置参数（以'--'开头，比如--server.port=9000）转化成一个property，并将其添加到Spring Environment中

命令行属性总是优先于其他属性源。

日志级别

通过 --debug 标识开启控制台DEBUG级别日志记录，也可以在 application.properties中指定 debug=true

java -jar myapp.jar --debug

日志级别配置示例：

logging.level.root=WARN
logging.level.org.springframework.web=DEBUG
logging.level.org.hibernate=ERROR