Three20学习已经有一段时间，并且用它开发了一个小西GoogleReader的原型。客观来说，Three20是一个相当不错的iOS第三方开发库，它简化了iOS开发过程，并且提供了很多不错的自定义的控件，对于iOS开发人员来说，应该是属于必学的开发库。当然，Three20也不全是优点，作为开发库来说，比较肥大，这点跟Qt倒是挺像的。
当然，学习之余，笔记也是重要，既帮助自己记录，也帮助别人参考。

简述

在iOS开发中，Navigation－based的App是最常用的开发模式。在一个iOS App中，我们不可能总是在一个固定的视图上就展示所有的数据内容，经常是需要多个视图。在UIKit框架种，UINavigationController和UITabBarController帮助我们iOS开发人员进行页面的导航和切换。但是，使用UINavigationController中，我们需要自己来掌握各个子Contoller的生命周期，过程较为繁琐。
在three20中，这些页面的导航功则由TTNavigator来帮助我们实现。

TTNavigator介绍

用three20文档的话来说，TTNavigator是内置了数据持久化的，基于URL的导航控制系统，它类似于Ruby on Rails’ routing，将URL链接地址存放在URL map中。当某个URL请求触发后，TTNavigator就会根据相应URL map来执行对应的代码，也就是你想显示以及如何显示视图。
同时，TTNavigator本身也是采用单例模式的，也就是说，一个App中只存在一个TTNavigator实例，以便我们方便使用。
可以用简单的代码来说明，这些代码应该位于你的应用程序的委托(Application Delegate)的applicationDidFinishLaunching：中

TTNavigator* navigator = [TTNavigator navigator];
navigator.window = window;
 
TTURLMap* map = navigator.URLMap;
[map          from:@"tt://restaurant/(initWithName:)"
  toViewController:[RestaurantController class]];

而对应的类则是RestaurantController和它的初始化方法initWithName:。

-(void) initWithName: (NSString*)name {
  //...
}

最后，如果我们要使用TTNavigator打开，则可以使用如下代码：

[navigator openURLAction:[TTURLAction actionWithURLPath:@"http://github.com/jverkoey"]];
[[TTNavigator navigator] openURLAction:
  [[TTURLAction actionWithURLPath:@"tt://restaurant/Chotchkie's"] applyAnimated:YES]]

当openURLAction:被调用后，RestaurantController类实例生成，并且调用初始化方法initWithName:，而字符串@”Chotchkie’s”则会作为第一个参数值传递进去。
如果使用UINavigationController来完成这些功能，则代码如下：

RestaurantController* controller = [[RestaurantController alloc]
  initWithName:@"Chotchkie's"];
[navigationController pushViewController:controller animated:YES];
[controller release];

也许从代码量上来说，也许是传统的方式要少得多，但是其实这样方式更加繁琐。假如我们要多次打开某个视图，我们要重复这样的代码很多次，而使用TTNavigator，建立好URL map映射后，我们只需要仅仅执行一个动作就可以切换到视图，而无需考虑其他繁琐的细节。

如何传递其他参数类型

在打开其他视图时，经常有各种复杂的情况出现，只传递NSString *类型参数并不能满足。
TTNavigator中TTURLAction自然在设计时也考虑到了这些需求，让我们用代码来查看：

NSArray *arr = [...load up with data...];
[[TTNavigator navigator] openURLAction:[[TTURLAction actionWithURLPath:@"tt://restaurant/Chotchkie's"]
  applyQuery:[NSDictionary dictionaryWithObject:arr forKey:@"arraydata"]]];

从代码中看，可以使用applyQuery:来传递NSDictionary类型的参数，当然对应的controller的初始化方法需要重载：

-(id) initWithName: (NSString*)name query:(NSDictionary*)query {
  for (MyObject* item in [query objectForKey:@"arrayData"])
    //... do something with item ...
  }
 
  // ...
}

通过TTURLAction的帮助，我们就可以把自己要传递的数据类型或者数据对象传递到对应的视图控制器中。

TTNavigator的其他补充

持久化

TTNavigator还有非常一个很不错的设计，就是记录视图历史，并且自动持久化。即使说，当app打开并且重新关闭后，TTNavigator会自动导航到用户上一次浏览的页面。当然前提，是在代码中选择了这一参数。
这主要跟以下三个参数有关：
TTNavigatorPersistenceModeNone — 不记录
TTNavigatorPersistenceModeTop — 只记录每次浏览的最后一个
TTNavigatorPersistenceModeAll — 记录所有的浏览历史
选择的示例代码如下：

TTNavigator* navigator = [TTNavigator navigator];
navigator.persistenceMode = TTNavigatorPersistenceModeAll;

传递多参数

除了通过TTURLAction传递特定的参数已经传递NSString类型的单个参数，TTNavigator也同样提供了传递多个参数的办法。
第一个办法，URL Map映射的代码更改为：

[map from:@"tt://menu/(initWithMenu:)/(withParam:)" toSharedViewController:[MenuController class]];

对应的控制器类的初始化方法为：

- (id)initWithMenu:(MenuPage)page withParam:(NSString*)param { 
if (self = [super init]) { 
self.page = page; 
} 
return self; 
}

这样，就可以很方便的传入两个参数。
第二个办法，URL Map映射的代码更改为：

[map from:@"tt://menu?menu=(initWithMenu:)" toSharedViewController:[MenuController class]];

对应的控制器类的初始化方法则为：

- (id)initWithMenu:(MenuPage)page query:(NSDictionary*)query { 
 
NSString *ref = [query objectForKey:@"ref"]; 
NSString *name = [query objectForKey:@"name"]; 
NSString *phone = [query objectForKey:@"phone"]; 
if (self = [super init]) { 
self.page = page; 
} 
return self; 
}

调用的代码如下：

TTOpenURL(@"tt://menu?menu=1&ref=hello&name=world&phone=123");

这个与前面传递自定义参数类型十分类似，其实也非常容易理解，是TTNavigator自动帮助我们将三个参数存入到NSDictionary类型中，并且传递过去。

需要注意得是，假如存在- (id)initWithMenu:(MenuPage)page方法，调用首先得是单参数方法，three20并不会智能得根据参数类型和参数个数去选择初始化方法，因此避免这个问题得最佳办法就是将在映射时候将方法名映射为唯一的不同的URL。

总结

可以看出，TTNavigator是一个十分强大的three20类，在使用three20中，几乎每个app都注定要使用到它，而得益于它基于URL 导航栏的机制，我们无需陷入到繁琐的细节中就可以完成我们的需求了。

参考文档

(1)URL-Based Navigation