天天看点

使用 UITableView 创建表格应用——从plist文件加载并显示数据(转)

最近在写一个游戏,要把外边的数据文件导入程序中的数组。所以网上找到了这个文章,认

本文目标

本文以上一篇为基础,对应用进行扩展,介绍以下内容:

1. 数据结构定义;

2. 从plist文件加载并显示数据;

3. 在表格中显示头像并调整表格样式;

4. 使用数据模型。

一. 数据结构定义

在上一篇演练中,使用NSArray定义了一个数组提供表格内容,但是在实际应用中,这种功能远远不能满足实际使用需求。

前文中,我们提到要做一个维护“微博关注人”的应用。那么对于关注人,一个名字显然不能满足我们应用的需求。

在开始之前,我们不妨先花点时间,确定一下除了姓名之外,我们还对哪些信息感兴趣,从而确定一下数据结构。见下图:

我们给关注对象增加五个属性:姓名、头像、网址、喜好程度和类别。

下面我们来增加一个plist文件记录我们后面需要使用的数据。

1. 在“My Focus”上点鼠标右键,在弹出菜单中选择“New Group”,然后输入“Data”做为新建群组的名称,见下图:

2. 在“Data”上点鼠标右键,选择“New File...”,然后选择“Resource”“Property List”,然后点击“Next”按钮,见下图:

3. 在“Save As”输入“FocusUsers”做为数据文件的名称,然后点“Create”按钮,见下图:

4. 在新建的“FocusUsers.plist”文件上点鼠标右键,选择“Open As”“Source Code”,我们可以看到所谓属性文件,原来是一个xml文件。将以下代码复制替换现有的xml内容。

<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "​​​http://www.apple.com/DTDs/PropertyList-1.0.dtd​​​">
 <plist version="1.0">
 <array>
     <dict>
         <key>UserName</key>
         <string>爱Apps</string>
         <key>Image</key>
         <string>爱Apps.jpeg</string>
         <key>WebSite</key>
         <string>http://weibo.com/iapps</string>
         <key>Category</key>
         <string>苹果咨询</string>
         <key>Favorite</key>
         <real>3.5</real>
     </dict>
     <dict>
         <key>UserName</key>
         <string>苹果汇</string>
         <key>Image</key>
         <string>苹果汇.jpeg</string>
         <key>WebSite</key>
         <string>http://weibo.com/appleus</string>
         <key>Favorite</key>
         <real>3.5</real>
         <key>Category</key>
         <string>苹果咨询</string>
     </dict>
     <dict>
         <key>UserName</key>
         <string>数码iPhone大百科</string>
         <key>Image</key>
         <string>数码iPhone大百科.jpeg</string>
         <key>WebSite</key>
         <string>http://weibo.com/gx110</string>
         <key>Favorite</key>
         <real>3.5</real>
         <key>Category</key>
         <string>苹果咨询</string>
     </dict>
     <dict>
         <key>UserName</key>
         <string>新浪视野</string>
         <key>Image</key>
         <string>新浪视野.jpeg</string>
         <key>WebSite</key>
         <string>http://weibo.com/wboard</string>
         <key>Favorite</key>
         <real>3.5</real>
         <key>Category</key>
         <string>官方机构</string>
     </dict>
     <dict>
         <key>UserName</key>
         <string>李开复</string>
         <key>Image</key>
         <string>李开复.jpeg</string>
         <key>WebSite</key>
         <string>http://weibo.com/kaifulee</string>
         <key>Favorite</key>
         <real>3.5</real>
         <key>Category</key>
         <string>IT名人</string>
     </dict>
 </array>
 </plist>      

提示:plist文件是xml文件的一种特例,由“键名”“键值”成对组成,在iOS开发中,plist的使用要比xml简单些,我们演练中选择plist文件存储数据。

5. 在“FocusUsers.plist”文件上点鼠标右键,选择“Open As”“Property List”,可以看到属性表形式的内容,见下图:

在开始下一步工作之前,我们还需要准备一些图片,猛击此处 ​​MyFocusDemo2Images.zip​​ 下载本演练需要使用的图片文件。

下载完成后,将Images文件夹从Finder中拖到“My Focus”下并放手,见下图:

点击“Finish”按钮。此时导航区域看起来应该是下图的样子 :

好,到此为止,我们的准备工作基本告一段落了,下面我们将继续第一讲的内容,对代码进行调整。

二. 从plist文件加载并显示数据

我们仍然打开“JOYTableViewController.m”文件,开始我们的编码工作。

1. 修改私有变量_userList的类型,将其改为:“NSMutableArray”,代码如下:

@interface JOYTableViewController () {
 @private
     NSMutableArray *_userList;
 }      
2. 在viewDidLoad方法中添加几行代码,由plist文件中的内容来填充_userList,代码如下: - (void)viewDidLoad
 {
     [super viewDidLoad];
 
     // 设定pList文件路径
     NSString *dataPath = [[NSBundle mainBundle]pathForResource:@"FocusUsers.plist" ofType:nil];
     // 填充数组内容
     _userList = [NSMutableArray arrayWithContentsOfFile:dataPath];
     
 }      

小技巧:设定文件路径时,如果在“ofType”的参数是nil,则可以在pathForResource中使用文件全名。我也是刚刚知道这一技巧,忍不住在代码中就用上了,呵呵。

3. 修改 - (UITableViewCell *)tableView 方法中设置文本部分的代码。将原有的设置文本的语句删除,因为现在数组中保存的已经不是一个个字符串了,而是一个个字典了,替换成以下两句代码:

NSDictionary *item = [_userList objectAtIndex:indexPath.row];
     [cell.textLabel setText:[item objectForKey:@"UserName"]];      

替换之后,这个方法完整看起来应该是这个样子:

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
 {
     static NSString *CellIdentifier = @"Cell";
     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];
     
     // Configure the cell...
     // 实例化单元格对象
     if (cell == nil) {
         cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier];
     }
     
     // 设置单元格文本
     NSDictionary *item = [_userList objectAtIndex:indexPath.row];
     [cell.textLabel setText:[item objectForKey:@"UserName"]];
     
     return cell;
 }      

好,现在我们运行一下看一下效果,见下图:

运行效果虽然和上一篇演练结束前的结果看起来一样,不过我们现在可是从plist中加载的数据哦。不过说实话,这个运行界面真的不是很美观。

下面让我们来想办法让界面看起来好那么一点,最起码要比现在好些。

三. 在表格中显示头像并调整表格样式

在本篇第一步准备工作中,朋友们应该发现准备了家长头像图片,在本节中我们就来把这些头像显示在表格中。:]

在刚刚增加代码的代码下面增加一句:

// 显示头像       [cell.imageView setImage:[UIImage imageNamed:[item objectForKey:@"Image"]]];      
现在我们再运行看看效果。      

头像已经显示出来了,怎么样?简单吧,哈哈。

现在我们想改变一下文字的显示效果,变换一个字体,调整一下大小,改变一下颜色,以及对齐方向。

我们在设定文本内容那句话下面增加如下代码:

// 设定字体
     [cell.textLabel setFont:[UIFont fontWithName:@"Helvetica" size:16.0f]];
     // 改变字体颜色
     [cell.textLabel setTextColor:[UIColor orangeColor]];
     // 调整文本居中对齐
     [cell.textLabel setTextAlignment:UITextAlignmentCenter];      

 现在我们再运行看看效果。

 怎么样?还算满意吗?:]当然现在这个样子,距离商业化的应用还有不小的差距,不过已经比第一章演练完成时取得了不小的进步了。

四. 使用数据模型

细心的朋友可能已经发现,前一部分我们在设置文本内容和图像时,使用了:

