代码规范

实例变量

hello.h文件

@interface Hello
// 开放的实例变量；非基本数据类型需要添加引用标记，字符串（NSString）类型标记为copy，非字符串类型标记为retain或者strong。
@end

hello.m文件

@interface Hello (private)
// 不开放的实例变量
@end

@implementation Hello

@synthesize example = _example // example作为初始化变量，而_example作为引用变量

- (void)viewDidLoad {
    // 初始化实例变量
    Object *tmp = [[Object alloc] init];
    self.example = tmp;
    [tmp release];


    // 操作实例变量
    [_example message];
}

@end

视图控制器的生命周期方法编写规范

- (void)dealloc {
    // 必须调用父类方法；使用引用变量来释放；释放完了以后必须将指针置空。
    [super dealloc];
    [_example release];
    [_example = nil];
}

- (void)loadView {
    // 必须调用父类方法；这里主要用于布局视图。
}

- (void)viewDidLoad {
    // 初始化数据，比如发送网络请求。
}

- (void)viewDidUnload {
    // 释放在loadView和viewDidLoad里初始化的实例变量，同时将指针置空。
    // 因为图片浏览应用比较容易发生内存警告，所以比较好的做法是把图片实体释放掉；
    // 比如，通常cell包含imageView，在发生内存警告时，可以将imageView的image属性置空。
    // 为了使释放的效率更高，可以将置空的代码放置在自动释放池的管理下，如下：
    NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
    cell.imageView.image = nil;
    [pool release];
}

- (void)viewWillAppear:(BOOL)animated {
    // 
}

构造网格视图

本应用所有网格都是规则的，因此可以使用3.0框架里的PCButtonCell视图，该视图允许开发者在上面添加若干个图片按钮，我们使用普通的列表就可以构造出一个网格视图。因为未必每个网格的样式都相同，比如说显示的文本、图标和位置不一样，所以基本PCButtonCell只包含一个PCButton。需要使用额外的视图构件比如UILabel或者UIImageView的，可以继承PCButtonCell然后自定义更加丰富的网格。假设每一行显示n个网格，下面是基本的使用方法：

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {

    return [dataSource count] / n + 1;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    static NSString *identifier = @"BrowseLocalController";
    PCButtonTableCell *cell = (PCButtonTableCell *)[tableView dequeueReusableCellWithIdentifier:identifier];
    
    NSDictionary *cellConfig = [self.config objectForPath:PCUI_CONTENT_VIEW, PCUI_TABLE_VIEW, PCUI_TABLE_CELL, nil];
    NSInteger countPreRow = n;

    // 网格的按钮都使用同一个回调方法，可以使用网格的tag来进行区分；
    if (!cell) {
        cell = [[PCButtonTableCell alloc] initWithConfig:cellConfig countPreRow:countPreRow target:self action:@selector(clickGrid:) style:UITableViewCellStyleDefault reuseIdentifier:identifier];
        [cell autorelease];
    }
    
    // 每次调用这个方法都必须配对调用showControllerFrom:和hideControlFrom:，因为单元格有重用机制，这样做可以保证单元格在重用以后可以显示正确的网格数。
    // 如果需要自定义网格，这两个方法也必须被覆盖。子类必须调用父类实现，并实现额外的控制。
    [cell showControlFrom:0];
    for (NSInteger i=0; i<countPreRow && i<itemCountForThisRow; i++) {
        PCButton *button = [cell getButon:i];
        NSInteger itemIdx = i + indexPath.row * countPreRow;
        
        [button setUri:small_url defaultImage:[UIImage imageWithKey:@"album@2x.png"]];
        button.tag = itemIdx;
        
        UILabel *label = [cell getLabel:i];
        label.text = @"content"
    }
    [cell hideControlFrom:itemCountForThisRow];
    
    return cell;
}

本地项目（LocalItem?）：用于抽象用户保存在本地的图片和图集，也就是说一个LocalItem可以是图片，也可以是图集

ItemType:(enum:{PhotoItem?, AlbumItem?})用于区分图片和图集

saveTime:NSString 保存时间

isChosen:BOOL 用于本地浏览进行编辑操作时判断是否选中

• (NSString *)itemId;子类必须实现，返回图集或者图片的id

• (NSString *)cover;子类可选择实现，返回当前item的封面，即小图

• (NSString *)title;子类可选择实现，无论是图集还是图片返回的都是图集标题

本地项目管理器(LocalItemManager?):用于管理本地项目的类

+ (NSArray *)getItems;读取本地项目

+ (NSArray *)getAlbumItems;获取图集项目

+ (void)saveItem:(LocalItem? *)item;保存某个项目到本地，下文会提到保存路径，以图片或者图集的id作为标识符

