Mobile  App   Development -­‐  Content  Provider  -­‐

Inhalt

• Was sind Content Provider • Content Provider nutzen • Content Provider implementieren

Mobile  App  Development

Content  Provider

Mobile  App  Development

Content  Provider • Einige Apps besitzen Daten, die u. U. auch für andere Apps interessant sein können
 
 
 


MyApp

Mobile  App  Development

?

Other App

Content  Provider • Einige Apps besitzen Daten, die u. U. auch für andere Apps interessant sein können

• Wie können die Daten anderen Apps zur Verfügung gestellt werden?





MyApp


 
 Mobile  App  Development

?

Other App

Content  Provider • Content Provider ermöglichen die Nutzung und Bereitstellung von Daten von/für andere Apps

• Sie bilden eine Abstraktionsschicht als einheitliche Sicht auf Daten

• Die Nutzung der Daten ist unabhängig von der internen Repräsentation

Mobile  App  Development

Content  Provider • Die angebotenen Daten haben einen Tabellen-artigen Aufbau

• Beispiel: Wörterbuch

Quelle:  h3p://developer.android.com/guide/topics/providers/content-­‐provider-­‐basics.html

Mobile  App  Development

Content  Provider • Der Zugriff auf die Daten erfolgt über Datenbanken-ähnliche Schnittstellen

• • • •

query():  Abrufen  von  Daten   insert():  Einfügen  von  Daten   update():  Aktualisieren  von  Daten   delete():  Löschen  von  Daten

Mobile  App  Development

Content  Provider • Content Provider werden über URIs angesprochen

• Diese geben neben dem Schema den

symbolischen Namen der CPs und den Pfad zur eigentlichen Tabelle an

• Aufbau
 content://authority/path/id Mobile  App  Development

Content  Provider • Aufbau: content://authority/path/id • content:  Content  Provider  Schema   • authority:  symbolischer  Name  des  Content  Providers   • path:  Der  Pfad  zur  Tabelle  (ein  CP  kann  mehrere   Tabelle  anbieten)   • id:  id  eines  Datensatzes

Mobile  App  Development

Content  Provider

• Beispiel: Wörterbuch Content Provider • content://user_dictionarry
 
 
 UserDic:onary 


Mobile  App  Development

Content  Provider • Beispiel: Wörterbuch Content Provider • content://user_dictionarry/words
 
 
 UserDic:onary Words

Mobile  App  Development

Content  Provider • Beispiel: Wörterbuch Content Provider • content://user_dictionarry/words/2



 UserDic:onary Words 1 2 3 4

Mobile  App  Development

Content  Provider

• Beispiel: Browser Content Provider • content://browser
 
 
 Browser 


Mobile  App  Development

Content  Provider • Beispiel: Browser Content Provider • content://browser/searches   • content://browser/bookmarks
 
 Browser

searches

Mobile  App  Development

bookmarks

1

1

2

2

3

3

4

4

Content  Provider • Beispiel: Browser Content Provider • content://browser/searches/3   • content://browser/bookmarks/2
 Browser searches

Mobile  App  Development

bookmarks

1

1

2

2

3

3

4

4

Content  Provider  nutzen

Mobile  App  Development

Content  Provider  nutzen • Um Daten von einem Content Provider

abzufragen oder zu manipulieren, müssen entsprechende Berechtigungen im Manifest eingetragen werden

• Beispiel: Auslesen der Anrufhistorie
 Mobile  App  Development

Content  Provider  nutzen • ContentResolver bilden die Client-Seite zum Server-seitigen ContentProvider

• Sie dienen der Abfrage und Manipulation von Daten

• Mittels query()-Methode auf dem

ContentResolver können Daten abgefragt werden

Mobile  App  Development

Content  Provider  nutzen • Die query()-Methode ist einer SQL-Query sehr ähnlich

