Spring Boot 1.4.0 Release Notes 更新日志-02
Spring Framework 4.3 Spring Boot 1.4 builds on and requires Spring Framework 4.3. There are a number of nice refinements in Spring Framework 4.3 including new Spring MVC@RequestMappingannotations. Refer to theSpring Framework reference documentationfor details. Note that the test framework in Spring Framework 4.3 requires JUnit 4.12. SeeSPR-13275for further details. Third-party library upgrades A number of third party libraries have been upgraded to their latest version. Updates include Jetty 9.3, Tomcat 8.5, Jersey 2.23, Hibernate 5.0, Jackson 2.7, Solr 5.5, Spring Data Hopper, Spring Session 1.2, Hazelcast 3.6, Artemis 1.3, Ehcache 3.1, Elasticsearch 2.3, Spring REST Docs 1.1, Spring AMQP 1.6 & Spring Integration 4.3. Several Maven plugins were also upgraded. Couchbase support Full auto-configuration support is now provided for Couchbase. You can easily access aBucketandClusterbean by adding thespring-boot-starter-data-couchbase"Starter" and providing a little configuration: spring.couchbase.bootstrap-hosts=my-host-1,192.168.1.123 spring.couchbase.bucket.name=my-bucket spring.couchbase.bucket.password=secret It’s also possible to use Couchbase as a backing store for a Spring DataRepositoryor as aCacheManager. Refer to theupdated documentationfor details. Neo4J Support Auto-configuration support is now provided for Neo4J. You can connect to a remote server or run an embedded Neo4J server. You can also use Neo4J to back a Spring DataRepository, for example: publicinterfaceCityRepositoryextendsGraphRepository{PagefindAll(Pageablepageable);CityfindByNameAndCountry(Stringname,Stringcountry); } Full details are provided in theNeo4J sectionof the reference documentation. Redis Spring Data repositories Redis can now be used to back Spring Data repositories. See theSpring Data Redisdocumentation for more details. Narayana transaction manager support Auto-configuration support is now included for the Narayana transaction manager. You can choose between Narayana, Bitronix or Atomkos if you need JTA support. Seethe updated reference guidefor details. Caffeine cache support Auto-configuration is provided for Caffeine v2.2 (a Java 8 rewrite of Guava’s caching support). Existing Guava cache users should consider migrating to Caffeine as Guava cache support will be dropped in a future release. Elasticsearch Jest support Spring Boot auto-configures aJestClientand a dedicatedHealthIndicatorif Jest is on the classpath. This allows you to useElasticsearcheven whenspring-data-elasticsearchisn’t on the classpath. Analysis of startup failures Spring Boot will now perform analysis of common startup failures and provide useful diagnostic information rather than simply logging an exception and its stack trace. For example, a startup failure due to the embedded servlet container’s port being in use looked like this in earlier versions of Spring Boot: 2016-02-1617:46:14.334ERROR24753---[main]o.s.boot.SpringApplication:Applicationstartupfailed java.lang.RuntimeException:java.net.BindException:Addressalreadyinuse atio.undertow.Undertow.start(Undertow.java:181)~[undertow-core-1.3.14.Final.jar:1.3.14.Final] atorg.springframework.boot.context.embedded.undertow.UndertowEmbeddedServletContainer.start(UndertowEmbeddedServletContainer.java:121)~[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.boot.context.embedded.EmbeddedWebApplicationContext.startEmbeddedServletContainer(EmbeddedWebApplicationContext.java:293)~[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.boot.context.embedded.EmbeddedWebApplicationContext.finishRefresh(EmbeddedWebApplicationContext.java:141)~[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:541)~[spring-context-4.2.4.RELEASE.jar:4.2.4.RELEASE] atorg.springframework.boot.context.embedded.EmbeddedWebApplicationContext.refresh(EmbeddedWebApplicationContext.java:118)~[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.boot.SpringApplication.refresh(SpringApplication.java:766)[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.boot.SpringApplication.createAndRefreshContext(SpringApplication.java:361)[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.boot.SpringApplication.run(SpringApplication.java:307)[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.boot.SpringApplication.run(SpringApplication.java:1191)[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atorg.springframework.boot.SpringApplication.run(SpringApplication.java:1180)[spring-boot-1.3.2.RELEASE.jar:1.3.2.RELEASE] atsample.undertow.SampleUndertowApplication.main(SampleUndertowApplication.java:26)[classes/:na] Causedby:java.net.BindException:Addressalreadyinuse atsun.nio.ch.Net.bind0(NativeMethod)~[na:1.8.0_60] atsun.nio.ch.Net.bind(Net.java:433)~[na:1.8.0_60] atsun.nio.ch.Net.bind(Net.java:425)~[na:1.8.0_60] atsun.nio.ch.ServerSocketChannelImpl.bind(ServerSocketChannelImpl.java:223)~[na:1.8.0_60] atsun.nio.ch.ServerSocketAdaptor.bind(ServerSocketAdaptor.java:74)~[na:1.8.0_60] atorg.xnio.nio.NioXnioWorker.createTcpConnectionServer(NioXnioWorker.java:190)~[xnio-nio-3.3.4.Final.jar:3.3.4.Final] atorg.xnio.XnioWorker.createStreamConnectionServer(XnioWorker.java:243)~[xnio-api-3.3.4.Final.jar:3.3.4.Final] atio.undertow.Undertow.start(Undertow.java:137)~[undertow-core-1.3.14.Final.jar:1.3.14.Final] ...11commonframesomitted In 1.4, it will look like this: 2016-02-1617:44:49.179ERROR24745---[main]o.s.b.d.LoggingFailureAnalysisReporter: *************************** APPLICATIONFAILEDTOSTART *************************** Description: Embeddedservletcontainerfailedtostart.Port8080wasalreadyinuse. Action: Identifyandstoptheprocessthat'slisteningonport8080orconfigurethisapplicationtolistenonanotherport. If you still want to see the stacktrace of the underlying cause, enable debug logging fororg.springframework.boot.diagnostics.LoggingFailureAnalysisReporter. Image Banners You can now use image files to render ASCII art banners. Drop abanner.gif,banner.jpgorbanner.pngfile intosrc/main/resourcesto have it automatically converted to ASCII. You can use thebanner.image.widthandbanner.image.heightproperties to tweak the size, or usebanner.image.invertto invert the colors. RestTemplate builder A newRestTemplateBuildercan be used to easily create aRestTemplatewith sensible defaults. By default, the builtRestTemplatewill attempt to use the most suitableClientHttpRequestFactoryavailable on the classpath and will be aware of theMessageConverterinstances to use (including Jackson). The builder includes a number of useful methods that can be used to quickly configure aRestTemplate. For example, to add BASIC auth support you can use: @BeanpublicRestTemplaterestTemplate(RestTemplateBuilderbuilder){returnbuilder.basicAuthorization("user","secret").build(); } The auto-configuredTestRestTemplatenow uses theRestTemplateBuilderas well. JSON Components A new@JsonComponentannotation is now provided for custom JacksonJsonSerializerand/orJsonDeserializerregistration. This can be a useful way to decouple JSON serialization logic: @JsonComponentpublicclassExample{publicstaticclassSerializerextendsJsonSerializer{//... }publicstaticclassDeserializerextendsJsonDeserializer{//... } } Additionally, Spring Boot also now providesJsonObjectSerializerandJsonObjectDeserializerbase classes which provide useful alternatives to the standard Jackson versions when serializing objects. See theupdated documentationfor details. Convention based error pages Custom error pages for a given status code can now be created by following a convention based approach. Create a static HTML file in/public/erroror add a template to/templates/errorusing the status code as the filename. For example, to register a custom 404 file you could addsrc/main/resource/public/error/404.html. Seethe updated reference documentationfor details. Unified@EntityScanannotation org.springframework.boot.autoconfigure.domain.EntityScancan now be used to specify the packages to use for JPA, Neo4J, MongoDB, Cassandra and Couchbase. As a result, the JPA-specificorg.springframework.boot.orm.jpa.EntityScanis now deprecated. ErrorPageRegistry NewErrorPageRegistryandErrorPageRegistrarinterfaces allow error pages to be registered in a consistent way regardless of the use of an embedded servlet container. TheErrorPageFilterclass has been updated to that it is now aErrorPageRegistryand not a fakeConfigurableEmbeddedServletContainer. PrincipalExtractor ThePrincipalExtractorinterface can now be used if you need to extract the OAuth2Principalusing custom logic. Test improvements Spring Boot 1.4 includes a major overhaul of testing support. Test classes and utilities are now provided in dedicatedspring-boot-testandspring-boot-test-autoconfigurejars (although most users will continue to pick them up via thespring-boot-starter-test"Starter"). We’ve added AssertJ, JSONassert and JsonPath dependencies to the test starter. @SpringBootTest With Spring Boot 1.3 there were multiple ways of writing a Spring Boot test. You could use@SpringApplicationConfiguration,@ContextConfigurationwith theSpringApplicationContextLoader,@IntegrationTestor@WebIntegrationTest. With Spring Boot 1.4, a single@SpringBootTestannotation replaces all of those. Use@SpringBootTestin combination with@RunWith(SpringRunner.class)and set thewebEnvironmentattribute depending on the type of test you want to write. A classic integration test, with a mocked servlet environment: @RunWith(SpringRunner.class) @SpringBootTestpublicclassMyTest{//...} A web integration test, running a live server listening on a defined port: @RunWith(SpringRunner.class) @SpringBootTest(webEnvironment=WebEnvionment.DEFINED_PORT)publicclassMyTest{//...} A web integration test, running a live server listening on a random port: @RunWith(SpringRunner.class) @SpringBootTest(webEnvironment=WebEnvionment.RANDOM_PORT)publicclassMyTest{ @LocalServerPort privateintactualPort; //...} See theupdated reference documentationfor details. Auto-detection of test configuration Test configuration can now be automatically detected for most tests. If you follow the Spring Boot recommended conventions for structuring your code the@SpringBootApplicationclass will be loaded when no explicit configuration is defined. If you need to load a different@Configurationclass you can either include it as a nested inner-class in your test, or use theclassesattribute of@SpringBootTest. SeeDetecting test configurationfor details. Mocking and spying beans It’s quite common to want to replace a single bean in yourApplicationContextwith a mock for testing purposes. With Spring Boot 1.4 this now as easy as annotating a field in your test with@MockBean: @RunWith(SpringRunner.class) @SpringBootTestpublicclassMyTest{@MockBean privateRemoteServiceremoteService;@Autowired privateReverserreverser;@Test publicvoidexampleTest(){//RemoteServicehasbeeninjectedintothereverserbean given(this.remoteService.someCall()).willReturn("mock");Stringreverse=reverser.reverseSomeCall(); assertThat(reverse).isEqualTo("kcom"); } } You can also use@SpyBeanif you want to spy on an existing bean rather than using a full mock. See themocking sectionof the reference documentation for more details. Auto-configured tests Full application auto-configuration is sometime overkill for tests, you often only want to auto-configure a specific "slice" of your application. Spring Boot 1.4 introduces a number of specialized test annotations that can be used for testing specific parts of your application: @JsonTest- For testing JSON marshalling and unmarshalling. @WebMvcTest- For testing Spring MVC@Controllersusing MockMVC. @RestClientTest- For testing RestTemplate calls. @DataJpaTest- For testing Spring Data JPA elements Many of the annotations provide additional auto-configuration that’s specific to testing. For example, if you use@WebMvcTestyou can@Autowirea fully configuredMockMvcinstance. See thereference documentationfor details. JSON AssertJ assertions NewJacksonTester,GsonTesterandBasicJsonTesterclasses can be used in combination with AssertJ to test JSON marshalling and unmarshalling. Testers can be used with the@JsonTestannotation or directly on a test class: @RunWith(SpringRunner.class) @JsonTestpublicclassMyJsonTests{privateJacksonTesterjson;@Test publicvoidtestSerialize()throwsException{VehicleDetailsdetails=newVehicleDetails("Honda","Civic"); assertThat(this.json.write(details)).isEqualToJson("expected.json"); assertThat(this.json.write(details)).hasJsonPathStringValue("@.make"); } } See theJSON sectionof the reference documentation or the Javadocs for details. @RestClientTest The@RestClientTestannotation can be used if you want to test REST clients. By default it will auto-configure Jackson and GSON support, configure aRestTemplateBuilderand add support forMockRestServiceServer. Auto-configuration for Spring REST Docs Combined with the support for auto-configuringMockMvcdescribed above, auto-configuration for Spring REST Docs has been introduced. REST Docs can be enabled using the new@AutoConfigureRestDocsannotation. This will result in theMockMvcinstance being automatically configured to use REST Docs and also removes the need to use REST Docs' JUnit rule. Please see therelevant sectionof the reference documentation for further details. Test utilities spring-boot-starter-testnow brings theAssertJassertions library. Test utilities from theorg.springframework.boot.testpackage have been moved to aspring-boot-testdedicated artifact. Actuator info endpoint improvements You can now use theInfoContributorinterface to register beans that expose information to the/infoactuator endpoint. Out of the box support is provided for: Full or partial Git information generated from thegit-commit-id-pluginMaven orgradle-git-propertiesGradle plugin (setmanagement.info.git.mode=fullto expose full details) Build information generated from the Spring Boot Maven or Gradle plugin. Custom information from the Environment (any property startinginfo.*) Details are documented in the"Application information"section of the reference docs. MetricsFilter improvements TheMetricsFiltercan now submit metrics in both the classic "merged" form, or grouped per HTTP method. Useendpoints.metrics.filterproperties to change the configuration: endpoints.metrics.filter.gauge-submissions=grouped endpoints.metrics.filter.counter-submissions=grouped,merged Spring Session JDBC Initializer If Spring Session is configured to use the JDBC store, the schema is now created automatically on startup. Secured connection for Artemis/HornetQ Spring Boot now allows to connect against a secured Artemis/HornetQ broker. Miscellaneous server.jetty.acceptorsandserver.jetty.selectorsproperties have been added to configure the number of Jetty acceptors and selectors. server.max-http-header-sizeandserver.max-http-post-sizecan be used to constrain maximum sizes for HTTP headers and HTTP POSTs. Settings work on Tomcat, Jetty and Undertow. The minimum number of spare threads for Tomcat can now be configured usingserver.tomcat.min-spare-threads Profile negation in now supported inapplication.ymlfiles. Use the familiar!prefix inspring.profilesvalues The actuator exposes a newheaddumpendpoint that returns a GZip compressedhprofheap dump file Spring Mobile is now auto-configured for all supported template engines The Spring Boot maven plugin allows to bundlesystemscoped artifacts using the newincludeSystemScopeattribute spring.mvc.log-resolved-exceptionenables the automatic logging of a warning when an exception is resolved by aHandlerExceptionResolver spring.data.cassandra.schema-actionyou be used to customize the schema action to take on startup Spring Boot’s fat jar format should now consume much less memory Locale to Charset mapping is now supported via thespring.http.encoding.mapping.property Spring Data "Ingalls" release train support Spring Boot 1.4 GA ships with the Spring Data "Hopper" release out of the box. Users that would like to try the "Ingalls" release train (available in milestone one at the time of writing) can do so by just setting thespring-data-releasetrain.versionproperty toIngalls-M1and declaring the Spring milestone repository. Depending on what modules of Spring Data you use, you might have to upgrade a couple of transitive dependencies, too: Spring Data REST users will have to upgrade to Spring HATEOAS 0.21 (setspring-hateoas.versionto0.21.0.RELEASE) Spring Data Redis users using Jedis as driver will have to upgrade to 2.9 (setjedis.versionto2.9.0) Deprecations in Spring Boot 1.4 Velocity support has been deprecated since support has been deprecated as of Spring Framework 4.3. Some constructors inUndertowEmbeddedServletContainerhave been deprecated (most uses should be unaffected). Thelocationsandmergeattributes of the@ConfigurationPropertiesannotation have been deprecated in favor of directly configuring theEnvironment. The protectedSpringApplication.printBannermethod should no longer be used to print a custom banner. Use theBannerinterface instead. The protectedInfoEndpoint.getAdditionalInfomethod has been deprecated in favor of theInfoContributorinterface. org.springframework.boot.autoconfigure.test.ImportAutoConfigurationhas been moved toorg.springframework.boot.autoconfigure. All classes in theorg.springframework.boot.testpackage have been deprecated. See the "upgrading" notes above for details. PropertiesConfigurationFactory.setProperties(Properties)is deprecated in favor of usingPropertySources. Several classes in theorg.springframework.boot.context.embeddedpackage have been deprecated and relocated toorg.springframework.boot.web.servlet. All classes in theorg.springframework.boot.context.webpackage have been deprecated and relocated. Thespring-boot-starter-ws"Starter" has been renamed tospring-boot-starter-web-services. Thespring-boot-starter-redis"Starter" has been renamed tospring-boot-starter-data-redis. Thespring-boot-starter-hornetqstarter and auto-configuration has been deprecated in favour of usingspring-boot-starter-artemis management.security.rolehas been deprecated in favour ofmanagement.security.roles The@org.springframework.boot.orm.jpa.EntityScanannotation has been deprecated in favor of@org.springframework.boot.autoconfigure.domain.EntityScanor explicit configuration. TomcatEmbeddedServletContainerFactory.getValves()has been deprecated in favor ofgetContextValves(). org.springframework.boot.actuate.system.EmbeddedServerPortFileWriterhas been deprecated in favor oforg.springframework.boot.system.EmbeddedServerPortFileWriter org.springframework.boot.actuate.system.ApplicationPidFileWriterhas been deprecated in favor oforg.springframework.boot.system.ApplicationPidFileWriter Property Renames spring.jackson.serialization-inclusionshould be replaced withspring.jackson.default-property-inclusion. spring.activemq.pooledshould be replaced withspring.activemq.pool.enabled. spring.jpa.hibernate.naming-strategyshould be replaced withspring.jpa.hibernate.naming.strategy. server.tomcat.max-http-header-sizeshould be replaced withserver.max-http-header-size.
