Mockingbird Data Environment

本仓库托管Mockingbird Data Environment，这是一个开源项目，由Gilt Groupe在Mockingbird Toolbox项目的基础上构建，为iOS和Mac OS X应用程序提供动态数据处理引擎。

Mockingbird Data Environment允许为任意数据模型和对象图指定名称并将它们存储在一个变量空间中，从中可以通过表达式提取值。

Mockingbird Data Environment特别适用于构建能够适应服务器端数据模型变化的应用程序。

• 将Mockingbird Data Environment添加到您的项目
• 使用Mockingbird Data Environment
• 目录

关于Mockingbird Data Environment

对于iOS应用程序发布商，通常会有一个预装的旧版本用户群体。常常因为当前版本需要比他们的硬件支持的iOS更新的版本，所以用户可能会卡在旧版本上。在这种情况下，除非他们购买新设备，否则他们不会运行您最新的应用程序版本。

对于某些类型的应用程序，这不是一个大问题。但对于需要与基于网络的在线服务通信的应用程序，广泛的旧版本可能会导致服务的演变和维护变得困难。

最终，您将面临以下权衡之一

• 放弃对旧版本的支持，知道这可能存在无法与部分用户保持重要关系的风险吗？

• 承担随着时间的推移而增加的维护和运营大量旧版后端服务的费用和难度吗？

• 或者，让自己永远放弃后端系统的演变——或远远慢于您所希望的演变？

Mockingbird Data Environment的目的是让您免于做出这些妥协。

问题的根源

通常iOS应用程序的架构是，客户端应用和服务器必须事先就用于通信的数据架构达成一致。在客户端，编写原生代码实现从中提取有意义信息的逻辑。

这种架构的问题是客户端和服务器都需要深入了解数据模式。

有些人试图通过自动从数据模式生成客户端代码的解决方案来解决这个问题。虽然这无疑很方便，可以节省时间，但原始问题依然存在：数据格式的知识必须编译到客户端应用程序中，因此一旦应用程序发布后就不能更改。你仍然需要面对一些用户正在运行非常旧的应用程序版本，他们希望能够与你的服务进行通信。

理想情况下，数据的模型知识只需要在一个地方维护。遗留应用程序的长尾巴给我们一个充分理由避免将知识硬编码到客户端，因此我们应该寻找由服务器驱动的解决方案。

如果你考虑客户端应用程序真正需要了解的内容，那不是服务器发送的数据结构的细节，而是一组特定信息，这些信息嵌入在数据结构中。数据结构仅仅是应用程序需要与服务器通信的副产品。

例如，一个应用程序可能对产品列表感兴趣，但产品列表是从特定JSON结构下的三个级别的数据中组装而成的这一事实是偶然的。

解决方案

Mockingbird数据环境允许你构建应用程序，其中服务器可以托管用于导航其返回的数据结构所需的所有逻辑。服务不仅可以返回数据模型，还可以返回一组用于从数据模型中提取有意义信息的表达式。

基本上，服务器的响应告诉客户端应用程序两件事：“这里有一个包含你需要的信息的数据结构，以及如何提取对你相关的部分。”

因为所有内容都托管在服务器上——无论是数据模型还是解释该数据模型的知识——所以每个安装的应用程序版本都可以在部署新的数据模型时自动适应。

每次你更改服务通信方式时，你不需要重新提交应用程序进行审查，也不需要运行多个后端版本来支持你的应用程序的旧版本。

让Mockingbird数据环境将你的原生代码与服务器端数据的细节解耦，你可以在自己的时间表上发展你的服务，而那些被遗忘的版本的应用程序将不断工作。

这种技术于2014年8月11日在iOSoho开发者研讨会上进行了更详细的讨论。（有关幻灯片，请参阅Gilt科技博客http://tech.gilt.com/post/94663143169/handling-changes-to-your-server-side-data-model。）

目录

1. 与您的项目集成
2. 初始化Mockingbird数据环境
3. Mockingbird表达式简介
   1. 评估表达式
      1. 字符串表达式
      2. 对象表达式
      3. 数字表达式
      4. 布尔表达式
      5. 表达式上下文
         1. 强制数字上下文
         2. 强制布尔上下文
         3. 引用
         4. 转义序列
      6. 其他变量引用符号
         1. 花括号符号
         2. 括号符号
         3. 括号符号
      7. 变量符号摘要
   2. MBML函数
   3. 调试表达式
      1. 调试用的MBML函数
      2. 在Xcode调试器中评估表达式
