Share
Våre iOS-enheter er koblet til Internett mesteparten av tiden, og de fleste appene på enhetene våre kobler selvfølgelig til en ekstern server for å hente denne eller den lille delen av data hver eneste gang.
Noen apps bruker bare litt data, bare henter de siste overskriftene hver time eller så. Andre apper samhandler mye med en backend-tjeneste mens brukeren gjennomsøker sin sosiale feed, leser gjennom innlegg og laster opp bilder.
Dagene at hver webtjeneste snakket XML er langt borte. I dag kommuniserer de fleste mobile applikasjoner med webtjenester ved hjelp av JSON. Hvis du planlegger å lage et mobilprogram som snakker til en ekstern backend, er det sjansen for at du må kunne sende og motta JSON.
JSONModel er et åpen kildebibliotek som er skrevet i Objective-C, som hjelper deg med å hente JSON fra en server, analysere det og initialisere modellklassene dine med dataene. Det validerer også JSON-data, kaskader gjennom nestede modeller og mer.
"Men vent!" du kan tenke "Jeg skrev allerede en iPhone app som henter noe JSON og viser det på skjermen. Det var ganske enkelt!"
Vel, det er delvis sant. NSJSONSerialization har vært tilgjengelig siden iOS 5, så det er ganske enkelt ganske enkelt å konvertere et JSON-svar til en NSDictionary gjenstand. Dette fungerer fint for enkle applikasjoner, men tro meg når jeg sier at dette ikke er en god ide for et komplekst program med en kompleks datamodell. La oss se hvordan JSONModel kan lagre baconet ditt.
Merk at jeg er forfatter av JSONModel, utvikle og vedlikeholde biblioteket ved hjelp av bidragsytere på GitHub. Jeg er åpenbart partisk, men dette er gode nyheter for deg som du vil kunne lære av personen som opprettet biblioteket.
I denne delen vil jeg kortlegge og diskutere de grunnleggende funksjonene i biblioteket. Hvis du er for ivrig etter å dykke inn i kode, hopper du over til neste del, Hello Chuck App.
Når du ser på JSON-dataene som fyller modellobjektet, føler du deg ofte tilbøyelig til å matche navnene på tastene som brukes i JSON-dataene. Du ender opp med å skrive kode som ser slik ut:
self.firstName = [json objectForKey: @ "firstName"]; self.familyName = [json objectForKey: @ "familyName"]; self.age = [json objectForKey: @ "age"];
Med JSONModel trenger du ikke å skrive denne typen boilerplate-kode. JSONModel karter automatisk JSON til egenskapene til modellklassen.
JSONModel inspiserer automatisk egenskapene til modellklassen din og sikrer at JSON som brukes til å initialisere et modellobjekt, stemmer overens med modellklassdefinisjonen. Hvis det er en feilmatch, blir ikke modellen objektet initialisert.
I tillegg verifiserer modellen at JSON-dataene samsvarer med typene som er definert av modellklassen. Hvis du får en matrise i stedet for en streng, anses JSON-dataene som ugyldige.
På grunn av JSONs enkle spesifikasjon er det enkelt å bruke, men det fjerner også mye metadata når det brukes til å overføre data fra en backend til en klient og omvendt. Et JSON-objekt kan bare inneholde strenge, tall, arrays og objekter.
I objektiv-C-modellen har du vanligvis egenskaper av ulike typer, ikke begrenset til strenge og tall, som er de eneste datatypene som støttes av JSON. For eksempel har du ofte nettadresser i et JSON-objekt. Det er enkelt å konvertere en streng i et JSON-objekt til en NSURL objekt, men den irriterende delen er at du trenger å gjøre dette selv.
JSONModel la oss definere transformasjoner for datatyper en gang og bruke dem på tvers av modellene dine. Hvis en JSON-respons for eksempel gir deg en dato som tidsstempel i form av et heltall, må du bare fortelle JSONModel hvordan du konverterer heltallet til en NSDate objekt en gang. Du lærer mer om datatransformasjoner i den andre delen av denne serien.
Oftere enn ikke, har en JSON-respons en kompleks struktur. Et objekt kan for eksempel inneholde en eller flere andre objekter. Ta en titt på følgende JSON-objekt.
"id": 10, "mer": "tekst": "ABC", "count": 20
JSONModel, la oss også få rede på nestmodellklasser. Det spiller ingen rolle om modellen din inneholder en annen modell eller en rekke modellobjekter, JSONModel inspiserer modellklassene og initierer automatisk objekter av riktig type. Vi tar en nærmere titt på nestede modeller litt senere.
Det er nok teori for nå. La oss lære å bruke JSONModel-biblioteket ved å lage et enkelt, prøveprogram.
Nå som du har en grunnleggende ide hva JSONModel gjør, vil du utvikle en enkel app som henter en JSON-feed av Chuck Norris vitser og viser dem til brukeren en etter en. Når du er ferdig, ser appen noe ut som dette:
Start Xcode 5, opprett et nytt prosjekt ved å velge Nytt> Prosjekt ... fra Fil menyen, og velg Enkeltvisningsprogram mal fra listen over iOS-applikasjon maler.
Gi navnet navnet på prosjektet HelloChuck, Fortell Xcode hvor du vil lagre den, og klikk Skape. Det er ikke nødvendig å sette prosjektet under kildekontroll.
Deretter laster du ned den nyeste versjonen av JSONModel-biblioteket fra GitHub, pakker ut arkivet og har en topp inne.
Arkivet inneholder demo-applikasjoner for iOS og OSX, enhetstester og mer. Du er bare interessert i mappen som heter JSONModel. Dra den til ditt Xcode-prosjekt. Installasjonen er enda enklere hvis du bruker CocoaPods.
JSON-fôret du skal bruke er ganske enkelt. Den inneholder en rekke vitser, med hver vits å ha et id, vitsen selv, og, eventuelt, en rekke koder.
"id": 7, "text": "Det pleide å være en gate oppkalt etter Chuck Norris, men den ble endret fordi ingen krysser Chuck Norris og lever", "tags": ["id": 1, "tag" : "dødelig", "id": 2, "tag": "nytt"]
La oss begynne med å lage modellklassen for å matche JSON-dataene. Lag en ny klasse, JokeModel, og gjør det arv fra JSONModel. Legg til id og tekst egenskaper som samsvarer med tastene i JSON-dataene slik:
@interface JokeModel: JSONModel @property (tilordne, ikkeatomisk) int id; @property (strong, nonatomic) NSString * tekst; @slutt
JSONModel-biblioteket konverterer automatisk tall for å matche egenskapens type.
Du må også opprette en klasse for taggenobjektene i JSON-dataene. Lag en ny klasse, TagModel, og gjør det arv JSONModel. Erklære to egenskaper id og stikkord av type NSString. De TagModel klassen skal se slik ut:
@interface TagModel: JSONModel @property (sterk, ikkeatomisk) NSString * id; @property (strong, nonatomic) NSString * tag; @slutt
Legg merke til at du har angitt typen av id til NSString. JSONModel vet helt fint hvordan man forvandler tall til strenger, det vil håndtere transformasjonen for deg. Tanken er at du bare trenger å fokusere på dataene du trenger i søknaden din uten å måtte bekymre deg for hva JSON-dataene ser ut som.
Selv om TagModel klassen er klar til bruk, du trenger en måte å fortelle JokeModel klasse som nøkkelen tags inneholder en liste over TagModel forekomster. Dette er veldig enkelt å gjøre med JSONModel. Legg til en ny tom protokoll i TagModel.h og ring det TagModel:
@protocol TagModel @end
Åpen JokeModel.h og importer headerfilen til TagModel klasse:
#import "TagModel.h"
Her kommer den magiske. Erklære en ny eiendom til JokeModel som vist nedenfor. De tags Eiendommen er av typen NSArray og det samsvarer med to protokoller.
Accentsconagua
