在ASP.NET Atlas中创建自定义的Transformer

english version: http://dflying.dflying.net/1/archive/110_build_your_own_transformers_in_aspnet_atlas.html

asp.net atlas中的绑定（binding）是一种将两个对象连接起来的强大方法。（您可以参考http://dflying.cnblogs.com/archive/2006/04/04/366900.html得到更多关于绑定的信息。）atlas绑定会自动将源对象上变化了的属性应用到目标对象的指定属性上。但有时候您会希望在应用到目标对象之前对这个属性进行一些修改。比如，当显示一个有索引的列表时，您可能希望这个索引从1开始递增，而不是javascript中默认的从0开始。这时候您就需要使用atlas transformer了。atlas中的transformer是一种类似管道的东西，它将插入到由源对象的属性向目标对象的属性赋值的过程中，以期对将要赋值的属性进行必要的过滤/装饰/转换（在这里是将源属性加1），然后再赋值给目标属性。

atlas提供一些内建的transformer，例如add，multiply，compare等。然而在实际开发中，大多数情况下我们都需要定义自己的transformer。让我们通过开发一个custombooleantransformer的例子来熟悉如何书写自定义的transformer。

custombooleantransformer用来将布尔值转换为我们自定义的格式，例如yes/no或者completed/inprogress。如果我们选择使用绑定来将一个布尔值显示给用户，那么这个transformer将会是十分有用的，它带给用户更加友好的用户体验。

大体上，创建一个transformer将有如下四个步骤：

取得从源绑定对象中传入的将被转换的值。这里我们首先调用get_value()取得传入的值，并将其转换为布尔型。
取得transformer的参数。这里的参数是一个可以被逗号（，）分成两部分的字符串。布尔值true将被转换为第一部分，false将被转换为第二部分。如果传入的参数为空，则用默认的字符串true/false代替。
进行转换。在这个步骤应当通过您自己的逻辑把传入的值转换成将要传出的值（一般会用到上一步骤中取得的transformer的参数）。这里我们首先用逗号（，）将参数分成两个部分，然后用第一部分代替true，用第二部分代替false。如果参数不能被分成两个部分，那么使用true/false代替。
将转换后的值输出，调用方法set_value()来实现。
下面是custombooleantransformer的javascript代码，将其保存为custombooleantransformer.js。

sys.bindingbase.transformers.customboolean = function(sender, eventargs) {
    // step 1, get input value.
    var value = eventargs.get_value();
    if (typeof(value) != 'boolean') {
        value = boolean.parse(value);
    }
   
    // step 2, get arguments will be used in trasforming.
    var customstring = eventargs.get_transformerargument();
    if (customstring == null || customstring == '') {
        customstring = 'true,false';
    }
   
    // step 3, do the transformation.
    var customvalues = customstring.split(',');
    if (customvalues.length != 2)
    {
        customvalues[0] = 'true';
        customvalues[1] = 'false';
    }
    var newvalue = value ? customvalues[0] : customvalues[1];
   
    // step 4, set the transformed value as output.
    eventargs.set_value(newvalue);
}

ok，现在让我们测试一下这个custombooleantransformer。在页面上添加一个checkbox和一个textbox并将他们绑定起来。当checkbox被选中/取消选中时，textbox中会显示相应的被转换后的布尔值。

下面是aspx文件中的html定义。不要忘记在scriptmanager中添加对custombooleantransformer.js文件的引用。

<atlas:scriptmanager id="sm1" runat="server">
    <scripts>
        <atlas:scriptreference path="custombooleantransformer.js" />
    </scripts>
</atlas:scriptmanager>
<input id="mycheckbox" type="checkbox" />
<input id="mytextbox" type="text" />

下面是atlas脚本定义。这里指定tranformerargument为‘yes,no’，以期让布尔值true转化为yes，false转化为no。 <page xmlns:script="http://schemas.microsoft.com/xml-script/2005">
    <references>
    </references>
    <components>
        <checkbox id="mycheckbox" />
        <textbox id="mytextbox">
            <bindings>
                <binding datacontext="mycheckbox" datapath="checked" 
                property="text" transform="customboolean" transformerargument="yes,no" />
            </bindings>
        </textbox>
    </components>
</page>