Mobile App Development. - Persistenz -

Transkript

1 Mobile App Development - Persistenz -

2 Inhalt Shared Preferences Dateien Datenbanken ORM 2

3 Shared Preferences

4 Shared Preferences Framework zum Speichern von Key-Value- Paaren Datentypen: boolean, float, int, long, String Daten werden in einer Datei gespeichert Nach Deinstallation der App werden Preferences-Dateien mit gelöscht 4

5 Shared Preferences // DemoActivity für SharedPreferences public class SharedPrefsDemoActivity extends Activity {"! " public static final String PREFS_FILE = "prefsfile";" " public static final String MY_KEY = "mykey";" " " " private int mmymember;" " " " protected void oncreate(bundle savedinstancestate) {" " " super.oncreate(savedinstancestate); " " // Aufrufen der SharedPreferences" " " SharedPreferences prefs = getsharedpreferences(prefs_file, MODE_PRIVATE);" " " // Abruf des Wertes für MY_KEY (default: 0)" " " mmymember = prefs.getint(my_key, 0);" " }" " " protected void onstop() {" " super.onstop();" " // Aufruf der SharedPreferences" " SharedPreferences prefs = getsharedpreferences(prefs_file, MODE_PRIVATE);" " // Editor aufrufen, um Änderungen zu machen" " Editor editprefs = prefs.edit();" " // Key-Value-Paar anlegen/aktualisieren" " editprefs.putint(my_key, mmymember);" " // Änderungen schreiben" " editprefs.commit();" " }" } 5

6 Dateien

7 Dateien Zwei mögliche Plätze zum Speichern von Dateien: Internal Storage geräteinterner Speicher External Storage externer Speicher, wie SD-Karten 7

8 Interner Speicher Standardmäßig sind Dateien, die auf dem internen Speicher abgelegt werden privat, d.h. andere Anwendungen können nicht darauf zugreifen Wird die Anwendung deinstalliert, werden auch die internen Dateien gelöscht 8

9 Interner Speicher Lesen von Dateien Context.openFileInput(...) liefert einen FileInputStream Die weitere Verarbeitung erfolgt wie bei Standard Datei- und Stream-Verarbeitung in Java 9

10 Interner Speicher Datei lesen private void readfile(string filename) throws Exception {" " /* openfileinput() öffnet die Datei mit dem angegebenen Namen" " * und liefert eine FIS zurück */" " FileInputStream fis = openfileinput(filename);" " BufferedReader reader = new BufferedReader(" new InputStreamReader(fis));" " String line = "";" " /* Auslesen der Datei */" " while ( (line = reader.readline())!= null) {" " " /* zeilenweise Verarbeitung */" " " Log.d(LOG, line);" " }" " /* reader und stream schließen */" } 10

11 Interner Speicher Dateien schreiben Context.openFileOutput(...) liefert einen FileOutputStream existiert die Datei noch nicht, wird sie automatische angelegt das Schreiben der Datei funktioniert wie auch bei Standard Java 11

12 Interner Speicher Dateien schreiben private void writefile(string filename, String content) " throws Exception {" " /* openfileoutput öffnet einen FOS, der mit der angegebenen " " Datei verbunden ist und legt die Datei an, wenn sie noch " " nicht existiert */" " FileOutputStream fos = openfileoutput(filename, MODE_PRIVATE);" " OutputStreamWriter osw = new OutputStreamWriter(fos);" " /* Inhalt in die Datei schreiben */" " osw.write(content);" " " " /* writer und stream schließen */" " osw.close();" } 12

13 Interner Speicher Android unterschiedet verschiedene Modi zum Anlegen einer Datei MODE_PRIVATE" Datei ist privat, kann also nur von der erstellenden App gelesen werden wenn Datei bereits vorhanden, wird sie überschrieben 13

14 Interner Speicher MODE_APPEND" Wenn Datei bereits vorhanden, wird neuer Inhalt angehängt MODE_WORLD_READABLE" Alle anderen Apps haben lesenden Zugriff 14

15 Interner Speicher MODE_WORLD_WRITEABLE" Alle anderen Apps haben schreibenden Zugriff auf die Datei 15

