[GUIDA] Gestione Database SQL con ActiveAndroid

[cesco]

ciao a tutti

Spesso implementare un Database SQL è laborioso, soprattutto se si ha la necessità di più tabelle all'interno del DB.
La libreria ActiveAndroid ci viene in aiuto semplificando di molto l'implementazione. Fondamentalmente si tratta di una libreria "annotation based", dovremo solo creare delle classi specifiche e alcuni metodi "helper" per la manipolazione del DB. l'implementazione mediamente non richiede più di una decina di minuti

Informazioni Base su ActiveAndroid:

• Per Ogni classe java creata che estende la classe Model, la libreria creerà una tabella all'interno del DB per gli elementi (classe MyDbRow estende Model ==> Tabella MyDbRow nel DB che conterrà tutti gli elementi MyDbRow)
• Nelle classi che estendono Model è possibile "linkare" altre classi "Model" ( Item(Model) <==> Category(Model))
• L'ID degli elementi inseriti è autoassegnato, se vi serve un ID fisso dovrete creare un'altra colonna per i vostri ID
• La manipolazione degli elementi del DB è semplicissima.

Implementazione Base:

Manifest.xml

Dovrete aggiungere queste 2 righe all'interno del tag <Application>

<br /> <meta-data android:name="AA_DB_NAME" android:value="Pickrand.db" /><br /> <meta-data android:name="AA_DB_VERSION" android:value="5" /><br />

 

1

​

2

<meta-data android:name="AA_DB_NAME" android:value="Pickrand.db" />

3

<meta-data android:name="AA_DB_VERSION" android:value="5" />

4

​

AA_DB_NAME = Nome del DB
AA_DB_VERSION = Versione del DB

Se la vostra app non ha nessuna classe che estende Application aggiungete anche questa parte al tag <application>

<br /> <application android:name="com.activeandroid.app.Application".. ...<br />

3

 

1

​

2

<application android:name="com.activeandroid.app.Application"..  ...

3

​

Se invece avete creato una vostra classe che estende Application, cambiate l'import dell'estensione da android.app.Application a com.activeandroid.app.Application


Creazione di un Modello:

Dovrete creare almeno una classe java che estende Model. Come accennato sopra le Classi possono essere "collegate", come vedrete qui sotto, la classe Item possiede anche una variabile Category, la quale corrisponde ad un altro elemento presente in una tabella separata

Item.java:

<br /> @<a rel="nofollow" href="https://www.androidiani.com/forum/members/tab.html" target="_blank">tab</a>le(name = "Items")<br /> public class Item exten<span class="forTooltip">ds</span> Model {<br /> // If name is omitted, then the field name is used.<br /> @<a rel="nofollow" href="https://www.androidiani.com/forum/members/col.html" target="_blank">col</a>umn(name = "Name")<br /> public String name;<br /> <br /> @<a rel="nofollow" href="https://www.androidiani.com/forum/members/col.html" target="_blank">col</a>umn(name = "Category")<br /> public Category category;<br /> <br /> public Item(){<br /> super();<br /> }<br /> public Item(String name, Category category){<br /> super();<br /> this.name = name;<br /> this.category = category;<br /> }<br /> }<br />

20

 

1

​

2

 @<a rel="nofollow" href="https://www.androidiani.com/forum/members/tab.html" target="_blank">tab</a>le(name = "Items")

3

public class Item extends Model {

4

        // If name is omitted, then the field name is used.

5

    @<a rel="nofollow" href="https://www.androidiani.com/forum/members/col.html" target="_blank">col</a>umn(name = "Name")

6

    public String name;

7

​

8

    @<a rel="nofollow" href="https://www.androidiani.com/forum/members/col.html" target="_blank">col</a>umn(name = "Category")

9

    public Category category;

10

​

11

        public Item(){

12

                super();

13

        }

14

        public Item(String name, Category category){

15

                super();

16

                this.name = name;

17

                this.category = category;

18

        }

19

}

20

​

<br /> @<a rel="nofollow" href="https://www.androidiani.com/forum/members/tab.html" target="_blank">tab</a>le(name = "Categories")<br /> public class Category extends Model {<br /> @<a rel="nofollow" href="https://www.androidiani.com/forum/members/col.html" target="_blank">col</a>umn(name = "Name")<br /> public String name;<br /> <br /> public Category() {<br /> super();<br /> }<br /> <br /> public List<Item> items() {<br /> return getMany(Item.class, "Category");<br /> }<br /> }<br />

15

 

1

​

2

 @<a rel="nofollow" href="https://www.androidiani.com/forum/members/tab.html" target="_blank">tab</a>le(name = "Categories")

3

public class Category extends Model {

4

    @<a rel="nofollow" href="https://www.androidiani.com/forum/members/col.html" target="_blank">col</a>umn(name = "Name")

5

    public String name;

6

​

7

    public Category() {

8

        super();

9

    }

10

​

11

    public List<Item> items() {

12

        return getMany(Item.class, "Category");

13

    }

14

}

15

​

Gestione degli elementi:

La gestione è veramente semplice:

Salvataggio:
<br /> Category restaurants = new Category();<br /> restaurants.name = "Restaurants";<br /> restaurants.save();<br /> <br /> Item item = new Item();<br /> item.category = restaurants;<br /> item.name = "Outback Steakhouse";<br /> item.save();<br />

10

 

1

​

2

Category restaurants = new Category();

3

restaurants.name = "Restaurants";

4

restaurants.save();

5

​

6

Item item = new Item();

7

item.category = restaurants;

8

item.name = "Outback Steakhouse";

9

item.save();

10

​

Eliminazione elementi:
<br /> new Delete().f<span class="forTooltip">rom</span>(Item.class).where("Id = ?", 1).execute();<br />

3

 

1

​

2

new Delete().from(Item.class).where("Id = ?", 1).execute();

3

​

Ottenere tutti gli elementi della tabella "Item" (List<Item>()):
<br /> public static List<Item> getAll(Category category) {<br /> return new Select()<br /> .from(Item.class)<br /> .where("Category = ?", category.getId()) //<span class="forTooltip">op</span>zionale <br /> .orderBy("Name ASC")<br /> .execute();<br /> }<br />

9

 

1

​

2

public static List<Item> getAll(Category category) {

3

    return new Select()

4

        .from(Item.class)

5

        .where("Category = ?", category.getId()) //opzionale 

6

        .orderBy("Name ASC")

7

        .execute();

8

}

9

​

Ottenere un singolo elemento:
<br /> public static Item getItem(String name) {<br /> return new Select()<br /> .from(Item.class)<br /> .where("Name = ?", name)<br /> .executeSingle();<br /> }<br />

8

 

1

​

2

public static Item getItem(String name) {

3

    return new Select()

4

        .from(Item.class)

5

        .where("Name = ?", name)

6

        .executeSingle();

7

}

8

​

Come vedete l'implementazione è molto veloce e semplice

Per approfondimenti sulla libreria, dato che è vastissima, vi rimando alla wiki ufficiale su github ==> https://github.com/pardom/ActiveAndr...etting-started

Enjoy!

[Crotan]

Per gestire in modo tradizionale un Database SQLite potete consultare questa guida (https://www.androidiani.com/forum/tu...se-sqlite.html).