4. MBML文件简介
   1. 清单文件
   2. MBML文件的结构
   3. MBML声明类型
      1. 包含
      2. 变量
         1. 具体变量
         2. 单例变量
         3. 动态变量
      3. 函数
5. 进一步阅读
6. 关于Mockingbird库
   1. 鸣谢
   2. 版权 & 许可证

与项目集成

目前，将Mockingbird数据环境集成到项目中的唯一官方支持的方法是使用CocoaPods。

（你可以从MBDataEnvironment.xcworkspace中构建一个实验性但不受支持的MBDataEnvironment.framework，用于iOS 8。）

如果你还没有使用CocoaPods，可以在CocoaPods网站上找到文档来帮助你入门。

一旦你的CocoaPods启动并运行，你只需将以下行添加到你的Podfile中，就可以将Mockingbird数据环境添加到你的项目中

pod 'MBDataEnvironment'

然后，从你的项目目录中执行以下命令来安装CocoaPod

pod install

重要：注意pod install命令的输出。如果你以前没有使用Xcode工作区为你的项目，CocoaPods将为你创建一个包含你的项目以及任何已安装的CocoaPods的工作区。从现在开始，你将需要使用该工作区而不是旧的项目文件进行开发。

运行pod install命令后，你将能够在项目中引用Mockingbird数据环境。

你应该使用“库头文件”导入注解来引用头文件。为了方便，你可以引用整体头文件，这确保了你将能够访问Mockingbird数据环境的整个公共API。

#import <MBDataEnvironment/MBDataEnvironment.h>

将来，我们可能会发布Mockingbird数据环境的二进制发布版，作为iOS框架；使用上述注解将允许你无缝过渡到使用框架。

初始化Mockingbird数据环境

在使用Mockingbird数据环境之前，你的应用程序首先加载一个MBEnvironment实例。

这样做最简单的方法是加载默认环境

[MBEnvironment loadDefaultEnvironment];

默认环境包含使用Mockingbird数据环境所需的所有内容。

你也可以提供一个包含附加声明的清单文件，允许你在加载时自定义环境的初始状态。

清单是一个XML文件（通常命名为manifest.xml），其中包含用于自定义和配置Mockingbird环境的MBML标记。

MBML是一个XML文档格式，其名称代表.mockingbird.markup.language。该格式在下面的MBML文件简介中描述。

如果你的应用程序在其资源中提供了manifest.xml文件，则可以加载环境，而不是调用loadDefaultEnvironment

[MBEnvironment loadFromManifest];

加载环境后，你可以在变量空间中填充数据，并使用表达式与该数据进行交互。

Mockingbird表达式的介绍

Mockingbird表达式是包含零个或多个字面量或表达式标记的字符串。

根据上下文，Mockingbird表达式可以包含

• 文本字面量
• 数字字面量
• 对任何Objective-C类型的变量的引用
• 基本数学表达式
• 布尔逻辑表达式
• 函数调用

将表达式解析为特定值（值）的过程称为评估。在评估过程中，字面量将被传递而不受影响，但遇到的任何表达式标记都将被它们在评估时的代表值所替换。

评估表达式的主要API是通过几个MBExpression类方法

Mockingbird 表达式的一个可能用途是在填充用户界面视图时执行字符串替换，例如 UILabel

    UILabel* greeting = // created elsewhere
    greeting.text = [MBExpression asString:@"Hello, $userName!"];

上述代码中，greeting 标签的 text 属性将被设置为评估字符串表达式 "Hello, $userName!" 的结果。

这个特定的表达式由三部分组成：一个文本字面量("Hello,")，接着是 Mockingbird 变量 userName 的引用，最后是另一个文本字面量("!")。

当表达式被评估时，表达式的 "$userName" 部分将被替换为活动变量空间中 userName 变量的值。

如果 userName 的值是 "Cooper"，那么标签将显示文本 "Hello, Cooper!"。

在本文档中，记法 $variableName 可以根据上下文读作 "活动变量空间中名为 variableName 的变量"，或者 "对活动变量空间中名为 variableName 的变量值的引用"。

变量空间

变量空间 是 Mockingbird 变量值存储的地方。

