小黃瓜的驗收測試

Cucumber是一個以驗收測試為目標的框架，對碼農來說，就是有人(PM或參與的用戶)把使用者情境(或者說是使用者腳本)的過程寫出來，然後我們想法子匹配到我們的程式中，看看程試跑出的結果是否有符合腳本所要描述的狀態。
廢話少說，先體驗下：
  1. 首先開個目錄 cuke-first，然後在cuke-first/lib裡面放入cucumber-java.jar、cucumber-core.jar、cucumber-jvm-deps.jar、gherkin.jar
  2. 然後在cuke-first/features寫入我們的第一個腳本如下checkout.feature
# language: zh-TW
功能: 結帳
 生鮮超市結帳測試腳本
 場景: 香蕉結帳
   假設"香蕉"每斤40元
   當我買了1斤"香蕉"
   那麼總價要付40元
  1. 看一下雛形寫法
cuke-first]$java -cp "lib/*:." cucumber.api.cli.Main -p pretty --snippets camelcase -d features
功能: 結帳
 生鮮超市結帳測試腳本

 場景: 香蕉結帳      # checkout.feature:4
    假設"香蕉"每斤40元
    當我買了1斤"香蕉"
    那麼總價要付40元

1 Scenarios (1 undefined)
3 Steps (3 undefined)
0m0.000s


您可以用下面片段的程式來實作遺漏的步驟:

@假設("^\"([^\"]*)\"每斤(\\d+)元$")
public void 每斤元(String arg1, int arg2) throws Throwable {
   // Write code here that turns the phrase above into concrete actions
   throw new PendingException();
}

@當(("^我買了(\\d+)斤\"([^\"]*)\"$"))
public void 我買了斤(int arg1, String arg2) throws Throwable {
   // Write code here that turns the phrase above into concrete actions
   throw new PendingException();
}

@那麼("^總價要付(\\d+)元$")
public void 總價要付元(int arg1) throws Throwable {
   // Write code here that turns the phrase above into concrete actions
   throw new PendingException();
}
請注意:腳本中以雙引號(")夾起的文字會變成String參數，而所有的數字會變成int 參數
上述的參數說明:
-p
表示輸出結果，若是值為 pretty，則會將整本腳本完整印出，若值為progress，則會用 . F - U P 分別表示 通過 失敗 跳過 未定義 暫停
其它可用的有 junit,html:報表目錄,json:輸出路徑與檔名 等用法
--snippets
雛形函式的名稱，值可用 underscore (以底線分隔), camelcase(第一字小寫，而後面每個字的第一個字大寫)，因為我們使用中文腳本，函式名稱又自定義，所以這個參數沒有什麼用
-d
腳本所在的目錄

  1. 我不太喜歡Java用變數與方法用中文，所以先把英中對照表找出來
cuke-first]$java -cp "lib/*:." cucumber.api.cli.Main --i18n zh-TW
feature
"功能"
background
"背景"
scenario
"場景", "劇本"
scenario_outline
"場景大綱", "劇本大綱"
examples
"例子"
given
"* ", "假如", "假設", "假定"
when
"* ", "當"
then
"* ", "那麼"
and
"* ", "而且", "並且", "同時"
but
"* ", "但是"
given (code)
"假如", "假設", "假定"
when (code)
"當"
then (code)
"那麼"
and (code)
"而且", "並且", "同時"
but (code)
"但是"
上面標(code)的表示是用在程式中的@Annotation，而沒有標(code)的表示是用在腳本的語法中
  1. 開始寫第一個測試程式到cuke-first/steps，並加以編譯
cuke-first]$ vi ./steps/CheckoutSteps.java
package steps;

import cucumber.api.java.en.*;
import java.util.*;

public class CheckoutSteps {
   Map<String,Integer> pricesMap = new HashMap<>();

   @Given("^\"([^\"]*)\"每斤(\\d+)元$")
   public void thePerKiloPriceOfFruitI(String fruit, int price) throws Throwable {
       pricesMap.put(fruit,price);
   }

   @When(("^我買了(\\d+)斤\"([^\"]*)\"$"))
   public void iCheckout(int kilo, String fruit) throws Throwable {
       //TODO:把水果加入結帳
       summary += kilo * pricesMap.get(fruit);
   }