• Die Parameter umfassen: • ProjekNon:       • gibt  an,  welche  Tabellenspalten  abgefragt  werden  sollen   • entspricht  
 SELECT Col1, Col2 FROM ...

Mobile  App  Development

Content  Provider  nutzen • Die Parameter umfassen: • SelekNon   • Einschränkung  der  Ergebnismenge   • entspricht  der  WHERE-­‐Bedingung  eines  SELECT  Statements  

• SelekNons-­‐Parameter   • dienen  der  Parametrisierung  der  SelekNon   • z.  B.:  SELECT  ...  FROM  ...  WHERE  Spalte  =  ?

Mobile  App  Development

Content  Provider  nutzen

• Die Parameter umfassen: • SorNerung   • gibt  an,  wie  die  Ergebnismenge  sorNert  werden  soll   • entspricht  dem  ORDER BY Statement  einer  SQL-­‐Abfrage

Mobile  App  Development

Content  Provider  nutzen • Beispiel: Wörterbuch auslesen • Das  benutzerdefinierte  Wörterbuch  wird  über  den   Content  Provider  UserDicNonary  bereitgestellt   • Um  es  zu  lesen  wird  die  BerechNgung  
 android.permission.READ_USER_DICTIONARY


benöNgt

Mobile  App  Development

Content  Provider  nutzen • Beispiel: Wörterbuch auslesen private void readDictionary(Context context) {   // Referenz auf eine ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();   // URI zur Words-Tabelle im Wörterbuch: 
 // content://user_dictionary/words   Uri uri = UserDictionary.Words.CONTENT_URI;   // Projektion: gibt an, welche Tabellen Spalten abgerufen werden   String[] projection = new String[]{Words.WORD, Words.FREQUENCY};  

 

// Wörter unter Angabe von URI und Projektion abfragen   Cursor cursor = cr.query(Words.CONTENT_URI, projection, null, null, null);  

 

// Cursor verarbeiten ...   }

Mobile  App  Development

 

Content  Provider  nutzen • Beispiel: Wörterbuch auslesen

private void readDictionary(Context context) {   ContentResolver cr = context.getContentResolver();   Uri uri = UserDictionary.Words.CONTENT_URI;   String[] projection = new String[]{Words.WORD, Words.FREQUENCY};   Cursor cursor = cr.query(Words.CONTENT_URI, projection,   null, null, null);  

 

// Verarbeitung des Cursors erfolgt wie bei Datenbanken   if (cursor.moveToFirst()) {   int wordIdx = cursor.getColumnIndex(Words.WORD);   int freqIdx = cursor.getColumnIndex(Words.FREQUENCY);   do {  

}  

 

Log.d(LOG, cursor.getString(wordIdx) +   " (" + cursor.getInt(freqIdx) + ")");   } while (cursor.moveToNext());  

 

cursor.close(); // Cursor schließen   }

Mobile  App  Development

