spring boot依赖
每一个spring boot的发型版本都包含了所依赖的版本,如果升级spring boot版本,其依赖也会同步更新升级。maven的用户可以通过继承spring-boot-starter-parent。其包含了一些合理的值的设置:
1. 默认设置的编译器为JDK 1.8
2. 源文件默认UTF-8编码
4. 合理的资源过滤(filter)
5. 合理的插件配置
6. 对于application.properties的合理的过滤
7. 默认的配置文件接收spring的${}表达式,maven的资源过滤符被修改为@..@,可以使用maven属性resource.delimiter进行设置更改。
实现starter-parent的方式有如下两种:
1. 继承starter-parent的配置文件如下:
<!-- Inherit defaults from Spring Boot -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.0.BUILD-SNAPSHOT</version>
</parent>
也可以在自己的pom文件中修改指定的依赖版本信息:例如要更新 Spring Data 为另一个版本。具体代码如下<properties>
<spring-data-releasetrain.version>Fowler-SR2</spring-data-releasetrain.version>
</properties>
2. 在dependencyManagement
中加入依赖管理:如下代码所示:<dependencyManagement>
<dependencies>
<!-- Override Spring Data release train provided by Spring Boot -->
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-releasetrain</artifactId>
<version>Fowler-SR2</version>
<scope>import</scope>
<type>pom</type>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.0.0.BUILD-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
(备注:type表名导入的类型为POM,scope=import:完全导入POM的依赖)<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
starters
starter是应用中一系列依赖的描述,可以不用太多依赖就能获取相应的依赖包。官方给出的starter的命名方式为:spring-boot-starter-*,非官方定义的starter不应当以spring-boot-starter开始,而应当以项目工程为开始例如:thirdpartyproject-spring-boot-starter
starters的列表如下:
名称 | 描述 |
spring-boot-starter |
核心starter,包含了自动配置支持,logging以及yaml |
spring-boot-starter-activemq | 使用apache ACTIVEMQ的JMS处理STARTER |
spring-boot-starter-amqp | 使用spring AMQP以及rabbit MQ的starter |
spring-boot-starter-aop | 使用spring AOP以及APJECT J的starter |
spring-boot-starter-artemis | 使用apache Artemis作为JMS的starter |
spring-boot-starter-batch | 使用spring batch的starter |
spring-boot-starter-cache | 支持spring framwork cache的starter |
spring-boot-starter-cloud-connectors | spring cloud connectors的连接云平台couchbase服务的连接器,像like Cloud Foundry 与Heroku |
spring-boot-starter-data-cassandra | 使用cassandra分布式数据库以及Spring Data Cassandra的starter |
spring-boot-starter-data-cassandra-reactive | 使用cassandra分布式数据库以及Spring Data Cassandra 反应的starter |
spring-boot-starter-data-couchbase | 使用面向对象的数据库以及Spring Data Couchbase的数据库 |
spring-boot-starter-data-couchbase-reactive | 与前面类似 |
spring-boot-starter-data-elasticsearch | 使用弹性搜索以及分析引擎spring DAta Elasticsearch |
spring-boot-starter-data-jpa | 使用hibernate的 spring JPA starter |
spring-boot-starter-data-ldap | Spring Data LDAP 的starter |
spring-boot-starter-data-mongodb | 使用mongodb的starter |
spring-boot-starter-data-mongodb-reactive | 与前面类似 |
spring-boot-starter-data-neo4j | 使用Neo4j graph database 与 Spring Data Neo4j的starter |
spring-boot-starter-data-redis | 使用key,value存储在Data Redis的数据库 |
spring-boot-starter-data-redis-reactive | 与前面类似 |
spring-boot-starter-data-rest | 通过使用spring data rest暴露在spring data repostory。 |
spring-boot-starter-data-solr | 通过使用apache solr平台的starter |
spring-boot-starter-freemarker | 通过使用freemarker的MVC web 应用的starter |
spring-boot-starter-groovy-templates | 使用groovy template创建的MVC web应用 |
spring-boot-starter-hateoas | 使用Spring MVC 与 Spring HATEOAS构建的超媒体的starter |
spring-boot-starter-integration | spring 集成starter |
spring-boot-starter-jdbc | 使用tomcat的jdbc的连接池链接JDBC的starter |
spring-boot-starter-jersey | 使用JAX-RS 与 Jersey构建的web应用程序,也可以使用spring-boot-starter-web |
spring-boot-starter-jooq | 使用jooq链接数据库的starter,其可以替换为:spring-boot-starter-jdbc或者是spring-boot-starter-data-jpa |
spring-boot-starter-json | 读或者写json的starter |
spring-boot-starter-jta-atomikos | 使用atomikos的JTA事务starter |
spring-boot-starter-jta-bitronix | 使用bitronix的事务starter |
spring-boot-starter-jta-narayana | 使用narayana的JTA事务starter |
spring-boot-starter-mail | 使用jmail与spring framwork 支持的方式发送邮件 |
spring-boot-starter-mustache | shiyong mustache创建对应的web应用 |
spring-boot-starter-quartz | 定时调用的starter |
spring-boot-starter-security | 安全的starter |
spring-boot-starter-test | 测试的starter |
spring-boot-starter-thymeleaf | 使用thymeleaf构建MVC web应用的starter |
spring-boot-starter-validatior | 通过使用hibernate验证器验证的starter |
spring-boot-starter-web | 使用tomcat作为默认容器构建包括的restful,使用MVC的web应用的starter |
spring-boot-starter-web-services | 使用web services的starter |
spring-boot-starter-webflux | 使用 Spring Framework’s Reactive Web support支持的方式构建WebFlux 应用 |
spring-boot-starter-websocket | 通过使用Spring Framework’s WebSocket support构建dewebsocker的starter |
通过以下starter可以监控和管理应用:
spring-boot-starter-actuator |
提供生产的一些特性来进行监控和管理的starter |
结构化代码
spring boot不需要指定的具体的代码结构,但是这儿有一些常用的一些架构:
1. 使用默认包:使用默认包的话,会导致
@ComponentScan
, @EntityScan
, 或者 @SpringBootApplication
注册扫描产生一定的问题。因此常推荐的包结构为:com.example.project
2. 主要main应用程序的位置:推荐放到root package的目录上。@EnableAutoConfiguration注解将放在main类上,用于搜索包里面的某些指定项(例如:JPA的包,将会搜索@entity标签)。使用@ComponentScan注解可以不用指定包名。如果为根包的话,还可以使用@SpringBootApplication标签。其包结构示例如下:com
+- example
+- myapplication
+- Application.java
|
+- customer
| +- Customer.java
| +- CustomerController.java
| +- CustomerService.java
| +- CustomerRepository.java
|
+- order
+- Order.java
+- OrderController.java
+- OrderService.java
+- OrderRepository.java
类Application.java 使用@Configuration声明为启动类:其代码如下:package com.example.myapplication;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
@Configuration
@EnableAutoConfiguration
@ComponentScan
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
1. 尽管基于XML的spring配置是可用,这里还是推荐基于java的配置。2. 主要的资源都要用@Configuration进行配置。
3. 使用@Import可以导入一个主要的资源类。
4. 对于依赖的jar的配置:可以通过
@EnableAutoConfiguration
or @SpringBootApplication
进行配置加载对应的配置数据。
5. 自动配置没有侵入性,在任何时候,你都可以自定义你的配置去替换掉自动配置部分。
6. 如果要找到哪些自动配置被应用,可以使用debug的方式运行程序,可以通过日志在控制台显示出对应的报告信息。
7. 如果不想使用自动配置,可以使用exclude进行排除(也可以通过spring.autoconfigure.exclude处理)代码如下:
import org.springframework.boot.autoconfigure.*;
import org.springframework.boot.autoconfigure.jdbc.*;
import org.springframework.context.annotation.*;
@Configuration
@EnableAutoConfiguration(exclude={DataSourceAutoConfiguration.class})
public class MyConfiguration {
}
8. 当使用了@ComponentScan,所有的( (@Component
, @Service
, @Repository
, @Controller
etc.)都会被注入spring bean中。通过使用@Autowired
可以自动装配对象。
9.spring boot 提供了
@SpringBootApplication
来对需要通知引入(@Configuration
, @EnableAutoConfiguration
, 与 @ComponentScan
)进行了简化:代码如下:package com.example.myapplication;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication // same as @Configuration @EnableAutoConfiguration @ComponentScan
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
运行方式
01. 在IDE中运行(eclipse,intel idea)
02. 打包运行
java -jar target/myapplication-0.0.1-SNAPSHOT.jar
也可以进行远程调试:代码如下java -Xdebug -Xrunjdwp:server=y,transport=dt_socket,address=8000,suspend=n \
-jar target/myapplication-0.0.1-SNAPSHOT.jar
03. 通过maven运行: mvn spring-boot:run
可以通过设置环境变量来进行设置处理(export MAVEN_OPTS=-Xmx1024m)
开发工具
spring-boot-devtools
1. spring boot 提供了一系列的工具来方便其进行开发,spring-boot-devtools提供了开发的便利,可以通过以下引入依赖模块:代码如下
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
2. 在生产环境中,常常使用缓存来提升性能,但在开发环境下,该配置是不可用的,因此spring-boot-devtools默认会设置其不可用。可以通过在application.properties中配置对应的参数:Thymeleaf 提供了spring.thymeleaf.cache设置,spring-boot-devtools能够自动监控。
3. 应用程序可以通过spring-boot-devtools来监控classpath上的变化来自动重启,这在IDE中相当有用的。静态资源的改变不会被重启(eclipse:保存修改的文件会自动生效。intel idea:需要运行Build -> Make Project)。
4. 每次重启的时候:都会打印一些日志报告信息:可以通过spring.devtools.restart.log-condition-evaluation-delta=false不让其打印。
5. 可以通过设置具体的哪些资源变化不会重启,其配置如下:spring.devtools.restart.exclude=static/**,public/**
6. 可以通过添加spring.devtools.restart.additional-paths路径来动态增加。
7. 可以通过在application.propterties中或者在启动类中加入spring.devtools.restart.enabled 属性来控制器不重启。
8. 可以通过使用trigger文件在指定只有该文件修改的时候,才会触发重启:其配置为spring.devtools.restart.trigger-file
9. 可以在META-INF/spring-devtools.propertie中加入如下配置自动化其配置:代码如下:
restart.exclude.companycommonlibs=/mycorp-common-[\\w-]+\.jar
restart.include.projectcommon=/mycorp-myproj-[\\w-]+\.jar
10. 可以在根路径下加入spring-boot-devtools.properties文件,自定义其里面的配置。
11. 如果远程调试的话,需要在maven的plugin中指定如下
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludeDevtools>false</excludeDevtools>
</configuration>
</plugin>
</plugins>
</build>
设置其对应的spring.devtools.remote.secret属性。
文档参考地址:https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference