最近在写一个游戏,要把外边的数据文件导入程序中的数组。所以网上找到了这个文章,认
本文目标
本文以上一篇为基础,对应用进行扩展,介绍以下内容:
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];