Permalink
Browse files

Re-structure

  • Loading branch information...
onevcat committed Mar 19, 2014
0 parents commit b5ba88afeea0e6c7d0bcbf49145cd72799d8c4ed
Showing with 17,738 additions and 0 deletions.
  1. +1 −0 .gitignore
  2. +16 −0 README.md
  3. 0 draft/issue1/README.md
  4. +31 −0 draft/issue1/issue-1-0-tang3w.md
  5. +189 −0 draft/issue1/issue-1-1-tang3w.md
  6. 0 draft/issue10/README.md
  7. 0 draft/issue2/README.md
  8. 0 draft/issue3/README.md
  9. 0 draft/issue4/README.md
  10. 0 draft/issue5/README.md
  11. 0 draft/issue6/README.md
  12. 0 draft/issue7/README.md
  13. 0 draft/issue8/README.md
  14. 0 draft/issue9/README.md
  15. +52 −0 origin/issue1/issue-1-0.md
  16. +206 −0 origin/issue1/issue-1-1.md
  17. +248 −0 origin/issue1/issue-1-2.md
  18. +359 −0 origin/issue1/issue-1-3.md
  19. +161 −0 origin/issue1/issue-1-4.md
  20. +57 −0 origin/issue10/issue-10-0.md
  21. +276 −0 origin/issue10/issue-10-1.md
  22. +300 −0 origin/issue10/issue-10-2.md
  23. +244 −0 origin/issue10/issue-10-3.md
  24. +288 −0 origin/issue10/issue-10-4.md
  25. +203 −0 origin/issue10/issue-10-5.md
  26. +454 −0 origin/issue10/issue-10-6.md
  27. +52 −0 origin/issue2/issue-2-0.md
  28. +422 −0 origin/issue2/issue-2-1.md
  29. +417 −0 origin/issue2/issue-2-2.md
  30. +578 −0 origin/issue2/issue-2-3.md
  31. +316 −0 origin/issue2/issue-2-4.md
  32. +252 −0 origin/issue2/issue-2-5.md
  33. +48 −0 origin/issue3/issue-3-0.md
  34. +529 −0 origin/issue3/issue-3-1.md
  35. +162 −0 origin/issue3/issue-3-2.md
  36. +254 −0 origin/issue3/issue-3-3.md
  37. +284 −0 origin/issue3/issue-3-4.md
  38. +115 −0 origin/issue3/issue-3-5.md
  39. +54 −0 origin/issue4/issue-4-0.md
  40. +206 −0 origin/issue4/issue-4-1.md
  41. +436 −0 origin/issue4/issue-4-2.md
  42. +424 −0 origin/issue4/issue-4-3.md
  43. +303 −0 origin/issue4/issue-4-4.md
  44. +4 −0 origin/issue4/issue-4-5.md
  45. +74 −0 origin/issue4/issue-4-6.md
  46. +380 −0 origin/issue4/issue-4-7.md
  47. +41 −0 origin/issue5/issue-5-0.md
  48. +350 −0 origin/issue5/issue-5-1.md
  49. +407 −0 origin/issue5/issue-5-2.md
  50. +211 −0 origin/issue5/issue-5-3.md
  51. +240 −0 origin/issue5/issue-5-4.md
  52. +350 −0 origin/issue5/issue-5-5.md
  53. +321 −0 origin/issue5/issue-5-6.md
  54. +119 −0 origin/issue5/issue-5-7.md
  55. +52 −0 origin/issue6/issue-6-0.md
  56. +283 −0 origin/issue6/issue-6-1.md
  57. +485 −0 origin/issue6/issue-6-2.md
  58. +673 −0 origin/issue6/issue-6-3.md
  59. +219 −0 origin/issue6/issue-6-4.md
  60. +460 −0 origin/issue6/issue-6-5.md
  61. +54 −0 origin/issue7/issue-7-0.md
  62. +131 −0 origin/issue7/issue-7-1.md
  63. +338 −0 origin/issue7/issue-7-2.md
  64. +769 −0 origin/issue7/issue-7-3.md
  65. +97 −0 origin/issue7/issue-7-4.md
  66. +241 −0 origin/issue7/issue-7-5.md
  67. +199 −0 origin/issue7/issue-7-6.md
  68. +51 −0 origin/issue8/issue-8-0.md
  69. +89 −0 origin/issue8/issue-8-1.md
  70. +341 −0 origin/issue8/issue-8-2.md
  71. +186 −0 origin/issue8/issue-8-3.md
  72. +233 −0 origin/issue8/issue-8-4.md
  73. +43 −0 origin/issue9/issue-9-0.md
  74. +412 −0 origin/issue9/issue-9-1.md
  75. +636 −0 origin/issue9/issue-9-2.md
  76. +481 −0 origin/issue9/issue-9-3.md
  77. +225 −0 origin/issue9/issue-9-4.md
  78. +271 −0 origin/issue9/issue-9-5.md
  79. 0 publish/issue1/README.md
  80. +32 −0 publish/issue1/issue-1-0-tang3w.md
  81. +189 −0 publish/issue1/issue-1-1-tang3w.md
  82. 0 publish/issue10/README.md
  83. 0 publish/issue2/README.md
  84. 0 publish/issue3/README.md
  85. 0 publish/issue4/README.md
  86. 0 publish/issue5/README.md
  87. 0 publish/issue6/README.md
  88. 0 publish/issue7/README.md
  89. 0 publish/issue8/README.md
  90. 0 publish/issue9/README.md
  91. +6 −0 tools/Rakefile
  92. +73 −0 tools/rake_task/data/urls
  93. +35 −0 tools/rake_task/sync_with_objcio.rb