任何本地运行时对象实例都可以存储在 Mockingbird 变量空间中。当一个对象存储在变量空间时，它与一个 变量名 组配，并被考虑为一个 变量值。

In Objective-C，变量值可以通过键值索引符号在变量空间中进行暴露

[MBVariableSpace instance][@"cats"] = @[@"Barrett", @"Duncan", @"Gabby"];

上述代码将 $cats 与包含三个项的 NSArray（字符串 "Barrett"，"Duncan" 和 "Gabby"）关联。

你还可以使用 MBML 清单文件在环境加载时预先填充变量空间。使用清单文件允许你避免在每次应用程序启动时都需要程序性地填充变量空间中的常用值。

为了确保 Mockingbird 环境始终有相同值的 $cats，你可以在清单中添加此 变量声明

<Var name="cats" type="list" mutable="F">
    <Var literal="Barrett"/>
    <Var literal="Duncan"/>
    <Var literal="Gabby"/>
</Var>

mutable="F" 属性确保在运行时 $cats 不能被其他值覆盖。但是，它并不能保证 underlying 对象实例的不可变性。

有关清单文件的更多信息，请参阅下面的 清单文件。

变量引用

最基本的非字面量表达式形式是 简单变量引用，其中变量名前面有一个美元符号

$cats

当一个对象通过变量空间提供时，不仅对象实例本身可以通过表达式访问，其属性、任何可使用键值编码（KVC）访问的值，以及如果相关对象是数组或字典，其内容也可以访问。

您可以通过 变量子引用 访问这些子值，这些子引用可以采用以下两种形式之一：点访问器和方括号访问器。

点访问器

您可以使用 点访问器 访问对象的属性值或 KVC 值。例如，要确定 $cats 数组中的对象数量，你会使用以下表达式

$cats.count

当评估该表达式时，Mockingbird表达式引擎会访问$cats的底层NSArray值的count属性，并返回该值。在本例中，$cats.count的值将是一个包含整数值3的NSNumber。

Mockingbird表达式引擎不直接处理原始值(非对象)。因此，原始类型被包装在其等效的Cocoa类中。NSUInteger和BOOL等，就被包装在NSNumber实例中。

方括号访问器

要访问数组或字典中包含的项，您将使用方括号访问器

$cats[1]

上面的表达式会返回$cats数组索引为1的对象。由于数组索引是从0开始的，这实际上是数组中的第二个条目：字符串 "Duncan"。

引用越界数组索引的表达式将返回值nil。

也可以将子引用链接在一起

$cats[1].length

此表达式返回$cats数组中索引为1的对象的length属性值。

在本例中，返回的值将是数字6，这是字符串 "Duncan"的长度。

方括号访问器在字典中作用类似。例如

[MBVariableSpace instance][@"catGenders"] = @{@"Barrett": @"female",
                                              @"Duncan":  @"male",
                                              @"Gabby":   @"female"}];

在上面的代码中，我们创建了一个将猫名映射到性别的字典，并将其与变量$catGenders关联。

要访问任何特定猫的性别，我们可以使用方括号记法来获取给定字典键关联的值

$catGenders[Barrett]

此表达式返回字符串 "female"。

评估表达式

根据变量空间中的数据和您需要如何使用它们，MBExpression类提供了一些方法来根据以下以下表达式类型之一评估表达式

字符串表达式

如果您正在评估一个预期会产生字符串的表达式，您应该使用MBExpression提供的asString:类方法之一

NSString* gender = [MBExpression asString:@"$catGenders[Barrett]"];

将表达式$catGenders[Barrett]作为字符串进行评估，确保返回值将是NSString或nil。

在此特定情况下，NSString变量gender将包含值"female"。

如果底层对象不是NSString实例，则会尝试将值强制转换为字符串。

字符串插值

当编写字符串表达式时，您可以在表达式内包含文本字面量。您可以将文本字面量视为其结果与其原始形式相同的结果表达式。

当评估字符串表达式时，表达式内的任何文本字面量都会原样返回，而任何变量引用都将被评估并替换为其结果值。这被称为字符串插值。

例如，考虑以下表达式

NSString* barrett = [MBExpression asString:@"Barrett is a $catGenders[Barrett] cat."];

在这里，字符串"Barrett is a"和"cat."是文本字面量，而"$catGenders[Barrett]"是变量引用。

