В этот раз наша задача — создать программу для чтения простой RSS-ленты (разумеется, это будет The Apple Blog).

Начинаем.

1. Откройте Xcode, перейдите в меню “File” и щелкните на элементе “New Project…“.
2. В списке слева под меню “iPhone OS” щелкните на “Application“.
3. Справа выберите “Navigation-Based Application“, затем воспользуйтесь кнопкой “Choose…“. Теперь нужно выбрать имя и путь. Наберите название “TAB RSS reader“.
4. Сохраните проект, куда сочтете нужным.

На экране появится окно проекта Xcode с тремя стандартными панелями. Советую сместить находящийся справа горизонтальный разделитель до конца вверх — дополнительное пространство для редактора будет отнюдь не лишним.

Видите кнопку “Build and Go” на панели инструментов? Щелкните на ней или откройте меню “Build“, выполнив потом “Build and Go (Run)“. Результатом должна стать запущенная программа-симулятор с простейшим приложением в iPhone — пустая панель навигации и пустая таблица. Вот и первый собственный проект для iPhone! Теперь нужно придать ему форму.

В предложенном Apple шаблоне проекта многое уже настроено. Найдите слева в окне список и дважды щелкните на элементе “MainWindow.xib“. Это базовый фрейм пользовательского интерфейса приложения. От него нам нужно только одно: найти окно “Navigation Controller” с макетом базового интерфейса, дважды щелкнуть по панели навигации (безымянной) и ввести “The Apple Blog“. Подтвердите клавишей <return>, сохранитесь и закройте средство Interface Builder.
Щелкнув на элементе списка “RootViewController.h“, обратите внимание на код справа. Ваша задача — придать ему следующий вид:

@interface RootViewController : UITableViewController {
    IBOutlet UITableView * newsTable;
    UIActivityIndicatorView * activityIndicator;
    CGSize cellSize;
    NSXMLParser * rssParser;
    NSMutableArray * stories;
    
    // временный элемент; добавляется к массиву "stories" по одному, и удаляется перед появлением следующего
    NSMutableDictionary * item;
    
    // анализирует документ, от начала до конца...
    // мы собираем и помещаем в оперативную память каждое значение под-элемента, потом сохраняем каждый элемент в массив.
    // тем самым каждый текущий элемент отслеживается до тех пор, пока он не будет готов к добавлению в массив "статей"
    NSString * currentElement;
    NSMutableString * currentTitle, * currentDate, * currentSummary, * currentLink;
}
@end

Это файл декларации, сообщающий компилятору, чего ожидать от логики контроллера. Именно здесь и разворачиваются реальные события… Откройте “RootViewController.m“.

Содержащийся здесь исходный код управляет отображением таблиц — данный контроллер “представляет их интересы”: таблица обращается к нему, чтобы выяснить, что выводить на экран / отображать в той или иной ситуации, отправляет запросы на методы при выполнении пользователем различных действий.

Меняем значение с — (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section, на return [stories count];

В декларациях мы сослались на массив (NSMutableArray – модифицируемая подборка объектов) который мы назвали “stories” (статьи). Обрамляющие выражение квадратные скобки сигнализируют о сообщении: мы запрашиваем массив статей-stories о его количественном значении — т.е. интересуемся, сколько в нем объектов. Наше приложение для RSS-лент будет захватывать как можно больше элементов (по одному для каждой статьи в RSS-ленте) и помещать их в массив. Следовательно, метод сообщает таблице: Вот сколько рядов необходимо — по одному на каждый элемент массива или на элемент ленты. Указанное прежде значение равнялось нулю, теперь по массиву задано больше информации.

Следующим шагом откорректируем находящийся ниже по списку метод:

— (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    static NSString *MyIdentifier = @"MyIdentifier";
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:MyIdentifier];
    
    if (cell == nil) {
    cell = [[[UITableViewCell alloc] initWithFrame:CGRectZero reuseIdentifier:MyIdentifier] autorelease];
    }
    
    // Настройка ячейки
    int storyIndex = [indexPath indexAtPosition: [indexPath length] — 1];
    [cell setText:[[stories objectAtIndex: storyIndex] objectForKey: @"title"]];
    
    return cell;
}

