写文档这个事情绝对是软件开发中最纠结的时候了，大部分时候你首先考虑的项目交付，但是从长远来看，一份文档，可以减少很多问题。

Spring提供了一个Rest doc扩展，可以从单元测试中读取一些一些信息并生成文档。

@Before
public void setUp() {
	this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context)
			.apply(documentationConfiguration(this.restDocumentation)) 
			.build();
}

首先配置上需要应用文档生成器，这个是一行代码的时候，无所谓。

但是对于文档的内容，你其实需要从代码中注明，比如

this.mockMvc.perform(get("/user/5").accept(MediaType.APPLICATION_JSON))
		.andExpect(status().isOk())
		.andDo(document("index",
				responseFields( 
						subsectionWithPath("contact")
								.description("The user's contact details"))));

andDo之后的和测试本身并无关联，只是为了文档生成。

这个方案在我看来无非就是把文档写到了代码中，并没有根据测试的期待输入和期待输出直接生成文档。

ScaCap的Auto-Restdocs项目是我目前找到的比较好的解决方案，它除了要求andDo之后表明文档名称以外不强制要求别的信息。

它会从请求的字段中，还有请求的POJO中抽取字段和验证信息，文档本身还是使用的Spring Rest Docs的模板和样式。

参考

https://projects.spring.io/spring-restdocs/

https://github.com/ScaCap/spring-auto-restdocs

https://www.slideshare.net/fbenz/introducing-spring-auto-rest-docs…

Spring Cloud Function是基于Spring Boot的函数框架，它提供了很大程度上的抽象除了函数编程本身之外的东西，如果你的业务逻辑由多个独立函数提供，那么就可以使用Spring Cloud Function。

这个是官方的例子

@SpringBootApplication
public class Application {

  @Bean
  public Function<Flux<String>, Flux<String>> uppercase() {
    return flux -> flux.map(value -> value.toUpperCase());
  }

  public static void main(String[] args) {
    SpringApplication.run(Application.class, args);
  }
}

其中的Function uppercase使我们暴露的函数，默认会直接暴露一个路径为uppercase的API。

因为Spring Cloud Function是Spring …

Kotlin因为之前Android宣布正式支持之后成为了Android世界的Swift，也是大火了一把。

今天使用Spring Boot Initializr生成一个新项目时，突然发现选择的语言中也出现了Kotlin。

感觉试验一下看一下具体长啥样。

首先看看buildscript中多了两个插件，一个是kotlin-gradle-plugin，另外一个是kotlin-allopen。前者是语言支持插件，而后者是专门针对Spring AOP等特性应用的插件，它可以把Kotlin把类和字段变成final的。

对应的插件使用方法为

apply plugin: 'kotlin'
apply plugin: 'kotlin-spring'

而配置Java语言等级的方法也要使用Kotlin的

compileKotlin {
	kotlinOptions.jvmTarget = "1.8"
}
compileTestKotlin {
	kotlinOptions.jvmTarget = "1.8"
}

其他的变化不大，毕竟是JVM语言，稍微了解一下语法就可以看懂，比如main函数是

package com.huangyunkun.kotlin

import org.springframework.boot.SpringApplication
import org.springframework.boot.autoconfigure.SpringBootApplication

@SpringBootApplication
class KotlinApplication

fun main(args: Array<String>) 

Spring Boot 1.5今天发布了。

新版本添加了基于unboundid对于LDAP的支持和Apache Kafka的支持。还有一个有趣的改动是Flyway添加了对于vendor的支持，默认的数据库版本管理地址从db/migration/ 变成了flyway.locations=db/migration/{vendor} ，这里的vendor指的是不同的数据库类型，比如db/migration/mysql 。

新版本还移除了Gradle 1.x的支持（Gradle最新版是3.x）。比较遗憾的是因为CRaSH project已经处于不活跃状态，所以Spring Boot 1.5移除了所有关于CRaSH的支持，也就是remote功能被废弃了。…

Spring Boot中一个很重要的特性就是自动配置，可以根据很多条件决定是否生成相应的bean或者其他操作。

大部分情况下自动配置的条件是ConditionalOnMissingBean，也就是没有这个bean，那就用这个自动配置配置一个。

有时候自动配置条件并不是那么直接，有时候还涉及到一些自己的逻辑，这个时候就可以自定义SpringBootCondition来处理复杂一些的情况。

继承SpringBootCondition并将自己的逻辑实现在getMatchOutcome方法中。

自定义的逻辑大部分有两种，第一种是自动配置针对一类情况，需要检测多个独立类的存在性，比如EmbeddedDatabaseCondition，就会自动检测所有可能的数据库驱动，包括H2，DERBY，HSQL

@Override
public ConditionOutcome getMatchOutcome( ConditionContext context,
					 AnnotatedTypeMetadata metadata )
{
	if ( anyMatches( context, metadata, this.pooledCondition ) )
	{
		return(ConditionOutcome.noMatch( "supported DataSource class found" ) );
	}
	EmbeddedDatabaseType type = EmbeddedDatabaseConnection
				    .get( context.getClassLoader() ).getType();