3. Persistenz und Datenbanken Content Providers. Content Providers. Generische Schnittstelle zum Zugriff auf Daten zwischen Anwendungen

Transkript

1 Content Providers Generische Schnittstelle zum Zugriff auf Daten zwischen Anwendungen Entkopplung der Daten-Schicht von der Anwendungsschicht Zugriff erfolgt URI-basiert Kontrolle der Zugriffsrechte eingebaute Datenquellen (z.b. Kontakte) sind Content Provider Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

2 Nutzung eines Content Provider Zugriff durch Instanz von ContentResolver Resolver erhältlich über den Anwendungskontext: ContentResolver cr = getcontentresolver(); Der Provider wird durch eine URI angegeben, die der Provider selbst festlegt. siehe Paket android.provider, zugehörige Klassen und Konstanten CONTENT URI Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

3 Content URIs Typischerweise zwei Arten: URI für alle Datensätze (Tupel) URI für einen einzelnen Datensatz, üblicherweise gebildet durch Anhängen von /tupelid an die URI für alle Datensätze Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

4 Anfragen Resultat als Cursor Anfragemethode: query() Parameter: URI des Content Provider (Uri) Projektion auf bestimmte Spalten/Attribute (String[]) Bedingung an die Ergebnismenge entsprechend einer WHERE-Klausel, kann? als Platzhalter enthalten (String) Parameter für die Platzhalter in der WHERE-Bedingung (String[]) Reihenfolge der Datensätze (String) Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

5 Alle Datensätze: Cursor allrows = getcontentresolver.query(myprovider.content URI, null, null, null, null); Alle Datensätze, deren 3. Spalte mit einem erforderlichen Wert übereinstimmt und Sortierung der Ergebnismenge nach der 5. Spalte: String where = KEY COL3 + "=" + requiredvalue; String order = KEY COL5; Cursor somerows = getcontentresolver.query(myprovider.content URI, null, where, null, order); Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

6 Insert Datensätze werden repräsentiert als Instanzen von ContentValues Einfügen eines einzelnen Datensatzes: insert() Parameter: URI, ContentValues-Instanz Ergebnis: URI für den eingefügten Datensatz Einfügen mehrerer Datensätze: bulkinsert() Parameter: URI, Feld von ContentValues Ergebnis: Anzahl der eingefügten Datensätze Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

7 Einzelnen Datensatz einfügen: ContentValues row = new ContentValues(); row.put(column NAME, value);... Uri rowuri = getcontentresolver().insert(myprovider.content URI, row); Mehrere Datensätze einfügen: ContentValues[] rows = new ContentValues[n]; for (int i=0 ; i<n ; i++) { rows[i] = new ContentValues(); rows[i].put(column NAME, value);... } int count = getcontentresolver().bulkinsert(myprovider.content URI, rows) Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

8 Delete Einzelnen Datensatz löschen mit Hilfe der URI des Datensatzes: getcontentresolver().delete(rowuri, null, null); Mehrere Datensätze löschen mit URI des Content Provider und optionaler WHERE-Klausel: String where = "id < 5"; getcontentresolver().delete(myprovider.content URI, where, null); Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

9 Update ContentValues-Instanz: ContentValues row = new ContentValues(); row.put(column NAME, value);... WHERE-Klausel: String where = "id < 5"; Durchführung: getcontentresolver().update(myprovider.content URI, value, where, null) Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

10 Dateien im Content Provider Werden als URIs repräsentiert, internes Mapping zwischen URI und Datei Methoden openouputstream() bzw. openinputstream() um Daten zu schreiben bzw. zu lesen Beispiel: Uri uri = getcontentresolver().insert(myprovider.content URI, value); try { OutputStream = getcontentresolver().openoutputstream(uri); bitmap.compress(bitmap.compressformat.jpeg, 50, outstream); Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

11 } catch (FileNotFoundException e) { } Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

