這是一個把多個基礎技能串起來的練習專案:以 Storyboard 的靜態 TableView 排出城市列表,點擊某一列時抓取該城市的即時天氣 JSON,再透過 segue 把結果帶到詳情頁顯示。涵蓋的技術點包含靜態 cell、UITextView、segue 傳值與 NSJSONSerialization。
在 Storyboard 中拖入一個 Table View Controller,把它的 Content 設為 Static Cells,就能直接在設計稿上排出每一列,不必實作 numberOfRowsInSection 與 cellForRowAtIndexPath:。這對「選單式」的固定列表特別方便。
列表控制器繼承 UITableViewController 即可:
#import <UIKit/UIKit.h>
@interface ViewController : UITableViewController
@end
天氣資訊文字較長,用 UILabel 不太合適,改用 UITextView 就能自動換行與捲動:
#import <UIKit/UIKit.h>
@interface cityViewController : UIViewController
@property (strong, nonatomic) IBOutlet UITextView *text1;
@property (strong, nonatomic) IBOutlet NSString *textcontent;
@end
textcontent 標記為 IBOutlet 是為了便於除錯時觀察;實務上一般會用 assign 或 copy 的 NSString 屬性即可。在 viewDidLoad 中把它塞進 text view:
- (void)viewDidLoad
{
[super viewDidLoad];
self.text1.text = textcontent;
}
關鍵在於 segue 觸發的時機。使用者點擊某一列後,系統會呼叫 -prepareForSegue:sender:,我們在這裡判斷是哪一個 segue、哪一列被點到,抓完資料後塞進目標控制器:
- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender
{
if ([segue.identifier isEqualToString:@"cityinfo"]) {
// 取得被點選的列
NSIndexPath *indexPath = [self.tableView indexPathForSelectedRow];
UITableViewCell *cell = [self.tableView cellForRowAtIndexPath:indexPath];
if ([[[cell textLabel] text] isEqualToString:@"北京"]) {
NSError *error = nil;
NSURL *URL = [NSURL URLWithString:@"https://m.weather.com.cn/data/101010100.html"];
NSData *data = [NSData dataWithContentsOfURL:URL];
NSDictionary *Dic = [NSJSONSerialization JSONObjectWithData:data
options:NSJSONReadingMutableContainers
error:&error];
NSDictionary *Info = [Dic objectForKey:@"weatherinfo"];
cityViewController *destViewController = segue.destinationViewController;
destViewController.textcontent = [NSString stringWithFormat:
@"今天是 %@ %@ %@ 的天氣狀況是:%@ %@",
[Info objectForKey:@"date_y"],
[Info objectForKey:@"week"],
[Info objectForKey:@"city"],
[Info objectForKey:@"weather1"],
[Info objectForKey:@"temp1"]];
}
}
}
這裡的 101010100 是中國天氣網的城市編碼;不同城市有不同的代碼,實務上通常會把「城市名 → 代碼」的對照表做成 dictionary 或 plist。
這個範例寫於 iOS 6/7 時代,概念清楚,但實際上線前有幾處必須修正。
不要在主執行緒同步抓網路資料。dataWithContentsOfURL: 是同步呼叫,而且會在 prepareForSegue: 中執行,等於讓整個畫面在切換時凍住。請改用 NSURLSession 的 dataTaskWithURL:completionHandler:,在回呼中解析完成後再切回主執行緒執行 segue。
用字面量語法取代 objectForKey。可以寫成 Info[@"city"],更簡潔。
改用 Codable 或至少建立模型類別。把字典鍵值散落在各處容易出錯,鍵名一改就難以追查。建立一個 WeatherInfo 類別(Swift 用 Codable)會安全得多。
一定要檢查 error 與 nil。網路失敗、JSON 格式變更、欄位缺失都可能讓 Info 變成 nil,接著整串格式化就會產生 "(null)" 這種輸出。務必逐層判斷。
改用 delegate 或 closure 傳值。在 prepareForSegue: 中同步抓資料,會讓列表頁與網路邏輯耦合在一起。更好的做法是先切換畫面、顯示載入狀態,資料回來後再更新 UI。
靜態 cell 的替代方案。若列表內容固定且不多,靜態 cell 很合適;但若城市清單會變動(例如使用者可新增城市),就該改用 dynamic prototypes 並實作 data source 方法。
改用 WKWebView 或串接 HTTPS API。原始的 m.weather.com.cn 端點為 HTTP,在啟用 ATS 的環境下會被阻擋。建議改用支援 HTTPS 的天氣服務,例如各家公開的氣象 API,並注意各自的流量與授權條款。