{"id":3420,"date":"2010-05-18T11:16:29","date_gmt":"2010-05-18T09:16:29","guid":{"rendered":"http:\/\/www.devapp.it\/wordpress\/?p=3420"},"modified":"2012-09-05T11:51:52","modified_gmt":"2012-09-05T09:51:52","slug":"t043-creiamo-il-nostro-lettore-di-feed-rss-per-iphone","status":"publish","type":"post","link":"https:\/\/www.devapp.it\/wordpress\/t043-creiamo-il-nostro-lettore-di-feed-rss-per-iphone\/","title":{"rendered":"T#043 – Creiamo il nostro lettore di feed RSS per iPhone"},"content":{"rendered":"

\"\"<\/a> Oggi parleremo ancora di XML, questa volta, per\u00f2, con un esempio pratico. Andremo a creare infatti, con questo nuovo tutorial, un lettore di feed RSS per il nostro iPhone. Impareremo quindi a sfruttare il parser XML disponibile con l’SDK di Apple, “NSXMLParser”, per interfacciare la nostra applicazione, ad esempio, con i feed RSS del nostro sito. Ricaveremo un elenco delle ultime notizie pubblicate e, al tocco da parte dell’utente su una voce nell’elenco, faremo in modo di aprire una nuova vista con la news pronta da leggere. Interessante vero? Ma ora basta chiacchere e partiamo subito con il nostro tutorial.<\/p>\n

1. Creiamo un nuovo progetto<\/h4>\n

Aprimo Xcode, selezioniamo “File -> New Project”. Nel men\u00f9 che ci appare selezioniamo “Navigation-Based Application”, clicchiamo su “Choose\u2026”, immettiamo come nome “SimpleRSSreader” e facciamo clic su “Save”. Abbiamo cos\u00ec creato il nostro nuovo progetto.<\/p>\n

\"\"<\/a><\/p>\n

Solitamente tra le prime cose che facciamo \u00e8 realizzare la struttura grafica dell’applicazione. Oggi, per\u00f2, non sar\u00e0 necessario, in quanto Xcode ci fornisce gi\u00e0 un template predisposto, contenente una tabella (UITableView) che a suo volta conterr\u00e0 gli elementi che andremo a leggere. Ci concentreremo, quindi, sugli aspetti pi\u00f9 importanti.<\/p>\n

2. Definiamo gli elementi necessari<\/h4>\n

Il primo file che andremo a modificare \u00e8 “RootViewController.h”. Apriamolo e, al suo interno, scriviamo il seguente codice:<\/p>\n

@interface RootViewController : UITableViewController   {\r\n\t\/\/ parser XML\r\n\tNSXMLParser *rssParser;\r\n\t\/\/ elenco degli elementi letti dal feed\r\n\tNSMutableArray *elencoFeed;\r\n\r\n\t\/\/variabile temporanea pe ogni elemento\r\n\tNSMutableDictionary *item;\r\n\r\n\t\/\/ valori dei campi letti dal feed\r\n\tNSString *currentElement;\r\n\tNSMutableString *currentTitle, *currentDate, *currentSummary, *currentLink;\r\n}\r\n\r\n- (void)parseXMLFileAtURL:(NSString *)URL;\r\n\r\n@end<\/pre>\n
Come gi\u00e0 saprete, questo \u00e8 il file di implementazione, in cui definiamo tutti gli elementi, quelli che vengono solitamente chiamati “variabili globali”. Questi elementi li utilizzeremo nei vari metodi che andremo a definire fra poco.<\/p>\n
Alla riga 3 abbiamo definito il nostro parser XML, che si occuper\u00e0 di leggere il feed RSS e di convertirne le notizie. Alla riga 5 \u00e8 definito un NSMutableArray, ovvero una collezione di oggetti, in cui inseriremo i vari feed letti (con le varie informazioni, ovvero titolo, data, testo, etc). Le dichiarazioni alle righe 7, 10 e 11 servono proprio per i metodi del parser, quindi non preoccupatevi troppo se non le capite pienamente.<\/p>\n
Apriamo, ora, il file “RootViewController.m”. Possiamo subito notare che sono gi\u00e0 presenti diversi metodi. Tutti si riferiscono alla definizione e al popolamento della tabella. Tali metodi sono obbligatori e necessari per il corretto funzionamento della tabella stessa.<\/p>\n
Iniziamo a modificare i metodi gi\u00e0 presenti a seconda delle nostre necessit\u00e0.<\/p>\n
Il primo metodo da modificare \u00e8 il seguente:<\/p>\n
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {\r\n    return [elencoFeed count];\r\n}<\/pre>\n
Questo metodo imposta il numero di righe della nostra tabella. Tale numero deve essere pari al numero di elementi che scarichiamo dal feed RSS. Ad esempio, se abbiamo ricavato 10 notizie dal nostro feed, dovranno essere 10 le righe della tabella, ovvio no?<\/p>\n
Le \u00a0parentesi quadre [] che trovate intorno all’elemento “elencoFeed” servono per richiamare un metodo o una propriet\u00e0: in questo caso abbiamo richiamato la propriet\u00e0 “count”, che ci ritorna il numero di elementi presenti nella nostra lista.<\/p>\n
Dobbiamo ora modificare il metodo che si occupa di inserire il testo all’interno delle varie celle. Ecco il metodo che si occupa di ci\u00f2:<\/p>\n
\/\/ Customize the appearance of table view cells.\r\n- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {\r\n\r\n    static NSString *CellIdentifier = @\"Cell\";\r\n\r\n    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];\r\n    if (cell == nil) {\r\n        cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier] autorelease];\r\n    }\r\n\r\n   \/\/ Configure the cell.\r\n   cell.textLabel.text = [[elencoFeed objectAtIndex:indexPath.row] objectForKey:@\"title\"];\r\n\r\n   return cell;\r\n}<\/pre>\n
Troveremo tale metodo gi\u00e0 definito, dovremo solo aggiungere l’istruzione alla riga 12. Tale istruzione va a ricavare l’elemento desiderato dalla lista (che coincide con il numero di riga, ricavato da “indexPath.row”), estrae quindi il campo “title” e lo setta come testo della cella.<\/p>\n
Se scorriamo verso il basso il file, possiamo notare alcuni metodi commentati (riconoscibili perch\u00e8 Xcode li colora in verde). Essi sono ancora relativi alla gestione della tabella, ma in questo tutorial non ci serviranno (tranne uno, che utilizzeremo dopo).<\/p>\n
Se provassimo ad eseguire il programma adesso, vedremmo che non farebbe ancora niente. Non abbiamo, infatti, ancora aggiunto la possibilit\u00e0 di scaricare il feed e di utilizzarlo. Quindi, ora, faremo proprio questo.<\/p>\n
3. Definiamo le azioni del parser<\/h4>\n
Ci siamo occupati, fino ad ora, solo della definizione della tabella. Non abbiamo ancora visto nessun aspetto relativo al parser XML.<\/p>\n
Iniziamo, quindi, dal metodo “viewDidLoad” (lo possiamo trovare commentato tra le prime righe della classe):<\/p>\n
- (void)viewDidLoad {\r\n        [super viewDidLoad];\r\n\r\n\tself.title = @\"devAPP RSS\";\r\n\r\n\tNSString *path = @\"http:\/\/feeds.feedburner.com\/devAPP\";\r\n\t[self parseXMLFileAtURL:path];\r\n\r\n    \/\/ Uncomment the following line to display an Edit button in the navigation bar for this view controller.\r\n    \/\/ self.navigationItem.rightBarButtonItem = self.editButtonItem;\r\n}<\/pre>\n
Come vedete abbiamo aggiunto alcune istruzioni. Alla riga 4 abbiamo settato un titolo alla nostra applicazione, che comparir\u00e0 nella navigation bar sopra la tabella. Alla riga 6, invece, viene definita, una stringa “path”, in cui inseriamo l’indirizzo del feed RSS che vogliamo leggere. Alla riga successiva, infine, avviamo il parsing del feed (tramite il metodo “parseXMLFileAtURL”, di cui abbiamo definito l’intestazione nel file “RootViewController.h”), passando proprio l’indirizzo “path” come parametro.<\/p>\n
Tale metodo, per\u00f2, non \u00e8 ancora stato implementato nella nostra funzione. Ecco come dovremo definirlo:<\/p>\n
- (void)parseXMLFileAtURL:(NSString *)URL {\r\n\t\/\/ inizializziamo la lista degli elementi\r\n\telencoFeed = [[NSMutableArray alloc] init];\r\n\r\n\t\/\/ dobbiamo convertire la stringa \"URL\" in un elemento \"NSURL\"\r\n\tNSURL *xmlURL = [NSURL URLWithString:URL];\r\n\r\n\t\/\/ inizializziamo il nostro parser XML\r\n\trssParser = [[NSXMLParser alloc] initWithContentsOfURL:xmlURL];\r\n\r\n\t[rssParser setDelegate:self];\r\n\r\n\t\/\/ settiamo alcune propriet\u00e0\r\n\t[rssParser setShouldProcessNamespaces:NO];\r\n\t[rssParser setShouldReportNamespacePrefixes:NO];\r\n\t[rssParser setShouldResolveExternalEntities:NO];\r\n\r\n\t\/\/ avviamo il parsing del feed RSS\r\n\t[rssParser parse];\r\n}<\/pre>\n
Come vedete il metodo non \u00e8 molto complicato. I commenti presenti ci possono chiarire le varie istruzioni. Si parte dall’inizializzazione dell’array “elencoFeed”, per poi passare all’inizializzazione del parser XML e al suo avvio.<\/p>\n
Per funzionare correttamente, il parser ha bisogno di altri due metodi. Eccoveli (anche questi sono da inserire in “RootViewController.m”):<\/p>\n
- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict{\t\t\t\r\n\r\n\tcurrentElement = [elementName copy];\r\n\tif ([elementName isEqualToString:@\"item\"]) {\r\n\t\t\/\/ inizializza tutti gli elementi\r\n\t\titem = [[NSMutableDictionary alloc] init];\r\n\t\tcurrentTitle = [[NSMutableString alloc] init];\r\n\t\tcurrentDate = [[NSMutableString alloc] init];\r\n\t\tcurrentSummary = [[NSMutableString alloc] init];\r\n\t\tcurrentLink = [[NSMutableString alloc] init];\r\n\t}\r\n}\r\n\r\n- (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName{     \r\n\r\n\tif ([elementName isEqualToString:@\"item\"]) {\r\n\t\t\/* salva tutte le propriet\u00e0 del feed letto nell'elemento \"item\", per\r\n\t\t   poi inserirlo nell'array \"elencoFeed\" *\/\r\n\t\t[item setObject:currentTitle forKey:@\"title\"];\r\n\t\t[item setObject:currentLink forKey:@\"link\"];\r\n\t\t[item setObject:currentSummary forKey:@\"summary\"];\r\n\t\t[item setObject:currentDate forKey:@\"date\"];\r\n\r\n\t\t[elencoFeed addObject:[item copy]];\r\n\t}\r\n}<\/pre>\n
Questi due metodi vengono richiamati, rispettivamente, quando inizia e quando finisce un elemento XML. Nel primo caso dovremo re-inizializzare tutti gli elementi, in modo da poter leggere un nuovo elemento senza errori. Al contrario, quando un elemento XML termina dovremo salvare tutti questi valori letti in un unico elemento (“item”) e inserirlo nella lista dei feed letti (“elencoFeed”).<\/p>\n
Per completare la definizione del parser ci mancano altri due metodi:<\/p>\n
- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string{;\r\n\t\/\/ salva i caratteri per l'elemento corrente\r\n\tif ([currentElement isEqualToString:@\"title\"]){\r\n\t\t[currentTitle appendString:string];\r\n\t} else if ([currentElement isEqualToString:@\"link\"]) {\r\n\t\t[currentLink appendString:string];\r\n\t} else if ([currentElement isEqualToString:@\"description\"]) {\r\n\t\t[currentSummary appendString:string];\r\n\t} else if ([currentElement isEqualToString:@\"pubDate\"]) {\r\n\t\t[currentDate appendString:string];\r\n\t}\r\n}\r\n\r\n- (void) parserDidEndDocument:(NSXMLParser *)parser {\r\n\t[self.tableView reloadData];\r\n}<\/pre>\n
Il primo metodo viene richiamato ogni volta che viene letto un carattere all’interno del feed. A seconda dell’elemento che siamo considerando, andremo a inserire il carattere letto in coda a quelli gi\u00e0 letti dello stesso carattere, in modo da ricostruire l’informazione completa. Ad esempio, stiamo considerando l’elemento “title”. Vengono letti, nell’ordine, i seguenti caratteri “Dev”, “Tutorial “, “#2”. Unendo i vari caratteri letti ricostruiremo il titolo esatto del nostro feed, ovvero “DevTutorial #2”.<\/p>\n
Il secondo metodo, invece, viene richiamato solo quando il parser completa la lettura del feed RSS, e noi non faremo altro che dire alla tabella di “ricarcarsi” (verranno, quindi, richiamati i metodi per settare il numero di righe e per inserire il testo nelle varie celle).<\/p>\n
4. Concludiamo l’applicazione<\/h4>\n
Abbiamo ormai concluso la nostra applicazione!!<\/p>\n
Come sempre dobbiamo ricordarci di completare il metodo “dealloc”, che \u00e8 davvero molto importante, soprattutto nelle applicazioni di un certo grado di complessit\u00e0. Ecco come dovremo definire il metodo:<\/p>\n
- (void)dealloc {\r\n\t[currentElement release];\r\n\t[rssParser release];\r\n\t[elencoFeed release];\r\n\t[item release];\r\n\t[currentTitle release];\r\n\t[currentDate release];\r\n\t[currentSummary release];\r\n\t[currentLink release];\r\n\r\n    [super dealloc];\r\n}<\/pre>\n
Ora siamo pronti per compilare ed eseguire la nostra applicazione! Clicchiamo su “Build and Run!” e testiamo il nostro personalissimo lettore di feed RSS!!<\/p>\n
\"\"<\/a><\/p>\n
5. Un piccolo miglioramento<\/h4>\n
La nostra applicazione funziona ma.. provate a cliccare su un elemento. Non succeder\u00e0 niente. Non sarebbe invece pi\u00f9 carino se si aprisse una nuova vista in cui venisse caricato l’articolo completo. Ci baster\u00e0, quindi, creare una nuova vista, in cui inseriremo una UIWebView, che sar\u00e0 il nostro browser per l’articolo.<\/p>\n
Dal men\u00f9 “File” scegliamo “New File…”, andiamo nella sezione “Cocoa Touch Class” e scegliamo “UIViewController subclass” come tipo di classe, spuntando inoltre l’opzione “With XIB for user interface”:<\/p>\n
\"\"<\/a><\/p>\n
Inseriamo “ViewArticolo” come nome e clicchiamo su “Finish”. Abbiamo cos\u00ec creato la classe e la relativa vista.<\/p>\n
Apriamo il file “ViewArticolo.h” e inseriamo le seguenti dichiarazioni:<\/p>\n
\r\n#import \r\n\r\n@interface ViewArticolo : UIViewController {\r\n\tIBOutlet UIWebView *webView;\r\n\r\n\tNSString *indirizzo;\r\n}\r\n\r\n@property (nonatomic, retain) NSString *indirizzo;\r\n\r\n@end<\/pre>\n
Come potete facilmente notare, abbiamo dichiarato una UIWebView (che andremo fra poco a definire in Interface Builder) e una variabile indirizzo, che conterr\u00e0 l’URL dell’articolo da caricare.<\/p>\n
Apriamo ora il file “ViewArticolo.m” e inseriamo il seguente codice (che vi abbiamo gi\u00e0 spiegato in questo tutorial<\/a>):<\/p>\n
#import \"ViewArticolo.h\"\r\n\r\n@implementation ViewArticolo\r\n\r\n@synthesize indirizzo;\r\n\r\n\/\/ Implement viewDidLoad to do additional setup after loading the view, typically from a nib.\r\n- (void)viewDidLoad {\r\n    [super viewDidLoad];\r\n\t\/\/crea un oggetto URL\r\n\tNSURL *url = [NSURL URLWithString:indirizzo];\r\n\tNSURLRequest *requestObj = [NSURLRequest requestWithURL:url];\r\n\t\/\/ visualizza la pagina nella UIWebView\r\n\t[webView loadRequest:requestObj];\r\n}<\/pre>\n
Salviamo entrambi i file e apriamo “ViewArticolo.xib”, in cui andremo ad inserire la UIWebView. Dalla Libreria prendiamo un componente di tipo UIWebView e inseriamolo nella vista, cos\u00ec:<\/p>\n
\"\"<\/a><\/p>\n
Apriamo, infine, il Pannello dei Documenti, selezioniamo il “File’s Owner” \u00a0e colleghiamo l’elemento “webView” con la UIWebView che abbiamo appena inserito nella vista:<\/p>\n
\"\"<\/a><\/p>\n
Salviamo tutto e chiudiamo Interface Builder.<\/p>\n
Abbiamo quasi concluso! Torniamo al file\u00a0“RootViewController.m” e cerchiamo il metodo “tableView: didSelectRowAtIndexPath:” (\u00e8 uno di quelli commentati che vi avevo accennato prima). Questo metodo viene richiamato ogni volta che si “clicca” su una cella. Sar\u00e0 qui che andremo ad inserire il codice necessario che ci permetter\u00e0 di aprire la news selezionata:<\/p>\n
\/\/ Override to support row selection in the table view.\r\n- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {\r\n\r\n\t\/\/ ricaviamo il link dell'elemento selezionato\r\n\tNSString *link = [[elencoFeed objectAtIndex:indexPath.row] objectForKey: @\"link\"];\r\n\r\n\t\/\/ ripiliamo il link da spazi, return e tabs\r\n\tlink = [link stringByReplacingOccurrencesOfString:@\" \" withString:@\"\"];\r\n\tlink = [link stringByReplacingOccurrencesOfString:@\"\\n\" withString:@\"\"];\r\n\tlink = [link stringByReplacingOccurrencesOfString:@\"\t\" withString:@\"\"];\r\n\r\n\t\/\/ apriamo la nuova vista\r\n\tViewArticolo *controller = [[ViewArticolo alloc] initWithNibName:@\"ViewArticolo\" bundle:nil];\r\n\tcontroller.indirizzo = link;\r\n\t[self.navigationController pushViewController:controller animated:YES];\r\n}<\/pre>\n
Il procedimento \u00e8 molto simile a quello visto per la definizione delle celle della tabella. Alla riga 4, infatti, andiamo a ricavare la propriet\u00e0 “link” dell’elemento selezionato, associandola ad una stringa chiamata appunto “link”. Con le istruzioni seguenti, invece, ripuliamo l’indirizzo da eventuali caratteri indesiderati, come spazi, return o tab. Con le ultime istruzioni inizializziamo la classe relativa alla vista che abbiamo appena definito, passandogli come parametro l’indirizzo dell’articolo che l’utente ha selezionato.<\/p>\n
Manca solo una piccolissima cosa da fare: sempre nel file “RootViewController.m” inseriamo l’importazione della “ViewArticolo” (riga 2):<\/p>\n
#import \"RootViewController.h\"\r\n#import \"ViewArticolo.h\"\r\n\r\n@implementation RootViewController<\/pre>\n
Salviamo il tutto, clicchiamo su “Build and Run” e godiamoci la nostra bellissima applicazione!!<\/p>\n
\"\"<\/a><\/p>\n
\"\"<\/a> Se avete problemi con il tutorial, questo \u00e8 il nostro file di progetto.<\/a><\/p>\n
Nota:<\/span><\/strong> Purtroppo “NSXMLParser” \u00e8 l’unico parser XML semplice e disponibile su iPhone. Questo ha molti svantaggi, non \u00e8 perfetto e presenta diversi problemi relativi alla gestione della memoria. Per questo esempio, tuttavia, \u00e8 pi\u00f9 che sufficiente, per\u00f2 se vi servisse per un’applicazione pi\u00f9 complessa prendete in seria considerazione l’idea di realizzarvi un parser tutto vostro.<\/p>\n
La guida \u00e8 stata tradotta e ampliata da Andrea Busi. Trovare la versione originale a questo indirizzo: <\/em>iPhone SDK Tutorial: Build a Simple RSS reader for the iPhone<\/em><\/a>. I meriti, quindi, sono dei legitimi autori per le rispettive versioni.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"
Oggi parleremo ancora di XML, questa volta, per\u00f2, con un esempio pratico. Andremo a creare infatti, con…<\/p>\n","protected":false},"author":254,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[216,225,226,223,88,224],"class_list":["post-3420","post","type-post","status-publish","format-standard","hentry","category-tutorial-pratici","tag-andrea-busi","tag-feed-rss-iphone","tag-nsxmlparser","tag-parsing-xml","tag-programmazione-iphone","tag-xml-iphone"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/posts\/3420","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/users\/254"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/comments?post=3420"}],"version-history":[{"count":13,"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/posts\/3420\/revisions"}],"predecessor-version":[{"id":9462,"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/posts\/3420\/revisions\/9462"}],"wp:attachment":[{"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/media?parent=3420"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/categories?post=3420"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devapp.it\/wordpress\/wp-json\/wp\/v2\/tags?post=3420"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}