WireMock 是一个轻量级的服务器，可以快速的实现接口服务和部署。在前端开发中，如果服务接口未实现，可以使用这个工具来模拟接口。关于wiremock的使用网上又不少文章了，可以自行搜索，有时间我会出一篇详细的使用教程。

在wiremock中可以使用velocity脚本来编写数据文件（.vm），这样可以生产动态的数据。

但是wiremock中如果在velocity脚本中存在中文，就会出现编码错乱。而直接使用静态的json数据文本（.json）就不会出问题。

这是因为.vm文件在读取后需要进行转换生产最终的数据，所以wiremock需要wiremock-velocity-transformer-x.x.jar和wiremock-velocity-transformer-standalone-x.x.jar这两个jar包。

就是在velocity转换的过程中出现了编码问题。

实际上，velocity转换后的数据返回的编码不是utf-8，所以我们用utf-8来处理就会有问题，我们在拿到这种数据可用单独做些处理就能得到正常的数据，比如：

new String(text.getBytes(Charsets.ISO_8859_1), Charsets.UTF_8)

注意：在我的电脑上velocity转换后的数据的编码是ISO_8859_1，这个编码是否固定和是否依赖终端类型还不确定，所以可能在其他机器上又是另外一个编码，如gbk。

但是由于我们服务api基本上都使用的utf-8，所以如果wiremock不能提供utf-8的数据，那么我们在代码中就要根据环境来做一些特殊处理。所以最好的办法就是让velocity转换后的数据使用utf-8编码。

转换的代码在wiremock-velocity-transformer-x.x.jar和wiremock-velocity-transformer-standalone-x.x.jar这两个jar包中，其中wiremock-velocity-transformer-x.x.jar只有一个类VelocityResponseTransformer，而wiremock-velocity-transformer-standalone-x.x.jar很大包含了很多不同的包。

为了修改我们要拿到源码，在GitHub上可以找到wiremock-velocity-transformer的源码

https://github.com/adamyork/wiremock-velocity-transformer

下载源码后打开项目，这时要注意当前一定是最新版本的代码，而自己使用的wiremock未必是最新版本的，所以要将代码切到正确的tag下，比如使用的是wiremock-velocity-transformer-1.2.jar和wiremock-velocity-transformer-standalone-1.2.jar，那么checkout到1.2-release的tag上。否则会因为代码的不同导致运行出错。

打开项目后可能会有一些依赖的问题，因为这个build.gradle将所有层次依赖都列出的，而不是利用gradle来自动管理依赖，这样当依赖版本不同时会出现依赖问题。解决方法就是去掉不必要的依赖，只保留velocity-tools和wiremock这两个依赖即可（也要保留junit用于测试），最终如下：

dependencies {
//    compile         group: "org.apache.velocity",           name: "velocity",             version: "1.7"compile         group: "org.apache.velocity",           name: "velocity-tools",       version: "2.0"compile         group: "com.github.tomakehurst",        name: "wiremock",             version: "1.57"
//    compile         group: "org.mortbay.jetty",             name: "jetty",                version: "6.1.26"
//    compile         group: "com.google.guava",              name: "guava",                version: "18.0"
//    compile         group: "com.fasterxml.jackson.core",    name: "jackson-core",         version: "2.4.2"
//    compile         group: "com.fasterxml.jackson.core",    name: "jackson-annotations",  version: "2.4.2"
//    compile         group: "com.fasterxml.jackson.core",    name: "jackson-databind",     version: "2.4.2"
//    compile         group: "org.apache.httpcomponents",     name: "httpclient",           version: "4.3.5"
//    compile         group: "org.skyscreamer",               name: "jsonassert",           version: "1.2.3"
//    compile         group: "xmlunit",                       name: "xmlunit",              version: "1.5"
//    compile         group: "com.jayway.jsonpath",           name: "json-path",            version: "0.8.1"
//    compile         group: "org.slf4j",                     name: "slf4j-api",            version: "1.7.6"
//    compile         group: "net.sf.jopt-simple",            name: "jopt-simple",          version: "4.7"compile ("junit:junit:4.11") {exclude group: "org.hamcrest", module: "hamcrest-core"}testCompile "org.hamcrest:hamcrest-all:1.3"testCompile ("org.jmock:jmock:2.5.1") {exclude group: "junit", module: "junit-dep"exclude group: "org.hamcrest", module: "hamcrest-core"exclude group: "org.hamcrest", module: "hamcrest-library"}testCompile ("org.jmock:jmock-junit4:2.5.1") {exclude group: "junit", module: "junit-dep"exclude group: "org.hamcrest", module: "hamcrest-core"exclude group: "org.hamcrest", module: "hamcrest-library"}testCompile "net.sf.json-lib:json-lib:2.4:jdk15"testCompile "com.googlecode.jarjar:jarjar:1.3"testCompile "commons-io:commons-io:2.4"
}