@@ -0,0 +1 @@
.DS_Store
@@ -0,0 +1,16 @@
objccn.io
========
### WHY
[objc中国(objccn.io)](http://objccn.io)项目的成立源于国内Objective-C社区对[objc.io](http://objc.io)的翻译活动。对于国外技术网站和社区内容进行高质量的本地化,无疑将降低我们阅读和学习的难度,是推进国内技术圈整体水平的良好途径。而对于objc.io中这样高水平的文章,如果能进行完整的翻译和整理,不仅能够对国内objc社区大有裨益,对于翻译者本人也会是一次很好的提升。在objccn.io之前,国内社区已经有不少开发者自发地在进行翻译,相信大家的出发点都是喜爱技术,喜爱objc.io的深刻内容,希望在自我挑战的同时惠泽其他开发者。但是这类做法相对来说缺乏组织性,这导致了大量的重复劳动以及迥异的翻译风格。我们创建这个项目,目标是希望通过努力,创建一个objc.io的完整的、准确的、优雅的翻译版本,并分享给国内技术圈的朋友们。
### HOW
如果您和我们有着一样的目标,并且想参加这个项目的话,欢迎您发信给`mail@objccn.io`或者直接联系[@onevcat](http://weibo.com/onevcat)。我们会将您加入项目,并成为内容贡献者。我们对贡献者的要求是需要您能够使用Github的基本功能,了解一些Markdown,并有良好的翻译水平。我们希望您可以通过Github查看别人的翻译进度,使用Markdown按照格式进行翻译或者编辑,并通过pull request来提交您的成果。对于您的翻译内容您需要授权我们在[objc中国](http://objccn.io)上进行使用,并且在保证翻译准确性的基础上进行少量修改。对于前一个要求,我们将不对您的内容保留除了非商业使用外的任何权利,因此您可以在其他地方任意使用您自己的内容;而后一个要求是为了保证翻译的质量和格式上的统一性,请您谅解。如果您的翻译最终发布在站点上,我们将会在文章后面附上您的一段译者简介。
在您准备好以后,请移步[如何贡献内容](https://github.com/objccn/articles/wiki/如何贡献内容)页面来查看如何确认当前翻译进度和提交您的翻译内容,如果您有其他疑问,也欢迎与我们进行联系。
### WHEN
如果没有意外,这个项目将一直至少持续到objc.io的内容停止更新和结束。
No changes.
@@ -0,0 +1,31 @@
objc.io 是关于 Objective-C 最佳实践和先进技术的期刊,欢迎来到第一期!
objc.io 由 [Chris Eidhof][2], [Daniel Eggert][3] 和 [Florian Kugler][4] 成立于柏林。我们成立 objc.io 的目的是针对深入的、跟所有 iOS 和 OS X 开发者相关的技术话题创造一个正式的平台。
objc.io 每一期专注于某个特定的主题,包含多篇文章涵盖这个主题的各个方面。第一期的主题是*更轻量的 View Controllers*,共有 4 篇文章,其中 3 篇来自创始团队,1 篇来自 [Ricki Gregersen][5],欢迎他作为我们的第一个特约撰稿人!
从 iOS 应用的代码层面来说,一个常见的问题是 view controllers 难以控制,因为它们做了太多的事。通过重构出可复用的代码,就可以更容易地理解、维护和测试它们。本主题专注于如何让 view controllers 代码保持整洁的最佳实践和技术。
我们将会看到如何使用 view controllers 的**协同对象 ( coordinating objects )** 分离出 view 和 model 的代码,同时将其他控制器对象引入到 view controllers 中。此外,我们还会看到使用 view controller 容器机制来拆分 view controllers。最后,我们会讨论如何测试这些整洁的 view controllers。
在接下来的期刊中,将会有更多出自 Objective-C 社区中优秀的特约撰稿人的文章。[Loren Brichter][6],[Peter Steinberger][7],[Brent Simmons][8] 和 [Ole Begemann][9] 已经决定在稍后提交写作。如果你对某个主题有自己的看法,并且想将你的文章贡献给 objc.io,请邮件[联系我们][10]吧!
Chris,Daniel,和 Florian。
---
[话题 #1 下的更多文章][11]
[1]: http://www.objc.io/issue-1/introduction.html (Introduction)
[2]: https://twitter.com/chriseidhof
[3]: https://twitter.com/danielboedewadt
[4]: https://twitter.com/floriankugler
[5]: https://twitter.com/rickigregersen
[6]: https://twitter.com/lorenb
[7]: https://twitter.com/steipete
[8]: https://twitter.com/brentsimmons
[9]: https://twitter.com/olebegemann
[10]: mailto:mail%40objc.io
[11]: http://objccn.io/issue1
原文链接 [介绍 objc.io - 言无不尽"](http://tang3w.com/translate/objective-c/objc.io/2013/10/21/介绍-objc.io.html)
@@ -0,0 +1,189 @@
View controllers 通常是 iOS 项目中最大的文件,并且它们包含了许多不必要的代码。所以 View controllers 中的代码几乎总是复用率最低的。我们将会看到给 view controllers 瘦身的技术,让代码变得可以复用,以及把代码移动到更合适的地方。
你可以在 Github 上获取关于这个问题的[示例项目][2]。
## 把 Data Source 和其他 Protocols 分离出来
`UITableViewDataSource` 的代码提取出来放到一个单独的类中,是为 view controller 瘦身的强大技术之一。当你多做几次,你就能总结出一些模式,并且创建出可复用的类。
举个例,在示例项目中,有个 `PhotosViewController` 类,它有以下几个方法:
# pragma mark Pragma
- (Photo*)photoAtIndexPath:(NSIndexPath*)indexPath {
return photos[(NSUInteger)indexPath.row];
}
- (NSInteger)tableView:(UITableView*)tableView
numberOfRowsInSection:(NSInteger)section {
return photos.count;
}
- (UITableViewCell*)tableView:(UITableView*)tableView
cellForRowAtIndexPath:(NSIndexPath*)indexPath {
PhotoCell* cell = [tableView dequeueReusableCellWithIdentifier:PhotoCellIdentifier
forIndexPath:indexPath];
Photo* photo = [self photoAtIndexPath:indexPath];
cell.label.text = photo.name;
return cell;
}
这些代码基本都是围绕数组做一些事情,更针对地说,是围绕 view controller 所管理的 photos 数组做一些事情。我们可以尝试把数组相关的代码移到[单独的类][6]中。我们使用一个 block 来设置 cell,也可以用 delegate 来做这件事,这取决于你的习惯。
@implementation ArrayDataSource
- (id)itemAtIndexPath:(NSIndexPath*)indexPath {
return items[(NSUInteger)indexPath.row];
}
- (NSInteger)tableView:(UITableView*)tableView
numberOfRowsInSection:(NSInteger)section {
return items.count;
}
- (UITableViewCell*)tableView:(UITableView*)tableView
cellForRowAtIndexPath:(NSIndexPath*)indexPath {
id cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier
forIndexPath:indexPath];
id item = [self itemAtIndexPath:indexPath];
configureCellBlock(cell,item);
return cell;
}
@end
现在,你可以把 view controller 中的这 3 个方法去掉了,取而代之,你可以创建一个 `ArrayDataSource` 类的实例作为 table view 的 data source。
void (^configureCell)(PhotoCell*, Photo*) = ^(PhotoCell* cell, Photo* photo) {
cell.label.text = photo.name;
};
photosArrayDataSource = [[ArrayDataSource alloc] initWithItems:photos
cellIdentifier:PhotoCellIdentifier
configureCellBlock:configureCell];
self.tableView.dataSource = photosArrayDataSource;
现在你不用担心把一个 index path 映射到数组中的位置了,每次你想把这个数组显示到一个 table view 中时,你都可以复用这些代码。你也可以实现一些额外的方法,比如 `tableView:commitEditingStyle:forRowAtIndexPath:`,在 table view controllers 之间共享。
这样的好处在于,你可以单独[测试这个类][3],再也不用写第二遍。该原则同样适用于数组之外的其他对象。
在今年我们做的一个应用里面,我们大量使用了 Core Data。我们创建了相似的类,但和之前使用的数组不一样,它用一个 fetched results controller 来获取数据。它实现了所有动画更新、处理 section headers、删除操作等逻辑。你可以创建这个类的实例,然后赋予一个 fetch request 和用来设置 cell 的 block,剩下的它都会处理,不用你操心了。
此外,这种方法也可以扩展到其他 protocols 上面。最明显的一个就是 `UICollectionViewDataSource`。这给了你极大的灵活性;如果,在开发的某个时候,你想用 `UICollectionView` 代替 `UITableView`,你几乎不需要对 view controller 作任何修改。你甚至可以让你的 data source 同时支持这两个协议。
## 将业务逻辑移到 Model 中
下面是 view controller(来自其他项目)中的示例代码,用来查找一个用户的目前的优先事项的列表:
- (void)loadPriorities {
NSDate* now = [NSDate date];
NSString* formatString = @"startDate = %@";
NSPredicate* predicate = [NSPredicate predicateWithFormat:formatString, now, now];
NSSet* priorities = [self.user.priorities filteredSetUsingPredicate:predicate];
self.priorities = [priorities allObjects];
}
把这些代码移动到 `User` 类的 category 中会变得更加清晰,处理之后,在 `View Controller.m` 中看起来就是这样:
- (void)loadPriorities {
self.priorities = [user currentPriorities];
}
`User+Extensions.m` 中:
- (NSArray*)currentPriorities {
NSDate* now = [NSDate date];
NSString* formatString = @"startDate = %@";
NSPredicate* predicate = [NSPredicate predicateWithFormat:formatString, now, now];
return [[self.priorities filteredSetUsingPredicate:predicate] allObjects];
}
有些代码不能被轻松地移动到 model 对象中,但明显和 model 代码紧密联系,对于这种情况,我们可以使用一个 `Store`
## 创建 Store 类
在我们第一版的示例程序的中,有些代码去加载文件并解析它。下面就是 view controller 中的代码:
- (void)readArchive {
NSBundle* bundle = [NSBundle bundleForClass:[self class]];
NSURL *archiveURL = [bundle URLForResource:@"photodata"
withExtension:@"bin"];
NSAssert(archiveURL != nil, @"Unable to find archive in bundle.");
NSData *data = [NSData dataWithContentsOfURL:archiveURL
options:0
error:NULL];
NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];
_users = [unarchiver decodeObjectOfClass:[NSArray class] forKey:@"users"];
_photos = [unarchiver decodeObjectOfClass:[NSArray class] forKey:@"photos"];
[unarchiver finishDecoding];
}
但是 view controller 没必要知道这些,所以我们创建了一个 *Store* 对象来做这些事。通过分离,我们就可以复用这些代码,单独测试他们,并且让 view controller 保持小巧。Store 对象会关心数据加载、缓存和设置数据栈。它也经常被称为*服务层*或者*仓库*
## 把网络请求逻辑移到 Model 层
和上面的主题相似:不要在 view controller 中做网络请求的逻辑。取而代之,你应该将它们封装到另一个类中。这样,你的 view controller 就可以在之后通过使用带有回调(比如一个 completion 的 block)来请求网络了。这样的好处是,缓存和错误控制也可以在这个类里面完成。
## 把 View 代码移到 View 层
不应该在 view controller 中构建复杂的 view 层次结构。你可以使用 Interface Builder 或者把 views 封装到一个 `UIView` 子类当中。例如,如果你要创建一个选择日期的控件,把它放到一个名为 `DatePickerView` 的类中会比把所有的事情都在 view controller 中做好好得多。再一次,这样增加了可复用性并保持了简单。
如果你喜欢 Interface Builder,你也可以在 Interface Builder 中做。有些人认为 IB 只能和 view controllers 一起使用,但事实上你也可以加载单独的 nib 文件到自定义的 view 中。在示例程序中,我们创建了一个 [`PhotoCell.xib`][7],包含了 photo cell 的布局:
![PhotoCell.xib screenshot][4]
就像你看到的那样,我们在 view(我们没有在这个 nib 上使用 File's Owner 对象)上面创建了 properties,然后连接到指定的 subviews。这种技术同样适用于其他自定义的 views。
## 通讯
其他在 view controllers 中经常发生的事是与其他 view controllers,model,和 views 之间进行通讯。这当然是 controller 应该做的,但我们还是希望以尽可能少的代码来完成它。
关于 view controllers 和 model 对象之间的消息传递,已经有很多阐述得很好的技术(比如 KVO 和 fetched results controllers)。但是 view controllers 之间的消息传递稍微就不是那么清晰了。
当一个 view controller 想把某个状态传递给多个其他 view controllers 时,就会出现这样的问题。较好的做法是把状态放到一个单独的对象里,然后把这个对象传递给其它 view controllers,它们观察和修改这个状态。这样的好处是消息传递都在一个地方(被观察的对象)进行,而且我们也不用纠结嵌套的 delegate 回调。这其实是一个复杂的主题,我们可能在未来用一个完整的话题来讨论这个主题。
## 总结
我们已经看到一些用来创建更小巧的 view controllers 的技术。我们并不是想把这些技术应用到每一个可能的角落,只是我们有一个目标:写可维护的代码。知道这些模式后,我们就更有可能把那些笨重的 view controllers 变得更整洁。
### 扩展阅读
* [View Controller Programming Guide for iOS][11]
* [Cocoa Core Competencies: Controller Object][12]
* [Writing high quality view controllers][13]
* [Stack Overflow: Model View Controller Store][14]
* [Unburdened View Controllers][15]
* [Stack Overflow: How to avoid big and clumsy `UITableViewControllers` on iOS][16]
* * *
[话题 #1 下的更多文章][8]
[2]: https://github.com/objcio/issue-1-lighter-view-controllers
[3]: http://www.objc.io/issue-1-3/
[4]: http://objccn.io/contents/images/issue-1/photocell.png
[5]: http://twitter.com/chriseidhof
[6]: https://github.com/objcio/issue-1-lighter-view-controllers/blob/master/PhotoData/ArrayDataSource.h
[7]: https://github.com/objcio/issue-1-lighter-view-controllers/blob/master/PhotoData/PhotoCell.xib
[8]: http://objccn.io/issue1
[11]: http://developer.apple.com/library/ios/#featuredarticles/ViewControllerPGforiPhoneOS/BasicViewControllers/BasicViewControllers.html
[12]: http://developer.apple.com/library/mac/#documentation/General/Conceptual/DevPedia-CocoaCore/ControllerObject.html
[13]: http://subjective-objective-c.blogspot.de/2011/08/writing-high-quality-view-controller.html
[14]: http://programmers.stackexchange.com/questions/184396/mvcs-model-view-controller-store
[15]: https://speakerdeck.com/trianglecocoa/unburdened-viewcontrollers-by-jay-thrash
[16]: http://programmers.stackexchange.com/questions/177668/how-to-avoid-big-and-clumsy-uitableviewcontroller-on-ios
原文链接 [更轻量的 View Controllers - 言无不尽"](http://tang3w.com/translate/objective-c/objc.io/2013/10/22/更轻量的-view-controllers.html)
No changes.
No changes.
No changes.
No changes.
No changes.
No changes.
No changes.
No changes.
No changes.
@@ -0,0 +1,52 @@
[Source](http://www.objc.io/issue-1/introduction.html "Permalink to Introduction - Lighter View Controllers - objc.io issue #1 ")
# Introduction - Lighter View Controllers - objc.io issue #1
* [About][1]
* [Contributors][2]
* [Subscribe][3]
A periodical about best practices and advanced techniques in Objective-C.
# Introduction
[Issue #1 Lighter View Controllers][4], June 2013
Welcome to the first edition of objc.io, a periodical about best practices and advanced techniques in Objective-C!
objc.io was founded in Berlin by [Chris Eidhof][5], [Daniel Eggert][6], and [Florian Kugler][7]. We started objc.io to create a regular platform for in-depth technical topics relevant to all iOS and OS X developers.
Each edition of objc.io has a focus on one particular subject, with multiple articles covering different aspects of that topic. The subject of this first edition is _Lighter View Controllers_, and it contains four articles – three from the founding team and one from [Ricki Gregersen][8], whom we would like to welcome as our first guest writer!
It’s a common problem in the code base of iOS apps that view controllers get out of hand, because they do too much. By factoring out reusable code, they are easier to understand, easier to maintain and easier to test. This issue will focus on best practices and techniques how you can keep view controllers clean.
We will look at how to make view controllers primarily coordinating objects by factoring out view and model code, as well as introducing other controller objects in addition to view controllers. Furthermore, we will look at splitting up view controllers using the view controller containment mechanism, and finally, discuss how to test clean view controllers.
In upcoming editions we will have more articles from great guest writers of the Objective-C community; [Loren Brichter][9], [Peter Steinberger][10], [Brent Simmons][11], and [Ole Begemann][12] have committed to writing in the future. [Contact us][13] if you have an idea for an interesting topic and you would like to contribute an article about it to objc.io.
Chris, Daniel, and Florian.
* * *
[More articles in issue #1][14]
* [Privacy policy][15]
[1]: http://www.objc.io/about.html
[2]: http://www.objc.io/contributors.html
[3]: http://www.objc.io/subscribe.html
[4]: http://www.objc.io/issue-1/index.html
[5]: https://twitter.com/chriseidhof
[6]: https://twitter.com/danielboedewadt
[7]: https://twitter.com/floriankugler
[8]: https://twitter.com/rickigregersen
[9]: https://twitter.com/lorenb
[10]: https://twitter.com/steipete
[11]: https://twitter.com/brentsimmons
[12]: https://twitter.com/olebegemann
[13]: mailto:mail%40objc.io
[14]: http://www.objc.io/issue-1
[15]: http://www.objc.io/privacy.html
Oops, something went wrong.

0 comments on commit b5ba88a

Please sign in to comment.