Month: December 2007

在研究過之後，我決定在 ScaffoldHelper.cs 裡面添加 GetText 這個函數，用來取得字串。

#region Localization helpers
public string GetText( IResource resource, string str )
{
if( resource==null )
return str;
object resStr = resource[ str ];
if( resStr==null )
return str;
return resStr.ToString();
}
#endregion

這樣在 .vm (template)檔案裡面，就可以這麼使用，以取得本地化後的字串：

$ScaffoldHelper.GetText($textres, "Name" )

當然你還是可以用原先的方法：

$textres.Name

所以 PageBrowser() 也可以跟著修正為：

#region Pagination helpers
public string PageBrowser( Page page )
{
return PageBrowser( page, null );
}
public string PageBrowser( Page page, IResource resource )
{
StringWriter output = new StringWriter();
PaginationHelper helper = new PaginationHelper();
helper.SetController(this.Controller);
string firstText = GetText( resource, "First" );
string prevText = GetText( resource, "Previous" );
string nextText = GetText( resource, "Next" );
string lastText = GetText( resource, "Last" );
if (page.HasFirst)
output.Write(helper.CreatePageLink(1, firstText ));
else
output.Write( firstText );
output.Write(" | ");
if (page.HasPrevious)
output.Write(helper.CreatePageLink(page.PreviousIndex, prevText ));
else
output.Write(prevText);
output.Write(" | ");
if (page.HasNext)
output.Write(helper.CreatePageLink(page.NextIndex, nextText ));
else
output.Write( nextText );
output.Write(" | ");
if (page.HasLast)
output.Write(helper.CreatePageLink(page.LastIndex, lastText ));
else
output.Write( lastText );
return output.ToString();
}
#endregion

最後在資源檔裡面加上必要的字串並且修改 .vm (template)以後，就可以得到本土化後的結果。

這一次要講的是 Localization，不幸的是 Generator 沒有考慮到 Localization 問題，所以由 Generator 產生出來的代碼，並不包含這部份，但這卻是一個很好的機會讓我去了解 Generator 與 monorail 底下的機制。

Castle官方網站上已經有介紹該怎麼 Localization：Resources and Localization，但不幸的是，他使用 Visual Studio.Net 作為範例，Visual Studio.Net 已經掩蓋了所有細節。
在研究官方文件與相關文件之後，以下是我的步驟。

首先，你要先在 app/controllers 加上：

[Resource("textres", "ToDo.categories")]

這表示在 view(template) 那兒使用 $textres 就可以存取資源檔的內容。

所以在 app/views/categories/list.vm 裡，就可以把必要的字串改用$textres.字串名稱替代掉，這裡我就不列出整個 list.vm 了，只列出幾行：

<!--略-->
$HtmlHelper.LinkTo( $textres.AddNewCategory, "categories", "new")
<!--略-->
$HtmlHelper.LinkTo( $textres.View, "categories", "view", $category.Id)
<!--略-->
$HtmlHelper.LinkTo( $textres.Edit, "categories", "edit", $category.Id)
<!--略-->
$AjaxHelper.LinkToRemote( $textres.Delete, "delete.aspx", $DictHelper.CreateDict("with='id=$category.Id'", "condition=confirm('Delete?')", "onsuccess=new Effect.Fade('category$category.Id')"))
<!--略-->

然後我選擇在 app/ 下建立一個 resources 目錄，用來放置資源檔：

;Filename: categories.txt
;Language: en-US
View=View
Edit=Edit
Delete=Delete
AddNewCategory=Add a new Category

;Filename: categories.zh-tw.txt
;Language: zh-tw
View=檢視
Edit=編輯
Delete=刪除
AddNewCategory=加新類別

這裡要特別注意，把文字檔的編碼存為 unicode 或是 utf-8，否則會有亂碼出現。

最後修改 default.build，以便把資源檔編譯進去，這裡我也只列出關鍵的幾行：

<!--略-->
<target name="build" description="Compile all source files">
<mkdir dir="${dir.bin}" />
<copy flatten="true" todir="${dir.bin}">
<fileset>
<include name="${dir.lib.castle}/**" />
<include name="${dir.lib.npgsql}/**" />
<include name="${dir.lib.mysql}/**" />
<include name="${dir.lib.migrator}/**" />
<include name="${dir.lib.nunit}/nunit.framework.dll" />
</fileset>
</copy>
<resgen todir="${dir.src.app}/resources/">
<resources>
<include name="${dir.src.app}/resources/*.txt" />
</resources>
</resgen>
<csc target="library" output="${dir.bin}/${project::get-name()}.dll">
<sources>
<include name="${dir.config}/Boot.cs" />
<include name="${dir.src.app}/**/*.cs" />
<include name="${dir.src.test}/**/*.cs" />
<include name="${dir.migrations}/**/*.cs" />
</sources>
<resources basedir="." prefix="ToDo">
<include name="${dir.src.app}/resources/*.resources"/>
</resources>
<references basedir="${dir.bin}">
<include name="System.Web.dll" />
<!--略-->

