MonoRail - 前期准备

是时候动手做实验了. Hello world的例子已经有人写过随笔了, 所以有重复的就粗略说一下算了. 模板引擎暂时只讨论nvelocity.

创建项目

Caslte的安装包带有MonoRail项目模板，直接通过模板创建即可。vs2005需要装两个补丁：
http://download.microsoft.com/download/6/3/c/63c69e5d-74c9-48ea-b905-30ac3831f288/VS80sp1-KB926601-X86-ENU.exe  
http://download.microsoft.com/download/9/0/6/906064ce-0bd1-4328-af40-49dca1aef87c/WebApplicationProjectSetup.msi

手动创建一个MonoRail项目需要以下步骤

1. 添加引用

Castle.MonoRail.Framework.dll
Castle.MonoRail.Framework.Views.NVelocity.dll
NVelocity.dll
log4net.dll
Commons.dll

2. 创建文件夹

建议如下结构
Controllers: 存放Controller的源码
Models: 存放Model的源码, 或者Model另外建一个项目也好
Views: 存放模板文件

3. 编写web.config

< configSections >
     <!-- 定义section -->
     < section name = " monoRail "
                type = " Castle.MonoRail.Framework.Configuration.MonoRailSectionHandler, Castle.MonoRail.Framework "   />
</ configSections >
< monoRail >
     < controllers >
         <!-- 定义controller所在的assembly -->
         < assembly > MonoRailTest </ assembly >
     </ controllers >
     <!-- 定义模板文件的根目录和模板引擎的类型 -->
     < viewEngine 
        viewPathRoot = " views "  
        customEngine = " Castle.MonoRail.Framework.Views.NVelocity.NVelocityViewEngine, Castle.MonoRail.Framework.Views.NVelocity "   />
</ monoRail >
< system.web >
     < httpHandlers >
         <!-- 定义httpHandler, 让MonoRailHttpHandlerFactory接管指定扩展名的url -->
         < add verb = " * "  path = " *.rails "  
            type = " Castle.MonoRail.Framework.MonoRailHttpHandlerFactory, Castle.MonoRail.Framework "   />
         <!--  阻止模板文件被下载  -->
         < add verb = " * "  path = " *.vm "  type = " System.Web.HttpForbiddenHandler "   />
     </ httpHandlers >
</ system.web >

4. 在iis配置虚拟目录, 注册指定扩展名
如果还要跟Windsor结合，实现事务管理，日志，NHibernate等特性，还是用项目模板的向导创建一个吧。。。

让NVelocity支持中文

差点把这个忘了...默认NVelocity不支持中文, 只要在项目中添加名为nvelocity.properties的文件, 把文件放在views根目录，生成操作设为"嵌入的资源"并且在里面加上两行:（谢谢Maplye 指正存放位置的问题）
input.encoding=GB2312 //或其他支持中文的编码
output.encoding=GB2312
即可

优化编辑环境

在vs2003编辑nvelocity模板可不是所见即所得的, 一打开就一个白底黑字的文本编辑器. 右键点击一个.vm文件, 选择打开方式, 再选择HTML/XML编辑器, 再设为默认值, 即可享受xml语法高亮和自动闭合标记的功能.
要想更高级的享受, 就得靠别的工具了, 打开方式那里可以点击添加选择外部程序. FrontPage是一个很好的选择, 用了FrontPage之后, 它还不能辨认.vm是什么东西, 在FrontPage右键点击.vm文件, 选择打开方式/选择程序, 选择FrontPage (以HTML方式打开)即可用FrontPage去编辑. 这样就所见即所得编辑, 语法高亮, 语法提示统统都有了, 至于设不设成默认就是个人喜好了.
 

在vs2005把vm的默认编辑器设成html编辑器就能凑合用了，比vs2003好用的多。最近还出了个vm编辑的插件，能正确高亮vtl标记但没有自动提示功能
http://using.castleproject.org/display/Contrib/Castle+Visual+Studio+Integration