### 12.4.1. Foreach 循環 \#foreach 元素允許進行循環，例如： ``` <ul> #foreach( $product in $allProducts ) <li>$product</li> #end </ul> ``` 這個\#foreach 循環將導致$allProducts 列表 (對象) 為查詢所有的產品$products (目標)遍歷一遍。每次經過循環，從$allProducts取得的值將置于$product 變量之中。 $allProducts 變量的內容是一個矢量，一個哈希表或者數組。賦給$product 變量的值是一個Java 對象并且可以從一個類似的變量引用。例如，如果 $product 真是一個Java的產品類，其名稱可以通過引用$product.Name 方法來檢索(即: $Product.getName())。 我們假定 $allProducts 是一個哈希表。如果你想檢索關鍵字的值或者在哈希表中的對象，你可以使用以下的代碼： ``` <ul> #foreach( $key in $allProducts.keySet() ) <li>Key: $key -> Value: $allProducts.get($key)</li> #end </ul> ``` Velocity 提供一個更容易的方式或的循環計數，以便你可以做下面類似的工作： ``` <table> #foreach( $customer in $customerList ) <tr><td>$velocityCount</td><td>$customer.Name</td></tr> #end </table> ``` 循環計數變量的缺省名稱是$velocityCount，在velocity.properties 配置文件中標明。默認情況下，該變量從1開始計數，但是可以在velocity.properties 文件中設為從0或者1開始。下面是velocity.properties 文件中循環變量設置一節: ``` # Default name of the loop counter # variable reference. directive.foreach.counter.name = velocityCount # Default starting value of the loop # counter variable reference. directive.foreach.counter.initial.value = 1 ```