最重要的就是 resgen 這個區塊與 csc 裡面的 resources 區塊，resgen 是把文字檔轉換為 .resources 資源檔，而 csc 裡面的 resources 則是表示要把產生出來的 .resources 編譯進去。

好了，該修改的都修改了，接下來就是重新建立，輸入 nant 就會自動重新編譯。
有點美中不足的是，下面顯示頁次的部份仍然是英文，這是因為這些字串被寫死在 ScaffoldHelper.cs 裡面，我想下次再來修改這部份。

後記：

• csc resources 所指定的 prefix 與 [Resource(“textres”, “ToDo.categories”)] 的第二個參數息息相關，不妨修改來試試看。
• 網站文件有提到 LocalizationFilter 的部份，但是用了卻不行，有待繼續研究。

接下來，就參考這篇有名的 Four Days on Rails 來試試看吧～
首先呢，由於隔了這麼久才寫這篇，所以 Generator 改位置了，你得從這裡：http://svn.castleproject.org:8080/svn/castle/trunk/Experiments/Generator/ Checkout，其他大致都跟上篇一樣。

1. 先利用 monorail ToDo，建立專案，接著依照上篇文章作必要的設定，同時我們使用 rc2，不使用最新的版本(也就是你不用更動 default.build)，設定的部份就不再贅述。
2. 建立資料庫，這邊我是用MySQL，建立的資料庫名稱是 ToDoDev，不過這只有跟修改連線字串有關係。
3. 修改資料庫的連線字串，連線字串是放在 config/databases/ 下的 ActiveRecord 設定檔裡面，你可以看到這邊有兩個設定檔，他很貼心的把開發用與測試用的資料庫分開：development.xml、test.xml，事實上，你還可以增加一個 Production (或是其他名字)的 ActiveRecord 設定檔，表示這是正式上線用的資料庫。切換的時候，可以更動 config/boot.cs 以決定使用哪個 ActiveRecord 設定檔，預設是 development。
4. 建立 Model，首先先產生”Category”，Category 的欄位如下：
   

   id int autoincrement
   name varchar(255)
   created_on datetime
   updated_on datetime

   ，在專案的目錄下輸入：script\generate model Categories name created_on updated_on，這邊要注意的是，不需要特別寫 id，因為慣例至上，Generator會自動幫你增加 Id 這個欄位。Generator 會幫你作三件事情：產生 Category 這個類別、產生測試 Category 的 Unit test 類別以及建立資料表格的程式，你可以從指令的輸出結果很清楚的看到。

   exists app\models
   create app\models\Categories.cs
   exists test\models
   create test\models\CategoriesTest.cs
   create db\migrations
   create db\migrations01_AddCategoriesTable.cs

5. 接下來，要去修改 Categories 類別的屬性型態，Generator 預設都是把型態設為字串，db\migrations 那邊則都是建立 varchar(50)。所以除了 app\models\Categories.cs 要修改型態之外，db\migrations01_AddCategoriesTable.cs 下也要改！這邊把 Name 改為 255 個字元，created_on與updated_on 則改為 DateTime。
6. 都修改完畢之後，就可以執行 nant migrate，這個步驟會幫你去實體資料庫作必要的事情。為甚麼要這樣子作？我想是因為一般資料庫的 script 是沒有作管理的，因此，才刻意把這些要去資料庫建立表格、修改欄位等的動作都放到 db\migrations 下，以便把這些程式也都納入版本控制。
7. 執行 script\generate scaffold Category，這個步驟會一口氣幫你把 CRUD 的頁面都弄出來。
8. 那麼，就編譯吧，直接執行 nant，只是卻出現了…
   

   [csc] app\controllers\CategoriesController.cs(36,72): error CS0246: 找不到型別或命名空間名稱 ‘Category’ (您是否遺漏 using 指示詞或組件參考?)
   [csc] app\controllers\CategoriesController.cs(56,45): error CS0246: 找不到型別或命名空間名稱 ‘Category’ (您是否遺漏 using 指示詞或組件參考?)

   這個，得去修改 CategoriesController.cs，把 Category 都改為 Categories，這看來是 Generator 的問題。接著又再出現

   error CS1501: 方法 ‘CreatePagination’ 沒有任何多載使用 ‘2’ 個引數

   ，唉～這個錯誤訊息實在是太黯然又太銷魂…你必須再次修改 CategoriesController.cs，添加這兩行：

   using System.Collections;
   using System.Collections.Generic;
   

   然後把

   PropertyBag["categories"] = PaginationHelper.CreatePagination( Categories.FindAll(), 10);

   改為

   PropertyBag["categories"] = PaginationHelper.CreatePagination( (IList)Categories.FindAll(), 10);

   ，接下來應該就沒問題了。

9. 先試試看到目前為止的成果吧，輸入script\server，然後打開你的瀏覽器，在位址列輸入：http://localhost:8080/categories/list.aspx，就能看到結果了。

執行結果：