因为字符串"$catGenders[Barrett]"代表变量引用，所以它将被其底层值替换；在这种情况下，字符串"female"。

变量 NSString 的 barrett 的结果值是 "Barrett is a female cat."

对象表达式

如果你在变量空间中有，比如说一个 NSArray 或一个 NSDictionary（如 $catGenders 的情况），你可以使用一个 对象表达式 来检索底层对象值。

NSDictionary* genders = [MBExpression asObject:@"$catGenders"];

NSDictionary 的变量 genders 现在引用的是与 $catGenders 相同的值。

因为 asObject: 方法返回的是通用对象类型 id，所以调用者有责任知道返回的对象类型，或者在使用之前进行适当的类型检查。

数值表达式

要检索数值变量的值或执行数学计算，你可以将表达式评估为 数值。

NSNumber* five = [MBExpression asNumber:@"5"];
five = [MBExpression asNumber:@"2 + 3"];
five = [MBExpression asNumber:@"8 - 3"];
five = [MBExpression asNumber:@"10 / 2"];
five = [MBExpression asNumber:@"2.5 * 2"];
five = [MBExpression asNumber:@"((5 * 2) - 5)"];

所有上面的表达式都返回一个包含值 5 的 NSNumber。

正如你所看到的，数值表达式可以包含基本的数学表达式。支持的运算符有 +、-、*、/ 和 %（取余）。运算符必须与周围的词元之间至少有一个空格字符。

默认情况下，在评估数学运算符时使用 C 语言顺序。可以使用括号分组来确保特定的评估顺序。

将表达式评估为数值也会处理将 Mockingbird 变量值转换为数值。在这里，NSNumber 变量 val 将包含整数值 5。

[MBVariableSpace instance][@"five"] = @(5);
NSNumber* val = [MBExpression asNumber:@"$five"];

在上面的代码中，@(5) 符号确保 Mockingbird 变量被设置为 NSNumber 实例。然而，作为 Mockingbird 变量基础的实例不需要是 NSNumber，只要表达式可以数值地评估。

在下面的代码中，我们正在将名为 five 的 Mockingbird 变量设置为一个包含文本 "5" 的 NSString。

[MBVariableSpace instance][@"five"] = @"5";
NSNumber* val = [MBExpression asNumber:@"$five"];

因为 Mockingbird 表达式引擎将尝试将非 NSNumber 类型的值转换为 NSNumber，所以 val 将包含整数值 5。

布尔表达式

当表达式在一个 布尔上下文 中被评估时，Mockingbird 表达式引擎认识到一组额外的运算符和比较器，以便实现布尔逻辑。

布尔运算符可以组合成复合形式。

MBVariableSpace* vars = [MBVariableSpace instance];
vars[@"catName"] = @"Barrett";
BOOL isFemale = [MBExpression asBoolean:@"$catName -AND $catGenders[$catName] -AND $catGenders[$catName] == female"];

在这个例子中，BOOL 变量 isFemale 将持有值 YES。

在布尔表达式中，也可以使用括号分组来确保特定的评估顺序。

除了预期的布尔运算符外，还支持一些布尔比较器。

比较器依赖于标准的 isEqual: 和 compare: 方法来完成其工作，但并不局限于这些方法。在某些情况下，可能会发生类型强制转换（例如，比较 NSString 与 NSNumber 时）。

例如

BOOL hasThreeCats = [MBExpression asBoolean:@"$cats.count == 3"];
BOOL hasAnyCats = [MBExpression asBoolean:@"$cats.count -GTE 1"];
BOOL theCatLady = [MBExpression asBoolean:@"!($cats.count -LT 7)"];

在这里，hasThreeCats 将是 YES，hasAnyCats 同样会是 YES，而 theCatLady 将是 NO。

最后，可以在布尔表达式上下文中使用两个布尔文字

这些值工作方式可能正如你所期望的那样

BOOL tValue = [MBExpression asBoolean:@"T"];
BOOL fValue = [MBExpression asBoolean:@"F"];

变量 tValue 将是 YES，而 fValue 将是 NO。

这使得你可以将布尔值存储在字符串中，并且它可以按预期的布尔值进行评估

[MBVariableSpace instance][@"featureFlag"] = @"T";

// somewhere later on...

if ([MBExpression asBoolean:@"$featureFlag"]) {
    // do something awesome with our great new feature
}

表达式上下文

四种表达式类型——字符串、对象、数字 和 布尔——都以不同的方式处理它们的输入和输出。因此，在 字符串上下文 中评估的表达式可能与在 布尔上下文 中评估的相同表达式产生不同的结果。同样，在 数字上下文 中有效的表达式可能在其他任何上下文中无效。

例如，像 -EQ、-LTE、-GT 等这样的标记仅在布尔表达式上下文中有效。当遇到不在布尔上下文中的情况时，表达式引擎将这些值视为文本文字。

如果你发现表达式没有按预期执行，请检查表达式上下文是否与你的假设一致。有关诊断问题的额外提示，请参阅下文中的 调试表达式。

有时，你可能想要混合上下文。例如，你可能想在包含数学计算的 UILabel 中显示一个字符串。或者你可能想在包含一些条件文本的消息中显示一个消息。

强制数字上下文

你可以使用以下表示法在任意其他表达式上下文中嵌入数字表达式：#( numeric expression )。

例如

[MBExpression asString:@"There are #(10 - 3) days in the week."];

这个表达式包括三个部分：文本文字 "There are"，然后是数字表达式 #(10 - 3)，之后是另一个文本文字："days in the week."。

如往常一样，文本文字按原样返回，但数字表达式将被如此评估，结果得到 7。因此，上面的表达式将返回字符串 "There are 7 days in the week."。

强制布尔上下文

您可以在非布尔上下文中使用以下符号来评估布尔表达式： ^if( 布尔表达式 | 真结果 [ | 假结果 ] )。

当遇到此符号时，布尔表达式 在布尔上下文中进行评估，并根据结果返回 真结果 或 假结果。

[MBExpression asString:@"You ^if($user.isAdmin|have|do not have) admin privileges"];

上述表达式的返回值取决于 $user.isAdmin 的 布尔上下文值。如果评估结果为 true，则返回值将是 "您有管理员权限"；否则，将返回 "您没有管理员权限"。

因为 真结果 或 假结果 可以是空字符串，所以上述表达式可以稍作修改，使结果更为简洁

[MBExpression asString:@"You ^if($user.isAdmin||do not )have admin privileges"];

这也等价于

[MBExpression asString:@"You ^if(!$user.isAdmin|do not |)have admin privileges"];

因为整个 假结果 子句是可选的，所以上述表达式可以通过移除最后的管道符号进一步缩短一位

[MBExpression asString:@"You ^if(!$user.isAdmin|do not )have admin privileges"];

当使用字符串插值时，表达式内的 nil 值被视为空字符串。

引号

在某些情况下，一个表达式中可能包含您不想被视为表达式一部分的字符。

例如，考虑以下字符串表达式

It will cost $total for your $quantity tickets to the Ke$ha concert

$ 字符表示变量引用的开始，所以虽然 $total 和 $quantity 正确识别为变量，但在名称 Ke$ha 中的文本 "$ha" 将被错误地解释为变量引用。

假设 $ha 没有值，则该表达式的输出将是我们不希望的结果 "Ke concert" 而不是 "Ke$ha concert"。

为了避免这个问题，您可以使用 引号 来确保表达式的某些部分不被评估。

要在表达式中引用一段文本，请使用以下符号： ^q( 要引用的文本 )。括号内的文本被视为文本字面量，并在评估包含引号的表达式时按原样返回。

下面是如何使用引号来修复上述表达式的方法

It will cost $total for your $quantity tickets to the ^q(Ke$ha) concert

当这个表达式被评估时，返回的字符串将正确地包含文本 "Ke$ha"，而不是仅仅包含 "Ke"。

转义序列

与引号类似的一种技术是使用 转义序列 来表示无法单独表示的字符。

例如，字符串 "$$" 是代表美元符号 $ 的转义序列。就像使用引号来确保 "Ke$ha" 被正确处理一样，这个转义序列也可以使用。

It will cost $total for your $quantity tickets to the Ke$$ha concert

以下转义序列被支持

其他变量引用符号

迄今为止，我们已看到一种变量引用形式，即 简单变量引用。此符号只能在变量名称被视为 标识符 时使用。标识符是如下构造的名称

• 第一个字符可以是大写 (A-Z) 或小写 (a-z) 字母字符或下划线 (_)。