[item objectForKey:@"UserName"]  [item objectForKey:@"Image"]      
这样的方法。说实话,这真的不是一个好习惯,尤其对复杂应用而言,我们要尽可能将数据和界面区分开,否则一旦数据结构发生变化,程序员需要在程序中查找所有类似的地方进行修改,这是一个很痛苦的事情。      
下面我们演练如何增加一个数据类将用户信息的处理抽取出来,让程序看起来更优雅一些。      
1. 在导航区域“My Focus”上点击鼠标右键,在弹出菜单中选择“Add Group”,然后输入“Model”做为新建群组的名称。见下图:      
2. 在“Model”上,点击鼠标右键,在弹出菜单中选择“New File...”,在弹出窗口中选择“Cocoa Touch”“Objective-C class”,然后点“Next”按钮,见下图:
    
     

    
     3. 在“Class”中输入“JOYFocusUser”,“Subclass of”中输入“NSObject”,然后点击“Next"按钮,见下图:
     
   
    

   4. 在接下来的窗口中,我们直接点击“Create”按钮创建这个文件,此时我们的导航区域如下图所示: 
    
     

    5. 点击打开“JOYFocusUser.h”文件,在接口中输入如下代码:  @interface JOYFocusUser : NSObject
 
 @property (strong, nonatomic) NSString *userName;
 @property (strong, nonatomic) UIImage *image;
 @property (strong, nonatomic) NSString *webSite;
 @property (assign, nonatomic) CGFloat favorite;
 @property (strong, nonatomic) NSString *categoryName;
 
 // 使用字典项目实例化对象属性
 - (id)initWithItem:(NSDictionary *)item;
 
 @end

     其中3~7句一次定义了数据模型的属性,第10句定义了一个方法,用于实例化数据模型,供外部对象调用。提示:与前一篇演练中提到的不同,因为数据模型的属性和方法需要被其他对象访问,所以这些属性和方法需要在.h文件中定义才可以。6. 点击打开“JOYFocusUser.m”文件,在实现中输入如下代码:   #import "JOYFocusUser.h"
 
 @implementation JOYFocusUser
 @synthesize userName = _userName;
 @synthesize image = _image;
 @synthesize webSite = _webSite;
 @synthesize favorite = _favorite;
 @synthesize categoryName = _categoryName;
 
 - (id)initWithItem:(NSDictionary *)item {
     
     self = [super init];
     if (self) {
         _userName = [item objectForKey:@"UserName"];
         _image = [UIImage imageNamed:[item objectForKey:@"Image"]];
         _webSite = [item objectForKey:@"WebSite"];
         _favorite = [[item objectForKey:@"Favorite"]floatValue];
         _categoryName = [item objectForKey:@"Category"];
     }
     return self;
 }
 
 @end
 小提示:按住 control + command + 上下方向键,可以在.h和.m文件之间来回切换。:]到此为止,我们的数据模型已经准备好了,下面我们来看看如何使用这个模型。1. 点击打开“JOYTableViewController.m”文件,在文件顶部的#import "JOYTableViewController.h"之后加入:      
#import "JOYFocusUser.h"      
2. 在 - (void)viewDidLoad 方法中,对代码调整一下,使用刚刚新建的数据模型来实现数组的填充过程,代码如下:      
- (void)viewDidLoad
 {
     [super viewDidLoad];
 
     // 设定pList文件路径
     NSString *dataPath = [[NSBundle mainBundle]pathForResource:@"FocusUsers.plist" ofType:nil];
     // 填充临时数组
     NSMutableArray *array = [NSMutableArray arrayWithContentsOfFile:dataPath];
     
     // 初始化一个空的用户列表数组
     _userList = [[NSMutableArray alloc]init];
     for (NSDictionary *item in array) {
         JOYFocusUser *user = [[JOYFocusUser alloc]initWithItem:item];
         [_userList addObject:user];
     }
 
 }      
说明:以上代码使用了一个for循环,依次建立用户实例并添加到_userList数组中。      
3. 在 - (UITableViewCell *)tableView 方法中,我们需要修改三句话:      
// 设置单元格文本     //    NSDictionary *item = [_userList objectAtIndex:[indexPath row]];        JOYFocusUser *user = [_userList objectAtIndex:[indexPath row]];    //    [cell.textLabel setText:[item objectForKey:@"UserName"]];        [cell.textLabel setText:[user userName]];
      // 显示头像    //    [cell.imageView setImage:[UIImage imageNamed:[item objectForKey:@"Image"]]];        [cell.imageView setImage:[user image]];      
此时我们运行一下程序,与上一部分完成时的效果,并没有发生任何变化。      
不过在程序方面,我们导入了一个数据模型,这样使得我们只是在程序加载时,实例化一次数组项目即可,以后调用时,我们可以直接针对这个数据模型进行操作了。:]      
为了方便大家阅读,我在上面贴的代码中,注释了前面使用过的代码,这样能够方便大家体会两种方式之间的区别。      
五. 小结      
本次演练到此结束,到目前为止,我们已经实现了一个从plist加载数据的表格应用。:]      
本演练源程序下载地址:JoyiOSMyFocus2.zip      
在文中,我只使用了用plist文件初始化数组NSArray的一些代码。      
// 设定pList文件路径
     NSString *dataPath = [[NSBundle mainBundle]pathForResource:@"FocusUsers.plist" ofType:nil];
     // 填充临时数组
     NSMutableArray *array = [NSMutableArray arrayWithContentsOfFile:dataPath];