16 Interner Speicher Es gibt einige weitere nützliche Methoden, um mit Dateien und Verzeichnisse zu arbeiten" Context.getFilesDir() Absoluter Pfad zum dem Verzeichnis, in dem interne Dateien abgelegt werden Context.getDir(name, mode) Erzeugt oder öffnet ein Verzeichnis 16

17 Interner Speicher Weitere Methoden" Context.deleteFile(name) Entfernt die angegebene Datei Context.fileList() Listet alle mit der App assoziierten (internen) Dateien auf 17

18 Interner Speicher Weitere Methoden" Context.getCacheDir() Gibt den Pfad zum Verzeichnis für Cache- Dateien zurück File.createTempFile(prefix, suffix) Erzeugt eine temporäre Datei im temp- Verzeichnis 18

19 Externer Speicher Im Gegensatz zum internen Speicher gibt es bei externem Besonderheiten zu beachten: Daten können von jedermann gelesen werden Speicher muss nicht immer verfügbar sein (SD-Karte kann entfernt werden) 19

20 Externer Speicher Verfügbarkeit des ext. Speichers prüfen private boolean mextstoragereadable = false;" " private boolean mextstoragewritable = false; "..." " // Überprüft, ob der externe Speicher gelesen und geschrieben werden kann " private void checkavailability() {" " " // Status des externen Speichers abrufen" " " String state = Environment.getExternalStorageState();" " " if (Environment.MEDIA_MOUNTED.equals(state)) {" // Speicher kann gelesen und geschrieben werden" mextstoragereadable = true;" mextstoragewritable = true;" " " } else if (Environment.MEDIA_MOUNTED_READ_ONLY.equals(state)) {" // Speicher kann nur gelesen werden" mextstoragereadable = true;" mextstoragewritable = false;" " " } else {" // Speicher ist z.b. entfernt oder hat kein unterstütztes Dateisystem" mextstoragereadable = false;" mextstoragewritable = false;" " " }" " } 20

21 Externer Speicher Unterscheidung zwischen App-eigenen Daten und geteilten Daten App-eigene Daten sind nur für die eigene App relevant und werden bei Deinstallation mit gelöscht Geteilte Daten können auch von anderen Apps interpretiert werden (Musik, Bilder, etc.) 21

22 Externer Speicher Zugriff auf App-eigene Daten // Methode, um auf externen Speicher zuzugreifen private void accessfiles() {" " " // Verfügbarkeit des ext. Speichers prüfen" " " checkavailability();"! " "..." " " // bis API Level 7 (Eclair)" " " File extstore = Environment.getExternalStorageDirectory();" " " File extappdir7 = new File(extStore, " "Android" + File.separator + " "data" + File.separator + getpackagename() + File.separator + "files");" " " extappdir7.mkdirs();" " " // ab API Level 8 (Froyo)" " " File extappdir8 = getexternalfilesdir(null);" " " " " //..." " " // Standard Java Dateiarbeit, wie gehabt " " //..." " } 22

23 Externer Speicher Geteilte Daten sollten in öffentlichen Verzeichnissen abgelegt werden Bsp.: /Music, /Podcasts, /Alarms, /Download, etc. 23

24 Externer Speicher auf geteilte Daten zugreifen private void accesspublicfiles() {" " " // Verfügbarkeit des ext. Speichers prüfen" " " checkavailability(); " " " "..." " " // öffentliches Verzeichnis für Musik" " " File musicdir = null;" " " // bis API Level 7" " " File extdir = Environment.getExternalStorageDirectory();" " " musicdir = new File(extDir, "Music");" " " // ab API Level 8" " " musicdir = Environment".getExternalStoragePublicDirectory(Environment.DIRECTORY_MUSIC);" " " // Danach, wie gewohnt" " " File musicfile = new File(musicDir, "mymusic.mp3");" " " musicfile.createnewfile();" " } 24

25 Externer Speicher Temporäre Dateien auf den externen Speicher schreiben private void cachefiles() {" " " // Verfügbarkeit des ext. Speichers prüfen" " " checkavailability();" " " //..." " " " " File cachedir = null;" " " // bis API Level 7" " " File extdir = Environment.getExternalStorageDirectory();" " " cachedir = new File(extDir, "/Android/data/" + getpackagename() + "/cache/");" " " // ab API Level 8" " " cachedir = getexternalcachedir();" " " // Erstellen der temporären Datei" " " File cachefile = File.createTempFile("myPrefix", "mysuffix", cachedir);" " } 25

26 Datenbanken

27 SQLite SQLite ist die Standard Datenbank-Engine, die in Android verwendet wird optimiert für Embedded Systems zeichnet sich aus durch Abgeschlossenheit, Serverlosigkeit Minimal- bis 0-Konfiguration unterstützt Standard SQL 27

28 SQLite Daten werden in SQLite durch sogenannte Storage Classes repräsentiert Jedem Wert wird ein Datentyp zugeordnet 28

29 Storage Classes Datentyp Beschreibung NULL INTEGER REAL TEXT BLOB Null-Wert vorzeichenbehaftete Ganzzahl (1-8 Byte) Dezimalzahl (8 Byte) String Binärdaten 29

30 Storage Classes Datentyp Konvertierung Darstellung Boolean INTEGER 0 = false, 1 = true Date/ Time TEXT REAL INTEGER ISO8601: YY-MM-DD HH:MM.SS.SSS Zeit in Tagen seit v.chr. 12:00 UNIX-Zeit, Sekunden seit :00:00 UTC 30

31 Datentypen Alle Standard SQL-Datentypen können verwendet werden Integer, Numeric, Decimal, Float, Real, Double Varchar, Char Date, Time, Timestamp Boolean Blob, Clob 31

32 Operatoren " * / %" + -" << >> & " < <= > >=" = ==!= <> IS IS NOT IN LIKE GLOB" AND " OR siehe: 32

33 DatenbankfunkConen Kernfunktionen abs, hex, min, max, random, round,... substr, trim, replace, upper, lower,... siehe: lang_corefunc.html 33

34 DatenbankfunkConen Aggregatfunktionen min, max, avg, count, sum weitere: lang_aggfunc.html Datum & Zeit date, time, datetime, strftime 34

35 SQLiteOpenHelper abstrakte Oberklasse für DB-Zugriffe empfohlene Schnittstelle zum Erstellen, Öffnen und Aktualisieren von Datenbanken 35

36 SQLiteOpenHelper Wenn von SQLiteOpenHelper abgeleitet wird, müssen folgende Methode überschrieben werden Konstruktor: Hier wird dem super Konstruktor der Context, Datenbankname und -version mitgegeben oncreate(): wird aufgerufen, wenn die Datenbank erstellt wird. Hier werden SQL Statements ausgeführt, um die Tabellen zu erstellen. 36

37 SQLiteOpenHelper onupgrade(): wird aufgerufen, wenn eine Datenbankversion gefunden wurde, die älter ist, als die aktuelle. Hier werden alte Datenbanktabellen angepasst. ondowngrade(): ist das Pendant zu der Methdode onupgrade() (ab API 11) 37

38 SQLiteOpenHelper Beispiel: Erstellung einer Datenbank, mit der TODOs gespeichert werden können Datenmodell: todo date title description Integer Text Text 38

39 DatabaseHelper // Hilfsklasse zum Erstellen, Aktualisieren und Öffnen der Datenbank public class DatabaseHelper extends SQLiteOpenHelper {"! " public static final String DATABASE_NAME = "todo.db"; " // Datenbankname" " private static final int DATABASE_VERSION = 1;"" " // Datenbankversion" " " " public static final String TABLE_NAME = "todo";" " public static final String DATE_FIELD_NAME = "date";" " public static final String DATE_FIELD_TYPE = "INTEGER";" " public static final String TITLE_FIELD_NAME = "title";" " public static final String TITLE_FIELD_TYPE = "TEXT";" " public static final String DESCR_FIELD_NAME = "description";" " public static final String DESCR_FIELD_TYPE = "TEXT";" " " " // SQL statement zum Erstellen der Tabelle" " private static final String TABLE_CREATE = " "CREATE TABLE " + TABLE_NAME + "(" " " + DATE_FIELD_NAME + " " + DATE_FIELD_TYPE + ", "" " + TITLE_FIELD_NAME + " " + TITLE_FIELD_TYPE + ", "" " + DESCR_FIELD_NAME + " " + DESCR_FIELD_TYPE + ")";" " " " // Konstruktor" " public DatabaseHelper(Context context) {" " " super(context, // der Context DATABASE_NAME, " " // Datenbankname null, " // CursorFactory DATABASE_VERSION);" // Datenbankversion" " }" " " " //..." Mobile App Development 39

40 DatabaseHelper // Hilfsklasse zum Erstellen, Aktualisieren und Öffnen der Datenbank public class DatabaseHelper extends SQLiteOpenHelper { " // Wird aufgerufen, wenn die DB das erste mal erstellt wird" " public void oncreate(sqlitedatabase db) {" " " try {" db.execsql(table_create);" " " } catch (SQLException ex) {" Log.e("DatabaseHelper", "error creating tables", ex);" " " }" " }"! " public void onupgrade(sqlitedatabase db, int oldver, int newver) {" " " // alte Tabellen auslesen und löschen, neue Tabellen anlegen" " " // alten Inhalt in neue Tabellen einfügen" " }" " " // ab API-Level 11" " public void ondowngrade(sqlitedatabase db, int oldver, int newver) {" " " // alte Tabellen auslesen und löschen, neue Tabellen anlegen" " " // alten Inhalt in neue Tabellen einfügen" " }" } 40

41 Daten abfragen Mit der Methode getreadabledatabase() wird aus dem SQLiteOpenHelper eine lesbare Datenbankinstanz erzeugt Mit der query()-methode der DB Instanz können Daten gelesen werden Die query() Methode besitzt einige Parameter, die einer SQL-Abfrage entsprechen 41

42 Daten abfragen query()-parameter table: der Tabellenname columns: String Array, das die abzufragenden Spaltennamen enthält oder null für alle Spalten selection: entspricht der WHERE-Klausel eines SQL-Statements ohne das WHERE Schlüsselwort 42

43 Daten abfragen query()-parameter selectionargs: dient der Parametrisierung der selection groupby: dient der Gruppierung von Zeilen in Verbindung mit Aggregatfunktionen having: Filter für Gruppierungen 43

44 Daten abfragen query()-parameter orderby: dient der Sortierung des Ergebnisses nach einer Spalte limit: begrenzt die Anzahl der Ergebnisse 44

45 Daten abfragen // Methode zum abfragen von Daten aus der DB" private void doselect() {" " // Datenbank zum Lesen öffnen " " SQLiteDatabase db = new DatabaseHelper(this).getReadableDatabase();" " // query(string table, String[] columns, String selection, String[] " " // selectionargs, String groupby, String having, String orderby, " // String limit)" " Cursor result = db.query(" DatabaseHelper.TABLE_NAME, null, null, null, null, null, " DatabaseHelper.DATE_FIELD_NAME, null);" " // Ergebnis verarbeiten" " // Datenbank schließen" " db.close();" } Mobile App Development 45

46 Daten abfragen Die query() Methode der Datenbank- Instanz liefert einen Cursor zurück Cursor repräsentieren das Ergebnis der Datenbankabfrage Ein Cursor besitzt einen Zeiger, mit dem man datensatzweise über das ResultSet navigieren kann 46

47 Daten abfragen Nützliche Cursor Methoden getcount(): gibt die Anzahl der Datensätze im Cursor an moveto[first, Next, Last](): bewegt den Datensatzzeiger im Cursor getposition(): gibt die aktuelle Zeigerposition im Cursor zurück 47

48 Daten abfragen Nützliche Cursor Methoden getcolumnindex(): gibt den Index zum übergebenen Spaltennamen zurück get[long,string,int,short,...](): gibt den Wert im Datensatz für den angegebenen Spaltenindex zurück 48

49 Daten abfragen // Methode zum abfragen von Daten aus der DB" private void doselect() {" " // Datenbank zum Lesen öffnen und query ausführen" " Cursor result = db.query(...);" " if (result.movetofirst()) { // wenn Cursor nicht leer" " " // Spaltenindex vom Datums- und Titel-Feld abrufen" " " int dateidx = result.getcolumnindex(databasehelper.date_field_name);" " " int titleidx = result.getcolumnindex(databasehelper.title_field_name);" " " do { " // Datum und Titel auslesen" long date = result.getlong(dateidx);" String title = result.getstring(titleidx);" //... und verarbeiten" Log.d(LOG_TAG, new Date(date) + " " + title);" " " } while (result.movetonext()); // solange Datensätze vorhanden" " }"! " // Cursor direkt wieder schließen, um Ressourcen freizugeben " " result.close();" " // Datenbank schließen" " db.close();" } Mobile App Development 49

50 Daten abfragen Zur Abfrage von Daten können auch Standard SQL Statements verwendet werden Optional können diese parametrisiert werden 50

51 Daten abfragen public void dorawselect() {" " // Datenbank zum Lesen öffnen " " SQLiteDatabase db = new DatabaseHelper(this).getReadableDatabase();" " // SQL Statement erstellen" " String sql = "SELECT * FROM " + DatabaseHelper.TABLE_NAME + " " ORDER BY " + DatabaseHelper.DATE_FIELD_NAME;" " // query ausführen" " Cursor result = db.rawquery(sql, null);" " if (result.movetofirst()) { // wenn Cursor nicht leer" " " // Spaltenindex vom Datums- und Titel-Feld abrufen" " " int dateidx = result.getcolumnindex(databasehelper.date_field_name);" " " int titleidx = result.getcolumnindex(databasehelper.title_field_name);" " " do { // für jeden Datensatz" // Datum und Titel auslesen" long date = result.getlong(dateidx);" String title = result.getstring(titleidx);" //... und verarbeiten" Log.d(LOG_TAG, new Date(date) + " " + title);" " " } while (result.movetonext()); // solange Datensätze vorhanden" " }" result.close();" // Cursor schließen" " db.close(); // Datenbank schließen" } 51

52 Daten einfügen Um Datensätze in die Datenbank einzufügen werden ContentValues Objekte verwendet Ein ContentValues Objekt repräsentiert einen Datensatz in einer Tabelle Ein CotentValues Objekt besitzt put() Methoden, die einen Schlüssel und einen Wert erhalten 52

53 Daten einfügen Schlüssel ist der Spaltenname aus der Datenbank und dazu der zu setzende Wert ContentValues Objekte werden unter Angabe der Tabelle per insert() Methode in die Datenbank eingefügt 53

54 Daten einfügen " // Methode zum Einfügen von Daten in die DB" " private void doinsert() {" " " // Datenbank zum Schreiben öffnen" " " SQLiteDatabase db = mdbhelper.getwritabledatabase();" " " // Datensatz erstellen" " " ContentValues vals = new ContentValues();" " " vals.put(databasehelper.date_field_name, System.currentTimeMillis());" " " vals.put(databasehelper.title_field_name, "meintitel");" " " vals.put(databasehelper.descr_field_name, "meinebeschreibung");" " " // Datensatz in die Datenbank einfügen" " " db.insert(databasehelper.table_name, null, vals);" " " // Datenbank schließen" " " db.close();" " } 54

55 Daten aktualisieren Die Aktualisierung von Datensätzen funktioniert ähnlich wie das Einfügen Es wird ein ContentValues Objekt mit den neuen Daten erzeugt und per update() Methode abgeschickt 55

56 Daten aktualisieren " // Mehtode zum Aktualisieren von Datensätzen" " private void doupdate() {" " " // Datenbank zum Schreiben öffnen" " " SQLiteDatabase db = mdbhelper.getwritabledatabase();" " " // ContentValues Objekt mit den neuen Daten erzeugen" " " ContentValues values = new ContentValues();" " " values.put(databasehelper.date_field_name, " new java.util.date().gettime());" " " // Datensätze unter Angabe des Tabellennamens und einer " " " // WHERE Bedingung aktualisieren"!! int rows = db.update(databasehelper.table_name, values, " " DatabaseHelper.DATE_FIELD_NAME + " LIKE 'b%'", null);" " " Log.d(LOG_TAG, "affected rows: " + rows);" " " " " // Datenbank schließen" " " db.close();" " } 56

57 Daten löschen Datensätze werden gelöscht, indem eine WHERE Bedingung angegeben wird, die auf die zu löschende Datensätze zutrifft 57

58 Daten löschen " // Methode zum Löschen von Datensätzen" " private void dodelete() {" " " // Datenbank zum Schreiben öffnen" " " SQLiteDatabase db = mdbhelper.getwritabledatabase();" " " // Datensätze unter Angabe einer WHERE Bedingung löschen" " " int rows = db.delete(databasehelper.table_name, " " DatabaseHelper.DATE_FIELD_NAME + " < date('now')", null);" " " // Anzahl gelöschter Datensätze löschen" " " Log.d(LOG_TAG, rows + " rows deleted");" " " // Datenbank schließen" " " db.close();" " } 58

59 Raw Queries Einfügen, Aktualisieren und Löschen private void dorawinsertupdatedelete() {" " // Datenbank zum Schreiben öffnen" " SQLiteDatabase db = new DatabaseHelper(this).getWritableDatabase();" " " " // insert statement erstellen & abschicken" " String insertsql = "INSERT INTO " + DatabaseHelper.TABLE_NAME + " VALUES("" " " + System.currentTimeMillis() + ", 'mein Titel', 'meinebeschreibung')";" " db.execsql(insertsql);" " // update statement erstellen & abschicken" " String updatesql = "UPDATE " + DatabaseHelper.TABLE_NAME + " SET " " " " + DatabaseHelper.TITLE_FIELD_NAME + "=neuertitel WHERE " " " " + DatabaseHelper.DATE_FIELD_NAME + "<" + System.currentTimeMillis();" " db.execsql(updatesql);" " // delete statement erstellen & abschicken" " String deletesql = "DELETE FROM " + DatabaseHelper.TABLE_NAME + " WHERE "" " " + DatabaseHelper.TITLE_FIELD_NAME + " LIKE 'n%'";" " db.execsql(deletesql);" " db.close(); // Datenbank schließen" } 59

60 TransakConen Standardmäßig wird jedes SQL-Statement in einer eigenen Transaktion ausgeführt Gründe, um einen eigenen Transaktionsrahmen zu setzen: succeed or fail as a whole Performance 60

61 TransakConen Transaktionen werden mit begintransaction() gestartet... und mit endtransaction() beendet Um die Transaktion als erfolgreich zu markieren, muss vor dem Aufruf von endtransaction() die Methode settransactionsuccessful() aufgerufen werden 61

62 TransakConen Transaktionen ausführen private void dotransaction() {" " // Datenbank zum Schreiben öffnen" " SQLiteDatabase db = new DatabaseHelper(this).getWritableDatabase();" " " " try {" " " // Transaktion starten" " " db.begintransaction();" " " /* auf der Datenbank arbeiten */" " " // Transaktion als erfolgreich markieren" " " db.settransactionsuccessful();" " } catch (Exception ex) {" " " // Fehler behandeln" " } finally {" " " // Transaktion beenden" " " db.endtransaction();" " }" } 62

63 CursorAdapter

64 CursorAdapter Die Ergebnisse von Datenbankabfragen können über einen Adapter direkt in AdapterViews (ListView, SpinnerView) dargestellt werden Hierfür werden CursorAdapter verwendet, die den AdapterViews ebenso wie ArrayAdapter ihre Daten zur Verfügung stellen 64

65 CursorAdapter Exkurs: Eigene List Layouts Einträge in einer Liste, also die Darstellung der einzelnen Einträge, können mit einem eigenen Layout versehen werden Layout-Dateien werden genauso erstellt, wie bei Activity-Layouts 65

66 CursorAdapter Exkurs: Eigene List Layouts <?xml version="1.0" encoding="utf-8"?>" <LinearLayout xmlns:android="..."" android:layout_width="match_parent"" android:layout_height="match_parent"" android:orientation="horizontal" >"! <TextView" android:layout_width="match_parent"" android:layout_height="wrap_content"" android:layout_weight="1"/>"! <TextView" android:layout_width="wrap_content"" android:layout_height="wrap_content"/>"! </LinearLayout> 66

67 CursorAdapter Exkurs: Eigene List Layouts Layout verwenden private void usecustomlistlayout() {" " // ListView Referenz abrufen" " ListView listview = " " " (ListView) findviewbyid(r.id.listview1);" " // Adapter bekommt die Layout Referenz " " // zum angepassten Layout" " ArrayAdapter<String> listadapter = " " " new ArrayAdapter<String>(" this, R.layout.list_item);" " //... wie gehabt" } 67

68 CursorAdapter CursorAdapter stellen eine Brücke zwischen AdapterViews und Cursor Objekten her Im CursorAdapter wird angegeben, welche Spalte auf welches Element im ListItem Layout abgebildet wird Das Auslesen des Cursors und Setzen der ListItems wird vom Adapter übernommen 68

69 CursorAdapter private void setlistcursoradapter() {"! " // Datenbank öffnen und Abfrage ausführen" " SQLiteDatabase db = new DbHelper(this).getReadableDatabase();" " String sql = "select _id, title, date from todo";" " Cursor cursor = db.rawquery(sql, null);" " // gibt an, welche Spalten in der ListView dargestellt werden sollen" " String[] from = new String[] {"title", "date"};" " // gibt an, welche Spalte in welcher View dargestellt werden soll" " int[] to = new int[]{r.id.title, R.id.date};"! " // CursorAdapter erstellen" " SimpleCursorAdapter sca = new SimpleCursorAdapter(this," " " R.layout.list_item, cursor, from, to, 0);" " // Adapter sezten" " ListView lv = (ListView) findviewbyid(r.id.listview1);" " lv.setadapter(sca);"" } 69

70 CursorAdapter Hinweis: Um einen SimpleCursorAdapter zu nutzen, muss die verwendete Tabelle eine Spalte _id besitzen! 70

71 Objekt- relaconales Mapping

72 ORM Problemstellung Objekt-Modell und Relationales Modell unterscheiden sich Objekte müssen immer wieder in Tabellen-Datensätze konvertiert werden und umgekehrt 72

73 ORM Problemstellung Hohe Fehleranfälligkeit durch Verwendung von Plain SQL (Typo s) große Menge an SQL Statements muss programmiert werden 73

74 ORM Beispiel zwei Tabellen mit einfacher 1:n- Verknüpfung todo todo_group date title description Integer Text Text 1 id name Integer Text fk_todo_lis t Integer n 74

75 ORM Beispiel public class TodoDbHelper extends SQLiteOpenHelper {" " " " public static final String LOG_TAG = TodoDbHelper.class.getName();"! " public static final String DATABASE_NAME = "groupedtodo.db";" " private static final int DATABASE_VERSION = 1;"! // table creation attributes" " public static final String TODO_TABLE_NAME = "todo";" " " public static final String TODO_ID_FIELD_NAME = "_id";" " public static final String TODO_ID_FIELD_TYPE = "INTEGER PRIMARY KEY AUTOINCREMENT";" " public static final String TODO_DATE_FIELD_NAME = "date";" " public static final String TODO_DATE_FIELD_TYPE = "INTEGER";" " public static final String TODO_TITLE_FIELD_NAME = "title";" " public static final String TODO_TITLE_FIELD_TYPE = "TEXT";" " public static final String TODO_PARENT_FIELD_NAME = "parent";" " public static final String TODO_PARENT_FIELD_TYPE = "INTEGER";" " public static final String TODO_PARENT_FOREIGN_KEY = CONSTRAINT fk_parent FOREIGN KEY (parent) REFERENCES todogroup(_id)";" " " " public static final String TODO_GROUP_TABLE_NAME = "todo_group";" " public static final String TODO_GROUP_ID_FIELD_NAME = "_id";" " public static final String TODO_GROUP_ID_FIELD_TYPE = "INTEGER PRIMARY KEY AUTOINCREMENT";" " public static final String TODO_GROUP_NAME_FIELD_NAME = "name";" " public static final String TODO_GROUP_NAME_FIELD_TYPE = "TEXT";" " " " //..." } 75

76 ORM Beispiel public class TodoDbHelper extends SQLiteOpenHelper {" " " " //..." " " " // SQL statement for table creation" " private static final String TODO_TABLE_CREATE = " "CREATE TABLE " + TODO_TABLE_NAME + "(" " " + TODO_ID_FIELD_NAME + " " + TODO_ID_FIELD_TYPE + ", "" " + TODO_DATE_FIELD_NAME + " " + TODO_DATE_FIELD_TYPE + ", "" " + TODO_TITLE_FIELD_NAME + " " + TODO_TITLE_FIELD_TYPE + ", " " " + TODO_PARENT_FIELD_NAME + " " + TODO_PARENT_FIELD_TYPE + ", "" " + TODO_PARENT_FOREIGN_KEY + ")";"! // SQL statement for TodoList table creation" " private static final String TODO_GROUP_TABLE_CREATE = " String.format("CREATE TABLE %s (%s %s, %s %s)", TODO_GROUP_TABLE_NAME, " " " TODO_GROUP_ID_FIELD_NAME, TODO_GROUP_ID_FIELD_TYPE," " " TODO_GROUP_NAME_FIELD_NAME, TODO_GROUP_NAME_FIELD_TYPE);" }" 76

77 ORM Lösung Objekt-relationales Mapping (ORM) ermöglicht die Abbildung von Objekten auf Tabellen Abstraktion der Datenbankzugriffe durch Methoden zum Erstellen, Löschen,... Foreign-Key Beziehungen zwischen Datensätzen werden in Objektreferenzen umgewandelt 77

78 ORM Lösung Es muss kein SQL mehr geschrieben werden (kann aber) Es gibt viele verschiede ORM Frameworks (OrmLite, greendao,...) Hier in der Vorlesung wird OrmLite exemplarisch für Android vorgestellt 78

79 ORM OrmLite ( Sehr einfaches OrmFramework schnelle Einarbeitungszeit Es muss nur eine jar-datei eingebunden werden Entities (Objekte) werden mit Annotations versehen 79

80 ORM Todo public class Todo {"! " private int id;" " private long date;" " " private String title; " " private String description;" " private TodoList parent;" " " " public Todo() {" " }"! // setter & getter" public class TodoList {"! " private int id;" " private String name;" " private Collection<Todo> todos;" " " " public TodoList() {" " }"! " // setter & getter" }"!!! 80

81 ORM OrmDbHelper public class OrmDbHelper extends OrmLiteSqliteOpenHelper {"! " public static final String LOG = OrmDbHelper.class.getName();" " public static final String DB_NAME = "todo.db";" " public static final int DB_VERSION = 1;" " " " public OrmDbHelper(Context context) {" " " super(context, DB_NAME, null, DB_VERSION);" " }" " " " public void oncreate(sqlitedatabase db, ConnectionSource source) {" // Registrierung der Klassen beim ORM Framework" " " try {" TableUtils.createTable(source, Todo.class);" TableUtils.createTable(source, TodoList.class);" " " } catch (SQLException ex) {" Log.e(LOG, "error creating tables", ex);" " " }" " }" } 81

82 ORM Data Access Objects Der Zugriff auf die Entitäten, da heißt Suchen, Einfügen, Aktualisieren und Löschen, wird über sog. DAOs realisiert Die DAOs kapseln die eigentlichen Datenbankzugriffe (SELECT, INSERT,...) Für jede Entität wird ein eigenes DAO erstellt 82

83 ORM Data Access Object erstellen public class OrmDbHelper extends OrmLiteSqliteOpenHelper {"!! //... oncreate()..." // Erzeugung des Data Access Objects" " public Dao<Todo, Integer> createtododao() {" " " try {" return DaoManager.createDao(connectionSource, Todo.class);" " " } catch (SQLException ex) {" Log.e(LOG, "error creating DAO for Todo class", ex);" " " }" " " return null;" " }"! } 83

84 ORM Daten suchen und manipulieren!!!!! private void handletodos() throws SQLException {" }" // Data Access Object für Todo erstellen " final Dao<Todo, Integer> tododao = dbhelper.createtododao();" // query all todos from db" final List<Todo> alltodos = tododao.queryforall();" // create new todo" Todo todo = new Todo(new Date(), "Test title", "Test description");" tododao.create(todo);" // delete todo element with id=5" tododao.deletebyid(5);" // update todo element" tododao.update(todo);" 84

85 Literatur I. Mark L. Murphy: The Busy Coder s Guide To Android Development, Version 4.3, 2012 II. Thomas Künneth: Android 3 - Apps entwickeln mit dem Android SDK Galileo Press, 2011 III. data/data-storage.html 85