Three20中TNavigator用法总结

Three20中TNavigator用法总结

简单映射：

Three20中的TNavigator对于软件导航很有用，只需要维护一张map映射表就行了。就像url表示一个网页一样，Three20也采用了相同的方式，用url关联页面。大家可以参看TTNavigatorDemo中的源码：

TTURLMap* map = navigator.URLMap;  

// Any URL that doesn't match will fall back on this one, and open in the web browser  
[map from:@"*" toViewController:[TTWebController class]];  

// The tab bar controller is shared, meaning there will only ever be one created.  Loading  
// This URL will make the existing tab bar controller appear if it was not visible.  
[map from:@"tt://tabBar" toSharedViewController:[TabBarController class]];  

// Menu controllers are also shared - we only create one to show in each tab, so opening  
// these URLs will switch to the tab containing the menu  
[map from:@"tt://menu/(initWithMenu:)" 
toSharedViewController:[MenuController class]];  

上面的代码就是给页面注册url, 如tt:tabBar就表示TabBarController,只要调用TTOpenURL(@"tt://tabBar");这句代码就可以初始化TabBarController,并显示出来。相当于执行了TabBarController *test=[[TabBarController alloc] init]; [self.view addSubview:test.view];

参数映射

如果调用TTOpenURL(@"tt://menu/1");会发生什么？ 它会调用MenuController中的

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

为什么会调用这个方法呢？ 因为我们在上面map的时候是用的tt://menu/(initWithMenu:) 括号里是方法名，可以想像成如果有括号，那么它就表示一变量，那么它就是一对多的映射， 与数学上的映射一个道理。，tt://menu/1 tt://menu/2 tt://menu/3 ..... tt://menu/XXX 都表示这个对应， 所以TTOpenURL(@"tt://menu/2");的时候也会调用上面的方法。而这个1，2，3 .... XXX就表未参数传入到上面这个方法。为什么会样呢，因为这是Three20的规则。还有注意，你的MenuController必须要实现- (id)initWithMenu:(MenuPage)page
这个方法，不然就不能达到效果。 在map映射的时候，如果加括号有方法名的时候，这个方法返回的必须是Controller. （这是我的理解，不知道正确与否，知道的大侠通知我一下）

多参数映射：

上面的情况是只有一个参数转入，如果想传多个参数如何办呢？我知道有两种方法：

1. 将映射改为：

   [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;  
}  

2。将映射改为：

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

这种方式也可以传入多个参数，如：TTOpenURL(@"tt://menu?menu=1&ref=hello&name=world&phone=123");这样就传入了三个参数，那么它的初始化方法就应写为：

- (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;  
}  

注意：如果- (id)initWithMenu:(MenuPage)page
这个方法与上面多参数方法同时存在的话， 那么首先是调用上面这个单参数方法，并没有智能的根据参数的不同而选择初始化方法，避免错误调用方法就是在映射的时候将方法名命名为不同的名字。

Hash URL

在demo中有一个Hash URL的例子，它可以指定方法的调用。如果将MenuController里的代码修改一下：

self.navigationItem.rightBarButtonItem =  
  [[[UIBarButtonItem alloc] initWithTitle:@"Order" style:UIBarButtonItemStyleBordered  
                            target:@"tt://order?waitress=Betty&ref=toolssssstest#param"     
                            action:@selector(openURLFromButton:)] autorelease];  

那么点order的时候就会调用ContentController里的

- (void)orderAction:(NSString*)action {  
  TTDPRINT(@"ACTION: %@", action);  
}  

因为map映射的是：

[map from:@"tt://order?waitress=(initWithWaitress:)" 
    toModalViewController:[ContentController class]];  
[map from:@"tt://order?waitresss=()#(orderAction:)" 
    toViewController:[ContentController class]];  

参数是对象

使用TTURLActionOne way of doing it is to use a TTURLAction. When the user selects a row in your table, which will call your didSelectObject (of TTTableViewController) method, extract the object or set of objects you want to pass and build a TTURLAction like this:

TTURLAction *action =  [[[TTURLAction actionWithURLPath:@"tt://showUser"] 
    applyQuery:[NSDictionary dictionaryWithObject:user forKey:@"kParameterUser"]]
            applyAnimated:YES];


//Then open the action:
[[TTNavigator navigator] openURLAction:action];

/*
The controller you want to open as a result of this action should be registered in your TTURLMap and should have a constructor thus:
*/
- (id) initWithNavigatorURL:(NSURL*)URL query:(NSDictionary*)query {
    self = [super init];
    if (self != nil) {
        self.user = [query objectForKey:kParameterUser];
    }
    return self;
}

参考资料

• https://github.com/facebook/three20/wiki/URL-based-navigation-and-state-persistence
• http://three20.info/article/2010-10-06-URL-Based-Navigation
• http://www.slideshare.net/iphonedevbr/three20