在这个项目中也只有VelocityResponseTransformer类，转换就是在这里进行的，关键方法如下：

private void transformResponse(final ResponseDefinition response) throws Exception {final String templatePath = fileSource.getPath().concat("/" + response.getBodyFileName());final Template template = Velocity.getTemplate(templatePath);StringWriter writer = new StringWriter();template.merge(context, writer);final byte[] fileBytes = String.valueOf(writer.getBuffer()).getBytes();response.setBody(fileBytes);response.setBodyFileName(null);
}

问题就出现在Velocity.getTemplate(templatePath)这句

这里没有指定编码，则会使用默认编码，实际上Velocity提供了附带编码的方法，所以修改为

Velocity.getTemplate(templatePath, "utf-8")

即可，在项目的resource下的文件中添加中文，运行测试用例VelocityResponseTransformerTest就会发现可以获得正常的中文了。

最后就是要打包jar，通过测试发现wiremock-velocity-transformer-x.x.jar和wiremock-velocity-transformer-standalone-x.x.jar这两个jar包中都有VelocityResponseTransformer类，所以这两个jar包都需要替换。但是项目中只有一个类，打出wiremock-velocity-transformer-x.x.jar这个jar包还比较容易，但是wiremock-velocity-transformer-standalone-x.x.jar很难手动打出。

其实在build.gradle中已经有了打包的task，本来的目的是为了打包上传到仓库。代码如下：

fatJar {archiveName = "wiremock-velocity-transformer-standalone-" + fatJar.version + ".jar"manifest {attributes "Implementation-Title"   : "wiremock-velocity-transformer-standalone","Implementation-Version" : version}
}task cleanFunctional(type: Delete) {delete fileTree(dir: "functional", include: "*-velocity-transformer-*.jar", exclude: "wiremock-1.55-standalone.jar")
}task copyFunctional(type: Copy) {from "build/libs/"include "*.jar"exclude "*-sources.jar","*-javadoc.jar"into "functional/"
}task javadocJar(type: Jar, dependsOn: javadoc) {classifier = "javadoc"from "build/docs/javadoc"
}task sourcesJar(type: Jar) {from sourceSets.main.allSourceclassifier = "sources"
}jar {dependsOn fatJardependsOn cleanFunctionaldependsOn copyFunctionalcleanFunctional.shouldRunAfter fatJarcopyFunctional.dependsOn cleanFunctionalcopyFunctional.shouldRunAfter cleanFunctionalarchiveName = "wiremock-velocity-transformer-" + jar.version + ".jar"manifest {attributes "Implementation-Title"   : "wiremock-velocity-transformer","Implementation-Version" : version}
}artifacts {archives jararchives javadocJararchives sourcesJar
}

我们只需要打包，而不需要上传，所以要在uploadArchives中做手脚，代码如下

uploadArchives {repositories {mavenDeployer {beforeDeployment {MavenDeployment deployment -> signing.signPom(deployment)}repository(url: "https://oss.sonatype.org/service/local/staging/deploy/maven2/") {authentication(userName: "", password: "")}pom.project {name "wiremock-velocity-transformer"packaging "jar"description "transformer used to render velocity templates for stubbed responses."url "https://github.com/radAdam/wiremock-velocity-transformer"scm {url "scm:git@github.com:radAdam/wiremock-velocity-transformer.git"connection "scm:git@github.com:radAdam/wiremock-velocity-transformer.git"developerConnection "scm:git@github.com:radAdam/wiremock-velocity-transformer.git"}licenses {license {name "The Apache Software License, Version 2.0"url "http://www.apache.org/licenses/LICENSE-2.0.txt"distribution "repo"}}developers {developer {id "adamcyork"name "Adam York"}}}}}
}

在uploadArchives这个task下，我们将仓库的账号和密码随便修改（本来也没有账号和密码，但是之前的两个变量如果不删掉则gradle无法成功），这样在上传时就会失败停下，但是前面的步骤都会完成。

运行uploadArchives这个task，完成后在项目中build/libs下就可以看到打好的jar包，将wiremock-velocity-transformer-x.x.jar和wiremock-velocity-transformer-standalone-x.x.jar替换掉wiremock中原有的。

在.vm文件中添加中文，启动wiremock，访问对应接口就会发现中文数据不再乱码了。