• 后续字符可以是大写 (A-Z) 或小写 (a-z) 字母字符，数字 (0-9)，下划线 (_)，连字符 (-), 或冒号 (:)。

在有些情况下，简单的符号无法用于引用给定的变量，因为该变量的名称不是一个有效的标识符。

在其他情况下，您可能希望确保解析器能够识别变量名称与字面量或另一个表达式之间的边界。

对于这些情况，提供了一些额外的变量引用符号。

花括号表示法

花括号变量引用表示法可用于防止表达式引擎将变量引用之后的字符解释为引用本身的一部分。该表示法通过在大括号内包围变量名称来使用。

花括号表示法与简单表示法类似，它仅接受但也合法的标识符作为变量名称。表达式 $userName 和 ${userName} 都引用同一个变量，但它们使表达式评估器对变量引用之后的字符有不同的处理。

假设您有一个变量 $lastName，它包含一个人的姓氏，并且您想构造一个像“Butterfields 处得怎么样？”这样的消息，该消息使用复数形式的姓氏。

您不能使用未引用的表示法（例如，“How are the $lastNames doing?”），因为 $lastName 后的 s 字符会被解释为变量名称的一部分。并非引用变量 $lastName 后跟字符字面量 ，实际上表达式引用了一个完全不同的变量：$lastNames。

花括号表示法允许您将变量引用与应视为字面量任何周围的文本分开。使用这种表示法，表达式可以这样编写

How are the ${lastName}s doing?

这个表达式将被解释为文本字面量 "How are the" 后跟 $lastName 的值，然后是另一个文本字面量 "s doing?"。

方括号表示法

方括号变量引用表示法可用于访问名称不是有效标识符的 Mockingbird 变量。

例如，空格字符和美元符号（$）不是有效标识符字符。通常，在解析变量名称时遇到空格时，表达式引擎会假设该空格表示变量名称的结束。当表达式内遇到美元符号时，表达式引擎会假设它表示新变量引用的开始。

由于 Mockingbird 变量名称不 一定要 是标识符，所以方括号表示法存在是为了允许访问那些名称不是标识符的变量。

假设您的应用程序连接到一个后端系统，该系统引入了一个名为 total $ 的 Mockingbird 变量。您可以使用以下表达式来引用该变量的值

$[total $]

使用方括号表示法允许在闭合括号后进行子引用。假设变量 total $ 是一个字符串，以下表达式将返回该字符串的长度

$[total $].length

括号表示法

与方括号表示法一样，括号变量引用表示法可用于访问名称不是有效标识符的 Mockingbird 变量。就像花括号表示法一样，括号表示法可以防止表达式引擎误将相邻的字符解释为变量引用的一部分。

为了看到区别，考虑这两个表达式

$[total $].length
$(total $).length

上面的表达式使用的是方括号表示法，允许闭合括号后的子引用。下方的表达式使用的是括号表示法，不允许子引用。

由于括号表示法不允许子引用，因此任何出现在闭合括号之后的文本将被视为新语句的开始。在这种情况下，因为 ".length" 不是任何类型的有效表达式，它被解释为文本字面量。

所以，当使用 $[total $].length 时，会获取 total $ 的 length 属性值；而使用 $(total $).length 将会获取 total $ 的值后面跟着文本字面量 ".length"。

变量表示法摘要

MBML函数

MBML函数允许在Mockingbird表达式中调用原生的Objective-C代码。函数可以接受零个或多个输入参数，并且可以返回对象实例作为结果。

当评估包含函数调用的表达式时，实现函数的方法将被执行，并且该方法返回的值（如果有）将作为函数的结果产生。函数实现返回的值可以在表达式内部进一步操作。

函数调用以一个感叹号字符（^）开始，其后跟着函数名，并以括号内零个或多个用管道符分隔的参数列表结束。

例如，要调用一个创建数组的函数，可以编写

^array(pizza|pasta|sushi|lobster)

如果这个表示法看起来很熟悉，那是因为在上面的文档中你已经遇到了两个函数——《code>^if()` 和 ^q()`。

^array(pizza|pasta|sushi|lobster)[3]

$dictionary[$key].propertyValue.anotherValue[$arrayIndex]

^log(^log($dictionary)[^log($key)]).propertyValue.anotherValue[^log($arrayIndex)]

