JML起步---使用JML 改進你的Java程序(2)

內容: 來自:http://www-106.ibm.com/ 作者:Joe Verzulli 量詞（Quantification）（譯者注：這里量詞的意思與邏輯學上的量詞意思相近，而不是普通意義上理解的量詞。）在上面pop()方法的行為規范中，我們說它的返回值要等于peek()方法的返回值，不過我們并沒有看到關于peek()方法的規范。PriorityQueue中peek()方法的行為規范請看下面的代碼： 代碼段3 PriorityQueue 中peek()方法的行為規范 /*@ @ public normal_behavior @ requires ! isEmpty(); @ ensures elementsInQueue.has(result); @*//*@ pure @*/ Object peek() throws NoSuchElementException; JML標記要求只有當隊列中至少含有一個元素的時候，才能調用peek()方法，同時他還要求方法的返回值必須在elementsInQueue之內，也就是說，這個返回值一定是這個隊列中的一個元素。 注釋/*@ pure @*/ 表明peek()方法是一個純方法（pure method），純方法是指沒有副作用的方法。JML中只允許使用純方法進行斷言確認，所以我們把peek()聲明為純方法，這樣我們就可以在pop()方法的后置條件中使用peek()方法。大家肯定想知道，為什么JML只允許使用純方法進行斷言確認？問題是這樣的，如果JML允許使用非純方法進行斷言確認的話，我們稍不注意就會寫出有副作用的行為規范。比如說可能會有這么一種情況，開啟了斷言確認以后，我們的代碼正確無誤，可是如果禁止了斷言確認后，我們的代碼卻不能運行了，或運行出錯了。這樣當然不行！后面，我們還會進一步討論副作用的問題。關于繼承 JML行為規范可以被子類（含子接口）或者是實現接口的類所繼承，這一點與J2SE1.4中斷言有所不同。JML關鍵字 also表示當前定義的行為規范與祖先類或被實現的接口中所定義的行為規范一起作用。因而，在 PriorityQueue接口定義的 peek()方法的行為規范同樣適用于 BinaryHeap類中的 peek()方法。這個就意味著，雖然在 BinaryHeap.peek()的行為規范中沒有明確定義， BinaryHeap.peek()的返回值也必須在 elementsInQueue當中。 大頂堆和小頂堆（譯者注：大頂堆和小頂堆是數據結構里面的概念，分別表示堆排序方法的不同實現方式。堆排序是一種通過調整二叉樹進行排序的方法。）上面我們給peek()定義的行為規范明顯缺少了一塊，那就是我們根本沒有要求它返回的那個元素具有最大的優先級。顯然，JCCC的PriorityQueue接口既可以用于大頂堆，也可以用于小頂堆。大頂堆和小頂堆的表現是有些差別的，在小頂堆中優先級最高的元素值最小，而大頂堆中優先級最高的元素值最大。因為PriorityQueue并不知道自己被用來進行大頂堆排序還是小頂堆排序，所以指定返回哪個元素的規范必須在實現PriorityQueue接口的類中進行定義。 在JCCC 中，類 BinaryHeap實現了PriorityQueue接口。BinaryHeap允許使用它的客戶代碼在構造函數中通過一個參數來指定排序方案，也就是通過參數來指定是通過大頂堆方式排序還是通過小頂堆方式排序。我們使用一個boolean模型變量isMinimumHeap來判斷BinaryHeap的排序方式是大頂堆還是小頂堆。下面的例子是BinaryHeap使用isMinimumHeap給peek()方法定義的行為規范： 代碼段4 BinaryHeap 類中peek()方法的行為規范 /*@ @ also @ public normal_behavior @ requires ! isEmpty(); @ ensures @ (isMinimumHeap ==> @ (forall Object obj; @ elementsInQueue.has(obj); @ compareObjects(result, obj) @ @ (forall Object obj; @ elementsInQueue.has(obj); @ compareObjects(result, obj) @>= 0)); @*/public Object peek() throws NoSuchElementException 使用量詞上面代碼段4中的后置條件包含兩個部分，分別用于大頂堆和小頂堆的情況。“==>符號的意思是包含（譯者注：這個包含與邏輯學中包含的意思一致）。x ==> y 當且僅當y為真或x為假時取真值。對于小頂堆排序來說，適用下面所列的代碼： (forall Object obj; elementsInQueue.has(obj); compareObjects(result, obj) @ (result == ((Comparable) a).compareTo(b)) && @ (comparator != null) ==> @ (result == comparator.compare(a, b)); @ @ public pure model int compareObjects(Object a, Object b) @ { @ if (m_comparator == null) @ return ((Comparable) a).compareTo(b); @ else @ return m_comparator.compare(a, b); @ } @*/ compareObjects方法的定義中使用了另外一個關鍵字model，它的意思是compareObjects方法是一個模型方法。模型方法是只能用在行為規范中的JML方法。模型方法定義在Java的注釋中，所以常規的Java代碼不能使用。 如果BinaryHeap類的客戶代碼指定了一個特殊的Comparator用來進行比較的話，m_comparator就指向那個Comparator，否則m_comparator的值就是null。compareObjects()方法檢查m_comparator的值，然后采用適當的方法進行元素間的比較。 模型域如何取值在代碼段4中我們討論了peek()方法的后置條件。這個條件保證peek()方法的返回值的優先級大于或者等于模型域elementsInQueue中所有的元素的優先級。那么有一個問題，像elementsInQueue這樣的模型域如何取值？前置條件、后置條件和不變量都是沒有副作用的，所以不能使用它們來設置模型域的值。 JML使用一個represents語句把模型域與具體的實現域關聯起來。比如下面的represents語句用來給模型域isMinimumHeap賦值： //@ private represents isMinimumHeap