В декларациях мы сослались на массив (NSMutableArray – модифицируемая подборка объектов) который мы назвали “stories” (статьи). Обрамляющие выражение сигнализируют о сообщении: мы запрашиваем массив статей-stories о его количественном значении — т.е. интересуемся, сколько в нем объектов. Наше приложение для RSS-лент будет захватывать как можно больше элементов (по одному для каждой статьи в RSS-ленте) и помещать их в массив. Следовательно, метод сообщает таблице: Вот сколько рядов необходимо — по одному на каждый элемент массива или на элемент ленты. Указанное прежде значение равнялось нулю, теперь по массиву задано больше информации.

С помощью метода “setText:” мы сообщили ячейке о ее будущем содержимом. Каждая строка в таблице базово является ячейкой, а данный метод задает ее свойства.

Прокрутив бегунок вниз почти до конца, можно увидеть еще 4 выделенных зеленым цветом метода. При желании их можно удалить: они управляют добавлением/удалением элементов и нам не понадобятся.

Если попробовать запустить сейчас приложение, функционировать оно пока не будет: мы не добавили возможность загружать ленту и работать с ней. Этим и займемся.

Отредактируйте метод “viewDidAppear:“, придав ему следующий вид:

— (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    
    if ([stories count] == 0) {
        NSString * path = @"http://feeds.feedburner.com/TheAppleBlog";
        [self parseXMLFileAtURL:path];
    }
    
    cellSize = CGSizeMake([newsTable bounds].size.width, 60);
}

Здесь мы сообщаем анализатору, какую ленту загружать. Он обращается к методу, который теперь пора вставить:

— (void)parseXMLFileAtURL:(NSString *)URL {
    stories = [[NSMutableArray alloc] init];
    
    //необходимо преобразовать путь в нужный NSURL, иначе приложение не будет работать
    NSURL *xmlURL = [NSURL URLWithString:URL];
    
    // здесь по определенным причинам нужно использовать NSClassFromString для назначения NSXMLParser, иначе появится сообщение об ошибке при попытке отыскать объект
    // понадобится только для toolchain
    rssParser = [[NSXMLParser alloc] initWithContentsOfURL:xmlURL];
    
    // Устанавливает себя делегатом анализатора для обратной связи с его методами делегирования.
    [rssParser setDelegate:self];
    
    // В зависимости от анализируемого XML-документа, для NSXMLParser могут оказаться востребованными следующие функции.
    [rssParser setShouldProcessNamespaces:NO];
    [rssParser setShouldReportNamespacePrefixes:NO];
    [rssParser setShouldResolveExternalEntities:NO];
    
    [rssParser parse];
}

Добавленный метод создает пустой массив для статей, анализатор и начинает загружать RSS-ленту. В процессе работы анализатора контроллер, который пришла пора добавить, будет получать различные методы делегирования:

— (void)parserDidStartDocument:(NSXMLParser *)parser {
    NSLog(@"found file and started parsing");
}

— (void)parser:(NSXMLParser *)parser parseErrorOccurred:(NSError *)parseError {
    NSString * errorString = [NSString stringWithFormat:@"Unable to download story feed from web site (Error code %i )", [parseError code]];
    NSLog(@"error parsing XML: %@", errorString);
    
    UIAlertView * errorAlert = [[UIAlertView alloc] initWithTitle:@"Error loading content" message:errorString delegate:self cancelButtonTitle:@"OK" otherButtonTitles:nil];
    [errorAlert show];
}

