在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>