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，訪問對應接口就會發現中文數據不再亂碼了。

?

總結

以上是生活随笔為你收集整理的解决wiremock中velocity脚本（.vm）中文编码乱码问题的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。