Content  Provider  nutzen • Beispiel: Wörterbuch auslesen (mit Selektion) private void readDictionary(Context context) {   // Referenz auf eine ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();   // URI zur Words-Tabelle im Wörterbuch   Uri uri = UserDict ionary.Words.CONTENT_URI;   // Projektion: gibt an, welche Tabellen Spalten abgerufen werden   String[] projection = new String[]{Words._ID, Words.WORD, Words.FREQUENCY};  

 

String selection = Words.WORD + " LIKE ?"; // Wörter, beginnend mit 'A'   String[] selArgs = new String[]{"A%"}; // Selektionsparameter   String sortOrder = Words.WORD + " DESC"; // absteigende Sortierung  

 

// Query ausführen   Cursor cursor = cr.query(Words.CONTENT_URI, projection, selection, selArgs, sortOrder);   // Cursor verarbeiten   }

Mobile  App  Development

 

Content  Provider  nutzen • Beispiel: Wörterbuch auslesen (festgelegte ID) private void readFromDictionary(Context context, int id) {  

 

// Referenz auf eine ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();  

 

// URI zu bestimmtem Datensatz im Wörterbuch   Uri uri = ContentUris.withAppendedId(   UserDictionary.Words.CONTENT_URI, id);  

 

// content://user_dictionary/words/   Log.d(LOG, "read uri: " + uri);  

 

// Anfrage ausführen: Cursor enthält nur einen Datensatz, // das Wort mit der angegebenen ID   Cursor cursor = cr.query(uri, null, null, null, null);   }

Mobile  App  Development

 

Content  Provider  nutzen • Beispiel: Anruflisten auslesen • Die  Anruflisten  werden  durch  den  Content  Provider   CallLog  bereitgestellt   • Um  Anruflisten  lesen  zu  können,  muss  die   BerechNgung  
 android.permission.READ_CALL_LOG


vorhanden  sein

Mobile  App  Development

Content  Provider  nutzen • Beispiel: Anruflisten auslesen private void readCallLog(Context context) {   // ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();   // Projektion mit Anruftyp, Name und Nummer erstellen   String[] projection = new String[]{CallLog.Calls.TYPE, CallLog.Calls.CACHED_NAME, CallLog.Calls.NUMBER};  

 

// Selektion für Anruftyp INCOMMING   String selection = CallLog.Calls.TYPE + "=" + CallLog.Calls.INCOMING_TYPE;   // URI zum Call log   Uri uri = Uri.parse("content://call_log/calls");   // Query an ContentProvider senden   Cursor cursor = cr.query(uri, projection, selection, null, null);  

 

// ... Cursor verarbeiten ... }

Mobile  App  Development

 

Content  Provider  nutzen • Daten einfügen • Das  Einfügen  von  Daten  wird  mi3els  insert()-­‐ Methode  realisiert   • Sie  erhält  ein  ContentValues  Objekt,  in  das  die  Werte   für  die  verschiedenen  Spalten  eingetragen  werden   • Rückgabewert  ist  der  URI  zum  eingefügten  Datensatz

Mobile  App  Development

Content  Provider  nutzen • Beispiel: Wörterbuch Daten einfügen private void writeToDictionary(Context context) {   // Referenz auf eine ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();  

 

// ContentValues Objekt erstellen   ContentValues vals = new ContentValues();  

 

// neuees Wort eintragen   vals.put(Words.WORD, "neuesWort");   // Worthäufigkeit eintragen   vals.put(Words.FREQUENCY, 100);   // Land und Sprache setzten   vals.put(Words.LOCALE, Locale.getDefault().toString());  

 

// neuen Datensatz einfügen   Uri result = cr.insert(UserDictionary.Words.CONTENT_URI, vals);  

 

Log.d(LOG, "uri: " + result);   // liefert: content://user_dictionary/words/   }

Mobile  App  Development

Content  Provider  nutzen • Daten einfügen (bulk insert) private void bulkWriteToDictionary(Context context, String[] words) {   // Referenz auf eine ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();  

 

// Array für ContentValues Objekt erstellen   ContentValues[] cValues = new ContentValues[words.length];  

 

// ContentValues Objekte erstellen   for (int i = 0; i < words.length; i++) {   ContentValues vals = new ContentValues();   vals.put(Words.WORD, words[i]);   cValues[i] = vals;   }  

 

// ContentValues Objekte einfügen   cr.bulkInsert(UserDictionary.Words.CONTENT_URI, cValues);   }

Mobile  App  Development

Content  Provider  nutzen • Daten aktualisieren • Content  Provider  Einträge  können  mit  der   update()-­‐Methode  aktualisiert  werden   • Sie  erhält  ein  ContentValues-­‐Objekt  mit  den  neuen   Werten  und  analog  zu  einem  SQL  Update  eine   SelekNon

Mobile  App  Development

Content  Provider  nutzen • Daten aktualisieren private void updateDictionary(Context context) {   // Referenz auf eine ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();  

 

// ContentValues Objekt erstellen   ContentValues values = new ContentValues();   values.put(UserDictionary.Words.WORD, "neuesWort");   values.put(UserDictionary.Words.FREQUENCY, 100);   values.putNull(UserDictionary.Words.LOCALE);  

 

// Selektion für die zu aktualisierenden Objekte erstellen   String selection = UserDictionary.Words.LOCALE + " LIKE ?";   String[] selectionArgs = new String[]{"en_%"};  

 

// Einträge aktualisieren   cr.update(UserDictionary.Words.CONTENT_URI, values, selection, selectionArgs);   }

Mobile  App  Development

 

Content  Provider  nutzen

• Daten löschen • Datensätze  werden  mit  der  delete()-­‐Methode   gelöscht   • Sie  erhält  eine  SelekNon,  für  die  Datensätze  die   gelöscht  werden  sollen

Mobile  App  Development

Content  Provider  nutzen • Daten löschen private void deleteDictionary(Context context) {  

 

// Referenz auf eine ContentResolver Instanz abrufen   ContentResolver cr = context.getContentResolver();  

 

// Selektion für die Datensätze erstellen, die gelöscht werden sollen   String selection = UserDictionary.Words.WORD + " LIKE ? AND " + 
 UserDictionary.Words.LOCALE + " LIKE ?";   String[] selectionArgs = new String[]{"a%", "de_%"};  

 

// Datensätze löschen   cr.delete(UserDictionary.Words.CONTENT_URI, selection, selectionArgs);   }

Mobile  App  Development

Content  Provider  implemen:eren

Mobile  App  Development

Content  Provider  implemen:eren

• Content Provider müssen analog zu

Activities, Services und BCRs im Manifest eingetragen werden

• Hier werden neben dem Namen des

Content Providers u. U. Berechtigungen eingetragen, die der Nutzer des Content Providers benötigt

Mobile  App  Development

Content  Provider  implemen:eren

• Manifest Eintrag      

Mobile  App  Development

Content  Provider  implemen:eren

• Content Provider authority • gibt  den  Android-­‐internen  Namen  des  Content   Providers  an   • Als  authority-­‐Basis  sollte  der  App  Package  Name   verwendet  werden,  um  Konflikte  mit  anderen   Providern  zu  vermeiden   • Beispiel  authority:
 content://de.htwds.mada.todoprovider

Mobile  App  Development

Content  Provider  implemen:eren

• Content Provider URIs • Für  jede  Tabelle,  die  der  CP  anbietet  muss  ein  URI   definiert  werden   • Der  URI  wird  auf  Basis  der  Authority  erstellt   • Beispiel:
 content://de.htwds.mada.todoprovider/todo
 content://de.htwds.mada.todoprovider/priority

Mobile  App  Development

Content  Provider  implemen:eren

• Die Implementierung eines Content Providers leitet von der Klasse ContentProvider ab

• Es müssen die Methoden query(),

insert(), update(), delete() und getType() implementiert werden

Mobile  App  Development

Content  Provider  implemen:eren

• Jede der Methode bekommt ein URI

übergeben, womit der CP entscheidet, was zu tun ist

• Beispiel public Cursor query(Uri uri, ...) {   String authority = "content://de.htwds.mada.todo";   if (uri.toString().equals(authority + "/todo")) {   // alle Todos zurückgeben   } else if (uri.toString()   .matches(authority + "/todo/*")) {   // id aus URI parsen und Datensatz zurückgeben   }   } Mobile  App  Development

Content  Provider  implemen:eren

• Das Parsen von URIs mittel String Matching kann sehr umständlich werden

• Verschachtelte if-else Blöcke sind nicht mehr gut zu lesen

• Abhilfe schaffen die Utility-Klassen URIMatcher und ContentUris

Mobile  App  Development

Content  Provider  implemen:eren

• Die Klasse URIMatcher ordnet URI

Mustern Integer zu, die in switch-case Statements verwendet werden können

• Platzhalter: * und # • Beispiel String authority = "de.htwds.mada.todo";   UriMatcher matcher = new UriMatcher(0);   matcher.addURI(authority, "todo", 1);   matcher.addURI(authority, "todo/#", 2); matcher.addURI(authority, "priority", 3);   matcher.addURI(authority, "category/#", 4); Mobile  App  Development

Content  Provider  implemen:eren String authority = "de.htwds.mada.todo";   UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);   matcher.addURI(authority, "todo", 1);   matcher.addURI(authority, "todo/#", 2); matcher.addURI(authority, "priority", 3);   matcher.addURI(authority, "category/#", 4);

URI  Muster

Code

conent://de.htwds.mada.todo/todo

1

conent://de.htwds.mada.todo/todo/#

2

conent://de.htwds.mada.todo/priority

3

conent://de.htwds.mada.todo/priority/#

4

Mobile  App  Development

Content  Provider  implemen:eren URI  Muster

Code

conent://de.htwds.mada.todo/todo

1

conent://de.htwds.mada.todo/todo/#

2

conent://de.htwds.mada.todo/priority

3

conent://de.htwds.mada.todo/priority/#

4

public Cursor query(Uri uri, ...) {   int uriCode = matcher.match(uri);   switch (uriCode) {   case 1: { /* alle Todos zurückgeben */ }   case 2: { /* Todo mit ID zurückgeben */ }   case 3: { /* alle Priorities zurückgeben */ }   case 4: { /* Priorities mit ID zurückgeben */ }   } Mobile  App  Development

Content  Provider  implemen:eren

• Mit der Klasse ContentUris können IDs aus URIs geparst werden

• Dies wird verwendet, um Datensätze mit einer bestimmten ID zurückzugeben

public Cursor query(Uri uri, ...) {   int uriCode = matcher.match(uri);   switch (uriCode) {   case 2: { /* Todo mit ID zurückgeben */   long id = ContentUris.parseId(uri);   // Datensatz mit ID zurückgeben   }   } Mobile  App  Development

Content  Provider  implemen:eren

• Aus Übersichtlichkeitsgründen wurden in

den addUri()-Methoden und in den case Statements Integer Literale verwendet

• Normalerweise würde man für diese Integer Konstanten verwenden!!

Mobile  App  Development

Content  Provider  implemen:eren

• Im Folgenden wird die Implementierung

eines Content Providers für Todo Objekte erläutert

• Es wird davon ausgegangen, dass eine

Todo-Datenbank mit einer Tabelle Todo existiert

• Ein entsprechender DbHelper zum Zugriff auf die Datenbank wird vorausgesetzt

Mobile  App  Development

Content  Provider  implemen:eren

• Todo DbHelper public class DbHelper extends OrmLiteSqliteOpenHelper {   public static final String DATABASE_NAME = "todos.db";   public static final int DATABASE_VERSION = 1;  

 

// Spaltennamen   public static final public static final public static final public static final

 

String String String String

COL_ID = "_id";   COL_TITLE = "title";   COL_DESCR = "description";   COL_DUEDATE = "duedate";  

public DbHelper(Context context) {   super(context, DATABASE_NAME, null, DATABASE_VERSION);   }   // ...   }

Mobile  App  Development

Content  Provider  implemen:eren

• Implementierung public class TodoContentProvider extends ContentProvider {   public static final String SCHEME = "content://";   public static final String AUTHORITY = "de.htwds.mada.todo";   private static final UriMatcher sUriMatcher = new UriMatcher(   UriMatcher.NO_MATCH);   public Cursor query(Uri uri, String[] projection, String selection,   String[] selectionArgs, String sortOrder) {   }   public Uri insert(Uri uri, ContentValues values) {   }   public int update(Uri uri, ContentValues values, String selection,   String[] selectionArgs) {   }   public int delete(Uri uri, String selection, String[] selectionArgs) {   }   }

Mobile  App  Development

Content  Provider  implemen:eren

• Todo Contract Klasse • ImplemenNerung  als  innere  Klasse  im  Content   Provider   • Die  Contract  Klasse  enthält  eine  CONTENT_URI,  mit   der  die  Todo  Tabelle  referenziert  wird   • wird  von  BaseColumns  abgeleitet  und  hat  somit  die   Spalte  _ID  

Mobile  App  Development

Content  Provider  implemen:eren

• Todo Contract Klasse • Die  Contract  Klasse  enthält  Konstanten  für  die   verschiedenen  Spaltennamen   • Im  Todo  Beispiel  werden  die  CP  Todo  Spalten  1:1  auf   die  Datenbankspalten  abgebildet  (dies  muss  nicht   zwingend  der  Fall  sein!)

Mobile  App  Development

Content  Provider  implemen:eren

• Todo Contract Klasse public class TodoContentProvider extends ContentProvider {   public static final String SCHEME = "content://";   public static final String AUTHORITY = "de.htwds.mada.todo";   private static final UriMatcher sUriMatcher = new UriMatcher(   UriMatcher.NO_MATCH);   /* Contract Klasse für die Todo Tabelle */   public static final class Todos implements BaseColumns {   public static final String PATH = "todos";   // content://de.htwds.mada.todo/todos   public static final Uri CONTENT_URI =   Uri.parse(SCHEME + AUTHORITY + "/" + PATH);   // Todo Spalten   public static final String TITLE = DbHelper.COL_TITLE;   public static final String DESCRIPTION = DbHelper.COL_DESCR;   public static final String DUEDATE = DbHelper.COL_DUEDATE;   }   }

Mobile  App  Development

Content  Provider  implemen:eren

• URI Muster erstellen • Es  wird  ein  URI  Muster  erstellt,  das  alle  Todos   referenziert   • Ein  zweites  URI  Muster  dient  der  Referenzierung  eines   Todos  mit  einer  besNmmten  ID   • Beide  URIs  werden  mi3els  UriMatcher  eingetragen   und  auf  konstante  Integer  abgebildet

Mobile  App  Development

Content  Provider  implemen:eren public class TodoContentProvider extends ContentProvider {   public static final String SCHEME = "content://";   public static final String AUTHORITY = "de.htwds.mada.todo";   private static final UriMatcher sUriMatcher = new UriMatcher(   UriMatcher.NO_MATCH);   /* Contract Klasse für die Todo Tabelle */   public static final class Todos implements BaseColumns {   public static final String PATH = "todos";   // ...   }   private static final int TODOS = 100;   private static final int TODOS_ID = 101;   static {   // content://de.htwds.mada.todo/todos   sUriMatcher.addURI(AUTHORITY, Todos.PATH, TODOS);   // content://de.htwds.mada.todo/todos/#   sUriMatcher.addURI(AUTHORITY, Todos.PATH + "/#", TODOS_ID);   }   }

Mobile  App  Development

Content  Provider  implemen:eren

• query()-Methode implementieren • Die  query()-­‐Methode  bekommt  neben  dem  URI   verschiedene  Parameter,  die  schon  von  Datenbanken   bekannt  sind:  ProjekNon,  SelekNon  und  SorNerung   • Anhand  des  URI  wird  mit  dem  UriMatcher   entschieden,  was  zurückgegeben  wird

Mobile  App  Development

Content  Provider  implemen:eren

• query()-Methode implementieren public Cursor query(Uri uri, String[] projection, String selection,   String[] selectionArgs, String sortOrder) {   // gibt den Integer zurück, der für das URI Muster hinterlegt wurde   int uriCode = sUriMatcher.match(uri);   switch (uriCode) {   case TODOS: // alle Todos abfragen   return queryAllTodos(projection, selection,   selectionArgs, sortOrder);   case TODOS_ID: // bestimmtes Todo abfragen   long todoId = ContentUris.parseId(uri);   return queryTodo(todoId, projection, selection,   selectionArgs, sortOrder);   default:   return null;   }   }   }

Mobile  App  Development

Content  Provider  implemen:eren

• queryAllTodos()-Methode private Cursor queryAllTodos(String[] projection, String selection,   String[] selectionArgs, String sortOrder) {   Cursor cursor = null;   SQLiteDatabase db = null;   try {   // Da in der Contract Klasse alle Spalten 1:1 auf die DB Spalten   // abgebildet wurden, können Projektion, Selektion, uws. hier   // direkt in die DB Anfrage übernommen werden   db = mDbHelper.getReadableDatabase();   cursor = db.query(DbHelper.TABLE_NAME, projection, selection,   selectionArgs, null, null, sortOrder);   } catch (Exception ex) {   Log.e(LOG, "error querying database", ex);   }  

 

return cursor;   }

Mobile  App  Development

Content  Provider  implemen:eren

• queryTodo(id, ...)-Methode private Cursor queryTodo(long id, String[] projection, String selection,   String[] selectionArgs, String sortOrder) {   Cursor cursor = null;   SQLiteDatabase db = mDbHelper.getReadableDatabase();   try {   // Selektions String erstellen   String selString = DbHelper.COL_ID + "=" + id;   if (! selection.isEmpty()) {   selString += " AND " + selection;   }   // auch hier können Projektion usw. wieder direkt übernommen werden   cursor = db.query(DbHelper.TABLE_NAME, projection, selString,   selectionArgs, null, null, sortOrder);   } catch (Exception ex) {   Log.e(LOG, "error querying database", ex);   }   return cursor;   }

Mobile  App  Development

Content  Provider  implemen:eren

• insert()-Methode implementieren • Verwendung,  um  neue  Datensätze  einzufügen   • erhält  als  Parameter  den  Tabellen  URI  und  ein   ContentValues  Objekt   • gibt  den  URI  zum  eingefügten  Datensatz  mit   angehängter  ID  zurück

Mobile  App  Development

Content  Provider  implemen:eren

• insert()-Methode implementieren public Uri insert(Uri uri, ContentValues values) {  

 

// URI Muster auswerten   int uriCode = sUriMatcher.match(uri);   switch (uriCode) {   case TODOS: {   // Methode aufrufen, die das neue Todo in die Datenbank   // einfügt und die ID zurückgibt   long id = insertTodo(values);   // URI für neues Todo erstellen und zurückgeben   // content://de.htwds.mada/todos/   return ContentUris.appendId(uri.buildUpon(), id).build();   }   default: {   return null;   }   }   }

Mobile  App  Development

Content  Provider  implemen:eren

• update()-Methode implementieren • Verwendung,  um  Datensätze  zu  aktualisieren   • erhält  ein  ContentValues  Objekt  mit  den  zu   aktualisierenden  Daten  und  eine  SelekNon   • gibt  die  Anzahl  betroffener  Datensätze  zurück

Mobile  App  Development

Content  Provider  implemen:eren

• update()-Methode implementieren public int update(Uri uri, ContentValues values, String selection,   String[] selectionArgs) {  

 

// URI Muster auswerten   int uriCode = sUriMatcher.match(uri);   switch (uriCode) {   case TODOS: {   // mit updateTodo werden die Datensätze in der Datenbank   // aktualisiert   int affected = updateTodo(values, selection, selectionArgs); // Anzahl betroffener Datensätze zurückgeben   return affected;   }   default: {   return 0;   }   }   }

Mobile  App  Development

 

Content  Provider  implemen:eren

• delete()-Methode implementieren • Verwendung,  um  Datensätze  zu  löschen   • erhält  eine  SelekNon  für  die  zu  löschenden  Datensätze   • gibt  die  Anzahl  gelöschter  Datensätze  zurück

Mobile  App  Development

Content  Provider  implemen:eren

• delete()-Methode implementieren public int delete(Uri uri, String selection, String[] selectionArgs) {   // URI Muster auswerten   int uriCode = sUriMatcher.match(uri);   switch (uriCode) {   case TODOS: {   // deleteTodo löscht die Datensätz in der Datenbank   int affected = deleteTodo(selection, selectionArgs);   // Anzahl betroffener Datensätze zurückgeben   return affected;   }   default: {   return 0;   }   }   }

Mobile  App  Development

Content  Provider  implemen:eren

• getType()-Methode implementieren • wird  vom  Client  verwendet,  um  abzufragen,  welcher   MIME  Type  sich  hinter  einem  besNmmten  URI  verbirgt   • URIs  die  auf  Tabellen  zeigen   • vnd.android.cursor.dir/vnd.de.htwds.mada.provider.todo

• URIs  die  auf  einzelne  Zeilen  zeigen   • vnd.android.cursor.item/vnd.de.htwds.mada.provider.todo

Mobile  App  Development

Content  Provider  implemen:eren

• getType()-Methode implementieren public class TodoContentProvider extends ContentProvider { /* Contract Klasse für die Todo Tabelle */ public static final class Todos implements BaseColumns { // ... // Erweiterung der Contract Klasse um MIME Type Konstanten public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.de.htwds.mada.todo"; public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.de.htwds.mada.todo"; } public String getType(Uri uri) { // URI Muster auswerten int uriCode = sUriMatcher.match(uri); // entsprechend dem URI MIME type zurückgeben switch (uriCode) { case TODOS: return Todos.CONTENT_TYPE; case TODOS_ID: return Todos.CONTENT_ITEM_TYPE; default: return null; } } }

Mobile  App  Development

Content  Provider  implemen:eren

• Wie kann ein Provider mehrere Tabellen zur Verfügung stellen?

Mobile  App  Development

Content  Provider  implemen:eren

• Wie kann ein Provider mehrere Tabellen zur Verfügung stellen?

• Für  jede  Tabelle  wird  ein  Contract  Klasse  mit  den   entsprechenden  Spaltennamen  angelegt   • Es  wird  für  jede  Tabelle  ein  eigener  URI  bereitgestellt   • Für  die  URIs  werden  Einträge  im  UriMatcher  erstellt,   um  in  den  Methoden  query(),  insert(),  ...  die  passende   OperaNon  auswählen  zu  können Mobile  App  Development

Content  Provider  implemen:eren

• Hinweis • Es  muss  kein  1:1  Mapping  von  CP  Spalten  auf   Datenbankspalten  vorliegen   • Ein  Content  Provider  kann  z.  B.  auch  Daten  aus   verschiedenen  Datenbanktabellen  zusammenfassen   und  als  neue  Tabelle  anbieten

Mobile  App  Development

Übung

Mobile  App  Development

Übung Übung  07  -­‐  Todo Die Todo App aus Übung 06 soll um einen Content Provider erweitert werden. Der Content Provider soll die Tabelle Todo und Priority zur Verfügung stellen. Wie in der Vorlesung dargestellt, soll für beide Tabellen eine Contract Klasse erstellt werden, die die Namen der Tabellenspalten als Konstanten enthält. Für die Spaltennamen der Contract Klassen werden folgende Vorgaben gemacht: Todo: _id, title, description, datetime, priority_id Priority: _id, name Weiterhin soll die Todo Tabelle unter dem URI content://de.htwds.mada.todo/todos und die Priority Tabelle unter dem URI content://de.htwds.mada.todo/priorities erreichbar sein. Außerdem sollen die Todos und Priorities unter Angabe einer ID im URI einzeln abrufbar sein. Hinweis: Es ist wichtig, dass die Benennung der Spaltennamen und URIs, wie oben angegeben, eingehalten wird, da die App mit einer weiteren App in der Übungsabnahme getestet werden könnte.

Mobile  App  Development