話說在做單元測試的時候，Mock Object 是很常使用的技巧，可以協助開 發者隔離實際的環境，或以人工方式產生錯誤，以加強測試環境的控制。 [1] Mock Object http://en.wikipedia.org/wiki/Mock_object 簡而言之，Mock Object 的精神就是將非你可以控制的部份獨立出來，設 計成可以隨時以其他的實作取代。 在 Scala 裡面，要在做單元測試時使用 Mock Object 是相當簡單，只要 使用內建的 Trait 就可以很容易的達成 Mock Object 的技巧，而且對於 客戶端的使用者而言，並不會感覺到任何使用上的差異。 在這邊，我們使用上次實作的 GeoService 函式庫來做示範，首先先複習 一下上次的函式庫（我有做一些小修正，不過介面是一樣的）。 ================================================================ package org.maidroid.utils import scala.io._ import scala.xml.XML import scala.xml.Node import scala.xml.Elem import java.net.URLEncoder case class GeoPlacemark (val query: String, val address: String, val accuracy: Int, val longitude: Double, val latitude: Double) { val longitudeE6 = (longitude * 1E6) toInt val latitudeE6 = (latitude * 1E6) toInt } class GeoService (val query: String, val locale: String) { private var statusCode = 0 private var errorMessage = "" val placemarkList: List[GeoPlacemark] = doQuery () def this (query: String) = this (query, "") def error = (statusCode, errorMessage) private def createGeoPlacemark (node: Node) = { val address = (node \ "address").text val accuracy = (node \ "AddressDetails" \ "@Accuracy").text val coordinate = (node \ "Point").text.split (",").toList val List (longitude, latitude, _) = coordinate GeoPlacemark (query, address, accuracy.toInt, longitude.toDouble, latitude.toDouble) } private def loadXML = { val url = "http://maps.google.com/maps/geo?" + "q=%s&output=xml&gl=%s". format(URLEncoder.encode(query), locale) val source = Source.fromURL (url, "utf-8") val iter = for (line <- source.getLines) yield line XML.loadString (iter.mkString) } private def doQuery () = { try { val xml = loadXML this.statusCode = (xml \ "Response" \ "Status" \ "code").text.toInt // code 200 means OK if (statusCode != 200) { throw new Exception ("Query Faild") } val placemark = xml \ "Response" \ "Placemark" val addressList = for (node <- placemark) yield createGeoPlacemark (node) addressList.toList } catch { case e => errorMessage = e.getMessage Nil } } } ================================================================ 上述的程式碼中，我們可以發現所謂『非我們所能控制』的部份，就是連 到 Google Maps 服務取得 XML 文件的 loadXML 這個函式。 這就是我們要把它隔離的程式碼，所以我們先設計一個 Trait，裡面有一 個 loadXML 函式的介面。 ================================================================ trait LoadXML { protected def loadXML: Elem } ================================================================ 在這邊要注意的是，由於這個函式是內部使用，不應該透露給外界，所以 我們將其宣告為 protected，這和 Java 的介面裡面只能有 public 不一 樣。 接著，我們更改我們的 GeoService 的實作，要改的部份只有兩個： * 讓 GeoService mix-in LoadXML * 將 GeoService#loadXML 的部份改成 override protected 完整的程式碼如下： ================================================================ package org.maidroid.utils import scala.io._ import scala.xml.XML import scala.xml.Node import scala.xml.Elem import java.net.URLEncoder trait LoadXML { protected def loadXML: Elem } case class GeoPlacemark (val query: String, val address: String, val accuracy: Int, val longitude: Double, val latitude: Double) { val longitudeE6 = (longitude * 1E6) toInt val latitudeE6 = (latitude * 1E6) toInt } class GeoService (val query: String, val locale: String) extends LoadXML { private var statusCode = 0 private var errorMessage = "" val placemarkList: List[GeoPlacemark] = doQuery () def this (query: String) = this (query, "") def error = (statusCode, errorMessage) private def createGeoPlacemark (node: Node) = { val address = (node \ "address").text val accuracy = (node \ "AddressDetails" \ "@Accuracy").text val coordinate = (node \ "Point").text.split (",").toList val List (longitude, latitude, _) = coordinate GeoPlacemark (query, address, accuracy.toInt, longitude.toDouble, latitude.toDouble) } protected def loadXML = { val url = "http://maps.google.com/maps/geo?" + "q=%s&output=xml&gl=%s". format(URLEncoder.encode(query), locale) val source = Source.fromURL (url, "utf-8") val iter = for (line <- source.getLines) yield line XML.loadString (iter.mkString) } private def doQuery () = { try { val xml = loadXML this.statusCode = (xml \ "Response" \ "Status" \ "code").text.toInt // code 200 means OK if (statusCode != 200) { throw new Exception ("Query Faild") } val placemark = xml \ "Response" \ "Placemark" val addressList = for (node <- placemark) yield createGeoPlacemark (node) addressList.toList } catch { case e => errorMessage = e.getMessage Nil } } } ================================================================ 什麼？結束了？！別懷疑，真的就只有這樣子而已，這正是 Scala 吸引 我的地方，夠方便吧！ 在測試開始之前，我們先來做幾個 Mock 來用吧，要做 Mock 很簡單，只 要再宣告繼承 LoadXML 的 Trait 即可。在這次的測試中，我們建造了以 下三個 Mock。 * 正確的 XML 回傳值 * 錯誤的 XML 回傳值 * 執行期間發生連線錯誤的 Exception ================================================================ // 正確的 XML 回傳值 trait MockXML extends LoadXML { override def loadXML = <kml xmlns="http://earth.google.com/kml/2.0"> <Response> <!-- 此處省略，請照抄 Google Maps 傳回值 --> </Response> </kml> } // 錯誤的 XML 格式 trait WrongXML extends LoadXML { override def loadXML = <root /> } // 連線錯誤 Exception trait ExceptionXML extends LoadXML { override def loadXML = throw new java.net.ConnectException } ================================================================ 有了這些 Mock 物件之後，就可以著手來寫單元測試了，在這裡所使用的 是 ScalaTest 這個支援多種單元測試風格的 Framework，這次我們用的 是 FlatSpec 這個 Behavior Driven Development 測試。 [2] ScalaTest http://www.scalatest.org/ 由於使用 FlatSpec 所寫出的測試都相當直覺，看起來就像英文句子，所 以程式碼的部份就不做詳細的解釋了。 在這邊要注意的地方，就是當我們要使用 Mock 的時候，直需要在建立物 件時將要使用的 Mock 給 mix-in 進來就好，範例如下。 ================================================================ // 不使用任何 Mock val noMock = new GeoService ("中央研究院") // 分別使用上述三種 Mock val mock1 = new GeoService ("中央研究院") with MockXML val mock2 = new GeoService ("中央研究院") with WrongXML val mock3 = new GeoService ("中央研究院") with ExceptionXML ================================================================ 知道了上述的規則後，我們就可以使用這三個 Mock 撰寫我們的測試案例 了，完整的測試案例如下。 ================================================================ import org.scalatest.FlatSpec import org.scalatest.matchers.ShouldMatchers import org.maidroid.utils._ class GeoServiceSpec extends FlatSpec with ShouldMatchers { // 不使用任何 Mock 物件 "A GeoService" should "retun a list of GeoPlacemark when successed" in { val service = new GeoService ("中央研究院") val correct = GeoPlacemark ("中央研究院", "115 Taiwan Taipei City Nangang "+ "District中央研究院", 9, 121.6122646, 25.0405918) service.placemarkList should be === List (correct) } // 使用 MockXML 以保確取得正確的 XML 回傳值 it should "has statusCode 200 and no error message when successed" in { val service = new GeoService ("中央研究院") with MockXML service.error should be === (200, "") } // 例用 WrongXML Mock 測試當回傳值為不合格式的 XML 時的狀況 it should "has statusCode 0 and empty list when XML format is wrong" in { val service = new GeoService ("中央研究院") with WrongXML service.placemarkList should be === Nil service.error._1 should be === 0 } // 例用 ExceptionXML 測試發生 Exception 時的行為 it should "has statusCode 0 and empty list when Exception occurred" in { val service = new GeoService ("中央研究院") with ExceptionXML service.placemarkList should be === Nil service.error._1 should be === 0 } } ================================================================ 如何？要在 Scala 使用 Mock Object 進行單元測試很方便吧？！請多多 利用這個技巧，讓單元測試變得更愉快喲！ -- ~ 白馬帶著她一步步地回到中原。白馬已經老了，只能慢慢地走， 'v' Brian Hsu 但終是能回到中原的。江南有楊柳、桃花，有燕子、金魚…… // \\ ( 墳 墓 ) /( )\ 但這個美麗的姑娘就像古高昌國人那樣固執。 【白馬嘯西風】 ^`~'^ http://bone.twbbs.org.tw/blog 『那都是很好很好的，可我偏不喜歡。』 --

※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 59.120.199.114