— (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict{
    //NSLog(@"нашел такой элемент: %@", elementName);
    currentElement = [elementName copy];

    if ([elementName isEqualToString:@"item"]) {
        // очистить кэш для статьи...
        item = [[NSMutableDictionary alloc] init];
        currentTitle = [[NSMutableString alloc] init];
        currentDate = [[NSMutableString alloc] init];
        currentSummary = [[NSMutableString alloc] init];
        currentLink = [[NSMutableString alloc] init];
    }
}

— (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName{

    //NSLog(@"ended element: %@", elementName);
    if ([elementName isEqualToString:@"item"]) {
        // сохранить значения для элемента, затем сохранить элемент в массив...
        [item setObject:currentTitle forKey:@"title"];
        [item setObject:currentLink forKey:@"link"];
        [item setObject:currentSummary forKey:@"summary"];
        [item setObject:currentDate forKey:@"date"];
        
        [stories addObject:[item copy]];
        NSLog(@"adding story: %@", currentTitle);
    }
}

— (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string{
    //NSLog(@"found characters: %@", string);
    // сохранить символы для текущего элемента...
    if ([currentElement isEqualToString:@"title"]) {
        [currentTitle appendString:string];
    } else if ([currentElement isEqualToString:@"link"]) {
        [currentLink appendString:string];
    } else if ([currentElement isEqualToString:@"description"]) {
        [currentSummary appendString:string];
    } else if ([currentElement isEqualToString:@"pubDate"]) {
        [currentDate appendString:string];
    }
}

— (void)parserDidEndDocument:(NSXMLParser *)parser {
    
    [activityIndicator stopAnimating];
    [activityIndicator removeFromSuperview];
    
    NSLog(@"all done!");
    NSLog(@"stories array has %d items", [stories count]);
    [newsTable reloadData];
}

К сожалению, NSXMLParser — единственный доступный в iPhone простой инструмент XML-парсинга (так не хватает любимых Mac-средств). Это означает, что нам придется перебрать по порядку весь файл сверху донизу. Имеющемуся набору символов присваиваем значения, а затем собираем в поочередно сохраняемые элементы-статьи. Отыскав замыкающий тэг “item”, он сохраняет статью, очищает поля и переходит к следующему элементу, пока не доберется до конца файла. Не лучший способ, но работает.

Завершающий этап.

Стоит сразу же предотвратить любую потенциальную утечку памяти (хорошая привычка для тех, кто не коллекционирует информационный мусор). Отредактируем код:

— (void)dealloc {
    [currentElement release];
    [rssParser release];
    [stories release];
    [item release];
    [currentTitle release];
    [currentDate release];
    [currentSummary release];
    [currentLink release];
    
    [super dealloc];
}

Теперь откройте “RootViewController.xib“. Удерживая нажатой клавишу <control>, перетащите пиктограмму-кубик из “RootViewController” в меню Table View. Появится список с тремя элементами, в котором нужно щелкнуть на опции “newsTable“. Сохранитесь и закройте Interface Builder.

Build and Go.

Щелкнув на меню “Build and Go“, просмотрите итоговый результат. Если запустить приложение не в симуляторе, а на iPhone, картина будет несколько другой: аппаратное обеспечение медленнее, и RSS-лента в EDGE будет грузиться очень долго. Тем не менее, работает! Но работает пока не все: при выборе элемента в таблице ничего не происходит (этот сценарий задан по умолчанию). Предлагаю открывать статьи в Safari — это просто. Слегка изменим метод:

— (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    // Навигационная логика
    
    int storyIndex = [indexPath indexAtPosition: [indexPath length] — 1];
    
    NSString * storyLink = [[stories objectAtIndex: storyIndex] objectForKey: @"link"];
    
    // очистить ссылку от пробелов, знаков абзаца и табуляции...
    storyLink = [storyLink stringByReplacingOccurrencesOfString:@" " withString:@""];
    storyLink = [storyLink stringByReplacingOccurrencesOfString:@"\n" withString:@""];
    storyLink = [storyLink stringByReplacingOccurrencesOfString:@"  " withString:@""];
    
    NSLog(@"link: %@", storyLink);
    // открыть в Safari
    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:storyLink]];
}

Теперь можно еще раз щелкнуть на “Build and Go“, убедившись, что все работает.

Скачать архив (15Кб)

Оригинальная статья theappleblog.com
Источник lookapp.ru