12 Native Android Content Providers Alle in Android eingebauten Content Provider können mit den dargestellten Techniken genutzt werden. Evtl. einfachere Nutzung mit den Klassen im Paket android.provider Einige Android Content Provider: Browser: Zugriff auf Bookmarks, History und gespeicherte Suchanfragen CallLog: Zugriff auf Anruflisten Contacts: Zugriff auf Kontakte Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

13 MediaStore: Zentraler Zugriff auf alle Multimedia-Daten des Gerätes Settings: Zugriff auf die Einstellungen des Gerätes Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

14 Beispiel: Contacts // Get a cursor over every contact. Cursor cursor = getcontentresolver().query(people.content_uri, null, null, null, null); // Let the activity manage the cursor lifecycle. startmanagingcursor(cursor); // Use the convenience properties to get the index of the columns. int nameidx = cursor.getcolumnindexorthrow(people.name); int phoneidx = cursor.getcolumnindexorthrow(people.number); String[] result = new String[cursor.getCount()]; boolean rowavail = cursor.movetofirst(); Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

15 while ( rowavail ) { // Extract the name. String name = cursor.getstring(nameidx); // Extract the phone number. String phone = cursor.getstring(phoneidx); result[cursor.getposition()] = name + " (" + phone + ")"; rowavail = cursor.movetonext(); } Damit dieses Beispiel ausgeführt werden kann, muss die READ CONTACTS Permission dem Manifest hinzugefügt werden. Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

16 Definition eines Content Provider Ableiten von der abstrakten Klasse ContentProvider Überschreiben der Methode oncreate(): Hier wird die Datenquelle erzeugt bzw. geöffnet. CONTENT URI breitstellen als Uri-Konstante Überschreiben der Zugriffsmethoden: query(), insert(), update(), delete() Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

17 Content Provider URI Allgemeine Form einer Content Provider URI: content://tld.firmenname.provider.anwendung/datenpfad Beispiel: content://de.mobisports.provider.quadroid/items Weitere Form für einen bestimmten Datensatz, typischerweise durch Anhängen einer Datensatznummer: context://de.mobisports.provider.quadroid/items/4711 Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

18 URI-Matching Einfachere Analyse von Content-URIs mit einem UriMatcher Definition der CONTENT URI: private static final String myuri = "content://de.mobisports.provider.quadroid/items"; public static final Uri CONTENT_URI = Uri.parse(myURI); Definition von Konstanten zur Unterscheidung der URI-Arten: private static final int ALLROWS = 1; private static final int SINGLE_ROW = 2; Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

19 Deklaration des UriMatcher: private static final UriMatcher urimatcher; Erzeugung des UriMatcher und Zuordnung der URIs: static { urimatcher = new UriMatcher(UriMatcher.NO_MATCH); urimatcher.adduri("de.mobisports.provider.quadroid", "items", ALLROW urimatcher.adduri("de.mobisports.provider.quadroid", "items/#", SING } public Cursor query(uri uri, String[] projection, Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

20 } String selection, String[] selectionargs, String sort) { switch ( urimatcher.match(uri) ) { case SINGLE_ROW :... break; case ALLROWS :... break; }... Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

21 MIME Type Für die Daten eines Content Provider sollten MIME Types nach folgendem Schema definiert werden: einzelner Datensatz: vnd.firmenname.cursor.item/content-type Menge von Datensätzen: vnd.firmenname.cursor.dir/content-type In der Content Provider Klasse ist hierzu die Methode gettype() zu überschreiben: Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

22 @Override public String gettype(uri uri) { switch ( urimatcher.match(uri) ) { case SINGLE_ROW : return "vnd.mobisports.cursor.item/mycontent"; case ALLROWS : return "vnd.mobisports.cursor.dir/mycontent"; default : throw new IllegalArgumentException("Unsupported URI: " + } } Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS

23 Registrierung des Content Provider Der Content Provider muss im Manifest registriert werden! Beispiel: <provider android:name="myprovider" android:authorities="de.mobisports.provider.quadroid"/> Mobile Informationssysteme I Hochschule Bonn-Rhein-Sieg, SS