+ (void)deleteItem:(LocalItem? *)item://删除本地项目

+ (NSArray *)getAllPhotos;合并所有图集和独立图片成单个集合；原用于浏览大图的预览功能，因为该需求被剔除，所以这个函数可以选择实现。

本地项目的保存结构

- documents/
            - save/
                   - classes/
                             - photoItems/
                             - albumItems/

图集(Album)：

name : NSString 名称

author : NSString 作者

type : NSString 分类

cover : NSString 封面url

total : NSString 图片数量

origin_url : NSString 对应的web链接

theme : NSString 主题

location : NSString 拍摄地点

create_time : NSString 拍摄时间

nature : NSString 拍摄性质

vote : NSString 获票数

abstruct : NSString 作品概况

clicks : NSString 点击数

is_picked : BOOL 是否精华

以上属性组织为一个NSMutableDictionary对象

+ shareByEmailTemplate: NSString email分享的模板

+ shareByWeiboTemplate: NSString 微博分享的模板

图片列表(PhotoList?) : 浏览大图用到的，与图集是不同的概念；因为图片的体积较大，不能同时保存PhotoList里的所有图片实体，需要根据性能和体验调整容量。

count : NSInteger 图片数量

currentIdx : NSInteger 当前浏览的索引

photos : NSArray 用于浏览的图片列表

+ slideShowTimeInterval : CGFloat 这个应该直接读取app设置

• (Photo *)getPhotoByIndex:(NSInteger)idx; 获取某索引的Photo

• (Photo *)releasePhotoAtIndex:(NSInteger)idx; 释放某索引里的Photo的图片实体

图片(Photo):

photo_id : NSString 图片id

album_id : NSString 从属的图集id

album_name : NSString 从属的图集名称

name : NSString 图片名称

big_photo_url : NSString 图片url

small_photo_url : NSString 小图url

is_picked : BOOL 是否精华

save_time : NSString 被保存的时间

ISO : NSString iso

exposure : NSString 曝光

aperture : NSString 光圈

shutter : NSString 快门

ev : NSString 曝光补偿

camera : NSString 相机

以上属性组织为一个NSMutableDictionary对象

image : (UIImage *) 图片实体

• (void)is_saved;

评论(Comment)：

user_id : NSString 评论者的太平洋通行证id

name : NSString 评论者名称

content : NSString 评论内容

create_time : NSString 发表时间

• (void)postComment; 发送评论

下载任务(DownloadTask?):

enum {loading, waiting, stopped, finished}State

state : State

save_time: NSString 启动下载的时间

album : Album 图集对象

downloaded_count : NSInteger 下载成功的图片数

total_count : NSInteger 该图集的图片数

failed_count : NSInteger 下载失败的图片数

loading_idx : NSInteger 该索引指向的图片为下载中

conn : NSURLConnection 某图片的链接对象

• (void)start; 启动自己，将状态设置为Loading

• (void)stop; 暂停自己，将状态设置为Stopped

• (void)continue; 继续下载，将状态设置为Loading

• (void)notify; 完成任务时通知，即loading_idx>=total_count时通知

• (void)save; 将自己序列化到磁盘，路径为/home/Documents/save/classes/albumItems/，以albumId为标识符

• (void)deletePhoto:(Photo *)photo; 删除某张图片，删除后需要重新序列化覆盖原来的项目

下载队列(DownloadQueue?):

@private

+ tasks : NSArray 元素为下载任务，下载完成之后将该元素序列化。

+ (void)startTaskAtIndex:(NSInteger)idx;

+ (void)stopTaskAtIndex:(NSInteger)idx;

+ (void)deleteTaskAtIndex:(NSInteger)idx;

+ (void)receiveSuccesNotify:(NSNotification *)noti;

+ (BOOL)isLoading;检查任务列表中是否还有loading状态的任务，但是因为队列中只有loading和waiting的任务，所以可以通过判断[tasks count]是否为0来实现。

+ (void)notifyWhenDone; 是所有任务都下载的时候通知，还是没有等待中任务也通知？

+ (void)addTask:(DownloadTask? *)task;

+ (void)deleteTask:(DownloadTask? *)task; 用户主动删除任务

+ (void)continueDownload;从LocalItemManager中同步下载任务，在询问用户并得到用户的确认后执行该方法。

摄影师（Photographer）

NSDictionary *properties;

关注的摄影师(FocusedPhotographer?)：

@private

+ user_ids : NSArray 已关注的摄影师

+ (void)getAllPhotographers; 获取所有已经关注的摄影师

+ (BOOL)haveFocusedPhotographer:(NSString *)user_id; 判断是否已经关注了指定摄影师

+ (void)focusPhotographer:(NSString *)user_id; 关注某摄影师