   @Then("^總價要付(\\d+)元$")
   public void theTotalPriceShouldBeDollars(int total) throws Throwable {
       //TODO:測試總價是否正確
       assert summary == total : "結帳價格計算錯誤";
   }
}
:x
cuke-first]$ javac -cp ".:lib/*" ./steps/*.java
  1. 進行測試
cuke-first]$ java -cp "lib/*:." -ea cucumber.api.cli.Main -p pretty -g steps features
# language: zh-TW
功能: 結帳
 生鮮超市結帳測試腳本

 場景: 香蕉結帳              # checkout.feature:4
   假設"香蕉"每斤40元 # CheckoutSteps.thePerKiloPriceOfFruitIs(String,int)
   當我買了1斤"香蕉"   # CheckoutSteps.iCheckout(int,String)
   那麼總價要付40元    # CheckoutSteps.theTotalPriceShouldBeC(int)

1 Scenarios (1 passed)
3 Steps (3 passed)
0m0.075s
上述多了一個 -g 參數，目的在於將程式與腳本結合，因為測試程式放在 steps目錄下，而腳本放在 features下，所以必須用 -g 告訴 cucumber，將程式與腳本串聯(glue)在一起

腳本寫法說明

  1. 首先第一行使用 # language: zh-TW 說明我們的腳本是用正體中文書寫，每個階層習慣以兩個空白字元作縮排。
  2. 用 功能: 開頭，接著用短文字作為這腳本的名稱，例如上述的 結帳；若是有詳細說明，請換行寫(可容許多行)，例如上述的 生鮮超市結帳測試腳本
  3. 然後以 場景:、劇本:、場景大綱: 或 劇本大綱: 開頭，開始描述要測試的內容，內容至少要包含一句 假設、假如 或 假定 開頭 的句子，可用 # 來表示註解，範本如下：
# language: zh-TW
功能: 結帳

劇本大綱: 買香蕉結帳
   假設”香蕉”每斤40元
# <count>與 <total>變數會對映到下面的例子的 count、total 參數，
   當我買了<count>斤"香蕉"  
   那麼總價要付<total>元
#例子中的兩個參數會代入上面的 <count> 與 <tottal> ，也就是會用兩組參數各執行一次測試
   例子:
   | count | total |
   | 1       | 40    |
   | 2       | 80    |
   
 場景: 兩串蕉分別掃條碼
   假設”香蕉”每斤40元
   當我買了1斤"香蕉"
   並且結帳時又加了1斤"香蕉"
   那麼總價要付80元

 場景: 買1斤香蕉和一斤蘋果
   假設”香蕉”每斤40元
   同時"蘋果"每斤25元
   當我買了1斤"香蕉"
   並且結帳時又加了1斤"蘋果"
   那麼總價要付65元
  1. 照前述的第3點，重新產生一下雛形寫法，會發現腳本寫了那麼長，卻只產生幾個函試，所以可以確定一點，cucumber的測試是以讀取腳本，然後以 Regex 找尋符合的函式，一一執行，所以要小心語法相同，卻作不同事的描述。
  2. 腳本寫作的原則，一次只測一件事，最好只縮減到只剩 假設 當 那麼，就像作實驗一樣，過多的可變因子會導致錯誤時，卻不知道是因為什麼因素而失敗。

結合框架

回頭看上面的步驟，會發現，所有的工作的進入點都是一支 cucumber.api.cli.Main 程式，然後透過參數告訴cucumber.api.cli.Main應該怎麼作，而通常我們作測試，並不會用這麼粗爆的方式，最常見的就是結合測試框架，例如 JUnit 與 TestNG 。
跟之前的測試一樣JUnit 與 TestNG也要有一個進入點，官方的Github裡有很多的範例程式，不過我還是大略說明一下。

JUnit的進入點(測試程式，在此要用到cucumber-junit.jar 與 cucumber-html.jar)

import cucumber.api.CucumberOptions;
import cucumber.api.junit.Cucumber;
import org.junit.runner.RunWith;

@RunWith(Cucumber.class)
@CucumberOptions(plugin = {"pretty", "html:target/cukeReport"}, snippets = SnippetType.CAMELCASE,
       features = {"src/test/resources/features"},glue = {"kentyeh.steps"})
public class RunCukesTest {
}
說明:
  1. Cucumber.class如同之前的cucumber.api.cli.Main一樣，是Cucumber Junit測試程式的進入點，@CucumberOptions而就相當於之前的參數設定，所以一個專案內就只應存在這一組，用多組進入程式或是多個@CucumberOptions可能會導致對可知的後果
  2. features指示Cucumber ，腳本的存放路徑，這樣子Cucumber才知道要從那裡讀取腳本
  3. glue指示腳本測試程式的package名稱，例如之前的 CheckoutSteps.java就應該放在這個package下，那麼cucumber才會在讀取腳本的時候，才知道到那個package下去找Matched的程式進行驗收測試。

TestNG的進入點(要用到cucumber-testng.jar)

import cucumber.api.CucumberOptions;
import cucumber.api.junit.Cucumber;
import cucumber.api.testng.AbstractTestNGCucumberTests;

@RunWith(Cucumber.class)
@CucumberOptions(plugin = {"pretty", "html:target/cukeReport"}, snippets = SnippetType.CAMELCASE,
       features = {"src/test/resources/features"},glue = {"kentyeh.steps"})
public class RunCukesTest extends AbstractTestNGCucumberTests{
}
說明:跟Junit沒太多的差別，唯一不同的就是繼承AbstractTestNGCucumberTests

Spring 的 Autowired(要用到cucumber-spring.jar)

沒有什麼特別，直接在 XXXsteps.java內使用spring 的 annotation，這裡有兩個範例。

若您是 spring + maven 的開發者，可以用以下指令產生範例專案
$mvn archetype:generate -DarchetypeGroupId=com.github.kentyeh \
-DarchetypeArtifactId=springJdbiArch -DarchetypeVersion=2.2
經問答式產出專案後進入專案目錄執行以下指令進行測試
$mvn test
或是可以以下指令，提示cucumber腳本step程式雛形
$mvn -Pcuke initialize
其它部分請參考專案首頁


Guice(要用到cucumber-guice.jar)

沒有用過，不過應該與Spring差不多

從這個索引目錄可以看出，有其它可以配合的框架，請自行從官方的GitHub學習。

留言

張貼留言

這個網誌中的熱門文章

企業人員的統一管理-FreeIPA學習筆記

圖片
從FreeIPA的 首頁 來看，她想要解決識別、方針(Policy)管理與微軟的AD相互信任的目標。 識別其實是為了能夠做到單一簽入(SSO,Single Sing On)，從另一個角度來看就是人員的統一管理，實際上很難，在Web不盛行的時代，還可透過Kerberos( 解說 )來做到Desktop Single Sing On 或LDAP(UNIX BASE)做到統一帳號管理 ，從而達成所有主機人員權限的統一管理，但Web就不容易了，因為瀏覽器沒有規定一定要支援Kerberos(Firefox除外，Firefox可 支援Kerberos 以 存取FreeIPA的WebUI )，所以要在瀏覽器做到SSO，大概的方式不是透過SAML就是透過OpenID, 好在FreeIPA 支援SAML (透過 IPSILON )與 OpenID (因為我用的開發工具是JAVA，所以開發過OPENID的 範例 ，不要與OAuth搞混了，SSO是從上而下的管理管理眾人，而OAuth是由客戶決定其它站台是否可以存取我的個人資料，是由下而上的管理)。 方針(Policy)管理則是限制用戶什麼可以做，什麼不可以做。主要控制的是Linux系統，像SUDO、Autofs等；至於對Window與AD的整合，老實說因為我不懂AD，所以不知道FreeIPA在這方面可以做什麼？ 所以對我來說，FreeIPA至少是一個提供企業一個統合管理人員識別的好地方(企業內的人員因為多系統而儲存於不同的資料庫，在管理上其實是不太方便)。 FreeIPA同微軟的AD一樣，都是目錄服務提供者，說穿了，目錄服務就是扮演了資料庫的角色，只不過這個資料庫可以在不同機器間複製罷了。FreeIPA跟AD一樣,可以設定管理DNS，我的建議是一定要裝，做為企業內部的DNS，便於內部系統程式使用名稱取代IP。不過需要注意的是：FreeIPA經安裝後會mask掉原本的named service，改用她所提供的named-pkcs11 service，不過她也說了 bla,bla... ，不要用ACL與VIEW。 IPA的術語有三個： Server:FreeIPA的管控主機，第一個建立的也稱master(可建立別台主機為replica) Replica:也是FreeIPA的管控主機，從另一臺master Ser...
閱讀完整內容

證交所最佳五檔的程式解析

註： 2018/11/29，發現已經無法一次查詢多個代號，只能迴圈一個一個查。 今天是2017/1/16，一早發現網址又改，原來第3第4點的 getSTKInfo.jsp 改成 getS tock Info.jsp? ，而且也把json亂數表頭的方式移除，已緊急改程式了，請重新 下載程式 ( 程式碼在此 ) 2018/8/23，一早發現必須透過getStockInfo.jsp才是取得Session的地方，所以修改下面第一點 首先我要說明一下現在的日期是 2017年1月，因為 證交所最佳五檔的程式 的規則有時會變動，不見得適用未來的日子。 證交所提供了股票即時 最佳五檔 的網頁，供一般民眾查詢(但我相信，會觀注的多半是碼農，從 最佳五檔 的網址，它主要的Host是 mis.twse.com.tw ，這是我們要注意的第一個點，透過 dig command ，我們可以發現twse.com.tw網域用了4台DNS主機來應付輸詢，這也是我要提的第一個建議： 若不是用瀏覽器執行JavaScript程式  URL直接採用網址IP連結，不要使用mis.twse.com.tw網域，輸詢太多次會卡住，且若每次輸詢結果不一致時，會導致Session遺失 再來針對它的程式設計加以說明： 先說一下，用網頁查詢的網址格式是 http://mis.twse.com.tw/stock/fibest.jsp?lang=zh_tw&stock={代號} ，在瀏覽器下通常 lang=zh_tw 參數會被省略，但是程式設計時，請不要忘了要加上去。這是最重要的一個關鍵，因為我們必須在這頁取得Session(並且要保留)，否則後面的資料存取將無以為繼，所以若是以程式要取得Session的第一件事就是連到 http://mis.twse.com.tw/stock/fibest.jsp?lang=zh_tw 我們取得這個網頁只是為了取得Cookie ，但現在除了這個功能外，還必須取得網頁並分析其中的3個Function：rA1()、rA2()與rA3()，因為後續取得的JSON屬性表頭不再是固定的字串，而是隨機定義在這三個函數內，我們必須透過分析JavaScript以瞭解JSON內容每個項目所代表的意義，取得範例的部分內容說明如下： 在以往，我們取得這個網頁只能...
閱讀完整內容

Postgresql HA

圖片
關於Postgresql HA，建議閱讀 這篇文章 ，摘要如下： Standby databases 主要資料庫的備分，有著與主要資料庫相同的資料，以備意外發生。 以複製方式分類 Physical standbys :硬碟區塊複製 Logical standbys :變動資料串流複製 以transaction同步分類： 異步 :可能會掉資料 同步 :不可能掉資料，master會等待standby複製完成通知 以用途分類 Warm standbys :standby機不提供連線 Hot standbys :standby機提供唯讀查詢連線 叢集 多個主機視為一體，叢集規模可調整，任一節點掛點不影響作業，依資料共用可分類如下： Shared-storage :所有節點共享資料 Shared-nothing :每個節點有自已的儲存，所以不一定會資料相同 然後是我比較關注的免費產品介紹： Ruberep 異步、多master與多平台解決方案，適用於Postgresql與MySQL，奠基於trigger，不支援DDL、User與Grants Pgpool II 是個中介軟體。主要功能如下： Connection pool Replication Load balancing Automatic failover Parallel queries Limiting Exceeding Connections Bucardo 描述功能看起來很強大，但缺點也不少，暫不考慮 PostgresXL 只能用一個awesome形容，PostgressXL屬於企業集架構的大型叢集，前身是 Postgres-XC ，功能強大， 效能卓越 ，但因為採用shared nothing、分散式表格儲存(也就是多筆資料會分別儲存到不同節點，所以她的查詢是採平行處理，速度快，但也就是節點要比較多)，成本相對也不便宜。 這裡有人做了個 Lab 可以參考。 另外Postgres官方也列出了各種HA,Load Balance與複製方式的 比較表 ： 看起來pgpool-II是個不錯的選擇，以下是個合適的架構 pgpoo-II有多種 ...
閱讀完整內容