^test($Network.isWifiConnected) -AND ^test($Device.isRetina)

^tokenize(This $aint.no ^party())

--> Tokens for object expression "This $aint.no ^party()":
<MBMLLiteralToken@0x7f8ac03aaea0: "This " {0, 5}>
<MBMLVariableReferenceToken@0x7f8abce042a0: "$aint" {5, 5}> containing 1 token:
    0: <MBMLObjectSubreferenceToken@0x7f8ac0670a00: ".no" {10, 3}>
<MBMLLiteralToken@0x7f8ac036f4a0: " " {13, 1}>
<MBMLFunctionCallToken@0x7f8ac0645bb0: "^party()" {14, 8}>

^tokenizeBoolean(This != ^party())

--> Tokens for boolean expression "This != ^party()":
<MBMLInequalityTestToken@0x7fa93fb5fbe0: "!=" {5, 2}> containing 2 tokens:
    0: <MBMLLiteralToken@0x7fa93fb45970: "This" {0, 4}>
    1: <MBMLFunctionCallToken@0x7fa93fb4af80: "^party()" {8, 8}>

^tokenizeMath(($user.firstName.length + $user.lastName.length) + 1)

--> Tokens for math expression "($user.firstName.length + $user.lastName.length) + 1":
<MBMLAdditionOperatorToken@0x7fa940048b70: "+" {49, 1}> containing 2 tokens:
    0: <MBMLMathGroupingToken@0x7fa9400a87d0: "($user.firstName.length + $user.lastName.length)" {0, 48}> containing 1 token:
        0: <MBMLAdditionOperatorToken@0x7fa93ae86fd0: "+" {23, 1}> containing 2 tokens:
            0: <MBMLVariableReferenceToken@0x7fa93faf9400: "$user" {0, 5}> containing 2 tokens:
                0: <MBMLObjectSubreferenceToken@0x7fa940049ac0: ".firstName" {5, 10}>
                1: <MBMLObjectSubreferenceToken@0x7fa93fae4340: ".length" {15, 7}>
            1: <MBMLVariableReferenceToken@0x7fa93aeb8f70: "$user" {25, 5}> containing 2 tokens:
                0: <MBMLObjectSubreferenceToken@0x7fa93aea8d90: ".lastName" {30, 9}>
                1: <MBMLObjectSubreferenceToken@0x7fa93fa52f60: ".length" {39, 7}>
    1: <MBMLNumericLiteralToken@0x7fa94007d100: "1" {51, 1}>

[MBEnvironment loadFromManifest];

<MBML modules="...">

    <!-- declarations -->

</MBML>

<MBML modules="MBEventHandlingModule">

<Include file="onboarding.xml" if="$isFirstLaunch"/>
<Include file="landing.xml"/>

<Var name="currency" literal="$USD"/>

<Var name="price" value="#(99.99)"/>
<Var name="priceLabel" value="${currency}${price}"/>
<Var name="appLaunchTime" value="^currentTime()"/>

<Var name="useLargeImageSizes" boolean="$Network.isWifiConnected -AND $Device.isRetina"/>

<Var name="states" type="list" mutable="F">
    <Var literal="Alabama"/>
    <Var literal="Alaska"/>
    <Var literal="Arizona"/>
    ...
</Var>

<Var name="statesToPostalCodes" type="map" mutable="F">
    <Var name="Alabama" literal="AL"/>
    <Var name="Alaska"  literal="AK"/>
    <Var name="Arizona" literal="AZ"/>
    ...
</Var>

<Var name="UIApplication" type="singleton" class="UIApplication" method="sharedApplication"/>

<Var name="useLargeImageSizes" boolean="$Network.isWifiConnected -AND $Device.isRetina"/>

<Var name="useLargeImageSizes" type="dynamic" boolean="$Network.isWifiConnected -AND $Device.isRetina"/>

<Var name="inThePast" value="^currentTime()"/>
<Var name="alwaysNow" type="dynamic" value="^currentTime()"/>

<Function class="MBMLCollectionFunctions" name="mutableCopy" method="mutableCopyOf" input="object"/>
<Function class="MBMLDataProcessingFunctions" name="filter" input="pipedExpressions"/>
<Function class="MBMLDateFunctions" name="currentTime" input="none"/>
<Function class="MBMLStringFunctions" name="q" input="raw"/>