安卓第七夜 雅典学院

作者：Vamei 出处：http://www.cnblogs.com/vamei 欢迎转载，也请保留这段声明。谢谢！ 

 

我之前只使用了一种持续保存数据的方法，即SharedPreferences。然而，SharedPreferences只能存储少量松散的数据，并不适合大量数据的存储。安卓带有SQLite数据库，它是一个简单版本的关系型数据库，可以应对更复杂的数据存取需求。我将在这里说明安卓中该数据库的使用方法。这里只专注于安卓中SQLite数据库的接口使用，并没有深入关系型数据库和SQL语言的背景知识。

《雅典学院》是拉斐尔的画。他在这幅壁画中描绘了许多古典时代的哲学家，如苏格拉底、柏拉图、亚里士多德等。画中的哲学家生活在不同的时代，硬是被拉斐尔放在了一起。

 

描述

这一讲，我将继续拓展应用的功能，让应用存储多个联系人信息。相关的安卓知识点包括：

  • 使用SQLite数据库。
  • 使用adb命令行工具查看数据库。

在这一讲中的新增代码，都将放入到me.vamei.vamei.model包中。右键点击src文件夹，选择New -> Package，就可以在src中创建新的包。

 

创建对象模型

在面向对象语言中，对象用于描述和操作数据。我使用两个类Category和Contact的对象：

  • Category：联系人分类。包括id属性和name属性。
  • Contact：联系人。包括id，url，name和categoryId属性。其中categoryId是Contact所属Category对象的id。

 

 

Category类与Contact类 

Category类有id和name属性，分别存储序号和分类姓名。它定义在Category.java中：

package me.vamei.vamei.model;

public class Category {
    int id;
    String name;

    public Category() {}

    public Category(String name) {
        this.name = name;
    }

    public Category(int id, String name) {
        this.id = id;
        this.name = name;
    }

    public int getId() {
        return this.id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return this.name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

 

Contact类的定义在Contact.java中。它的id和name属性，用于记录联系人序号和联系人姓名。url用以存储联系人的博客地址。Contact还有一个Category类的属性。这是用组合的方式，说明了Contact所归属的Category。

 

package me.vamei.vamei.model;

public class Contact {
    int id;
    Category category;
    String name;
    String url;

    public Contact() {

    }

    public Contact(String name, String url, Category category) {
        this.name = name;
        this.url  = url;
        this.category = category;
    }

    public Contact(int id, String name, String url, Category category) {
        this.id   = id;
        this.name = name;
        this.url  = url;
        this.category = category;
    }

    public int getId() {
        return this.id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return this.name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getUrl() {
        return this.url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public Category getCategory() {
        return this.category;
    }

    public void setCategory(Category category) {
        this.category = category;
    }
}

 

上面的对象数据模型只是存活于内存中，只能临时保存数据。要想持续的保存数据，我们还要想办法把对象中的数据放入SQLite的表中。安卓提供了一个类来实现相关的交互，即SQLiteOpenHelper。

 

SQLiteOpenHelper

SQLiteOpenHelper是对象数据模型和关系型数据库的一个接口。我通过继承该类，对每一个数据库建立一个子类。这个子类即代表了该数据库。数据库操作的相关SQL语句都存放在该子类中。

 

下面的contactsManager类管理了"contactsManager"数据库。这个类定义在ContactsManager.java中。我需要覆盖该类的onCreate()和onUpgrade()方法，用于说明创建和升级时，数据库将采取的行动，比如在创建时新建数据库的表。SQLite利用SQL语言进行操作，所以建表的过程就是执行SQL的"create table ..."语句。在该类中，我还额外增加CRUD方法，即新建(Create)、读取(Read)、更新(Update)、删除(Delete)数据库记录。

 

package me.vamei.vamei.model;

import java.util.LinkedList;
import java.util.List;

import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;

/*
 * Database Manager
 * Interfacing between the database and the object models
 * */
public class ContactsManager extends SQLiteOpenHelper {

    // All Static variables
    // Database Version
    private static final int DATABASE_VERSION = 1;

    // Database Name
    private static final String DATABASE_NAME = "contactsManager";

    // Contacts table name
    private static final String TABLE_CONTACTS   = "contacts";
    private static final String TABLE_CATEGORIES = "categories";

    // Contacts Table Columns names
    private static final String KEY_ID   = "id";
    private static final String KEY_CATEGORY_ID = "category_id";
    private static final String KEY_NAME = "name";
    private static final String KEY_URL  = "url";

    // Constructor
    public ContactsManager(Context context) {
        super(context, DATABASE_NAME, null, DATABASE_VERSION);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        String CREATE_CATEGORIES_TABLE = "CREATE TABLE " + TABLE_CATEGORIES + "("
                + KEY_ID + " INTEGER PRIMARY KEY AUTOINCREMENT,"
                + KEY_NAME + " TEXT UNIQUE" + ")";
        String CREATE_CONTACTS_TABLE = "CREATE TABLE " + TABLE_CONTACTS + "("
                + KEY_ID + " INTEGER PRIMARY KEY AUTOINCREMENT," + KEY_NAME + " TEXT,"
                + KEY_CATEGORY_ID + " INTEGER," + KEY_URL + " TEXT,"
                + "FOREIGN KEY(" + KEY_CATEGORY_ID +") REFERENCES "
                + TABLE_CATEGORIES + "(" + KEY_ID + ")"
                + ")";
        db.execSQL(CREATE_CATEGORIES_TABLE);
        db.execSQL(CREATE_CONTACTS_TABLE);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // Drop older table if existed
        db.execSQL("DROP TABLE IF EXISTS " + TABLE_CATEGORIES);
        db.execSQL("DROP TABLE IF EXISTS " + TABLE_CONTACTS);
        // Create tables again
        onCreate(db);
    }

     /**
     * All CRUD(Create, Read, Update, Delete) Operations for Contacts
     */

    public void createContact(Contact contact) {
        SQLiteDatabase db = this.getWritableDatabase();

        ContentValues values = new ContentValues();
        values.put(KEY_NAME, contact.getName());
        values.put(KEY_URL, contact.getUrl());
        values.put(KEY_CATEGORY_ID, contact.getCategory().getId());

        db.insert(TABLE_CONTACTS, null, values);
        db.close();
    }

    // Getting single contact
    public Contact getContact(int id) {
        SQLiteDatabase db = this.getReadableDatabase();

        Cursor cursor = db.query(TABLE_CONTACTS, new String[] { KEY_ID,
            KEY_NAME, KEY_URL, KEY_CATEGORY_ID }, KEY_ID + "=?",
            new String[] { String.valueOf(id) }, null, null, null, null);
        if (cursor != null)
            cursor.moveToFirst();

        Category category = getCategory(Integer.parseInt(cursor.getString(3)));
        Contact contact = new Contact(Integer.parseInt(cursor.getString(0)),
            cursor.getString(1), cursor.getString(2),
            category);

        // return contact
        return contact;
    }

    // Getting all contacts
    public List<Contact> getAllContacts() {
        List<Contact> contacts = new LinkedList<Contact>();

        // build the query
        String query = "SELECT  * FROM " + TABLE_CONTACTS;

        // get reference to writable DB
        SQLiteDatabase db = this.getReadableDatabase();
        Cursor cursor = db.rawQuery(query, null);

        // iterate over all retrieved rows
        Contact contact = null;
        if (cursor.moveToFirst()) {
            do {
                contact = new Contact();
                contact.setId(Integer.parseInt(cursor.getString(0)));
                contact.setName(cursor.getString(1));
                contact.setUrl(cursor.getString(2));

                Category category = getCategory(Integer.parseInt(cursor.getString(3)));
                contact.setCategory(category);

                // Add category to categories
                contacts.add(contact);
            } while (cursor.moveToNext());
        }

        // return books
        return contacts;
    }

    // Updating single contact
    public int updateContact(Contact contact) {
        SQLiteDatabase db = this.getWritableDatabase();

        ContentValues values = new ContentValues();
        values.put(KEY_NAME, contact.getName());
        values.put(KEY_URL, contact.getUrl());
        values.put(KEY_CATEGORY_ID, contact.getCategory().getId());

        // updating row
        return db.update(TABLE_CONTACTS, values, KEY_ID + " = ?",
            new String[] { String.valueOf(contact.getId()) });
    }

    // Deleting single contact
    public void deleteContact(Contact contact) {
        SQLiteDatabase db = this.getWritableDatabase();
        db.delete(TABLE_CONTACTS, KEY_ID + " = ?",
            new String[] { String.valueOf(contact.getId()) });
        db.close();
    }

     /**
     * All CRUD(Create, Read, Update, Delete) Operations for Contacts
     */

    // Adding a single category
    public void createCategory(Category category) {
        SQLiteDatabase db = this.getWritableDatabase();

        ContentValues values = new ContentValues();
        values.put(KEY_NAME, category.getName());
        db.insert(TABLE_CATEGORIES, null, values);
        db.close();
    }

    // Getting single contact
    public Category getCategory(int id) {
        SQLiteDatabase db = this.getReadableDatabase();

        Cursor cursor = db.query(TABLE_CATEGORIES, new String[] { KEY_ID,
            KEY_NAME }, KEY_ID + "=?",
            new String[] { String.valueOf(id) }, null, null, null, null);
        if (cursor != null)
            cursor.moveToFirst();

        Category category = new Category(Integer.parseInt(cursor.getString(0)),
                cursor.getString(1));

        // return contact
        return category;
    }

    // Getting all categories
    public List<Category> getAllCategories() {
        List<Category> categories = new LinkedList<Category>();

        // build the query
        String query = "SELECT  * FROM " + TABLE_CATEGORIES;

        SQLiteDatabase db = this.getWritableDatabase();
        Cursor cursor = db.rawQuery(query, null);

        // iterate over the categories
        Category category = null;
        if (cursor.moveToFirst()) {
            do {
                category = new Category();
                category.setId(Integer.parseInt(cursor.getString(0)));
                category.setName(cursor.getString(1));

                // Add category to categories
                categories.add(category);
            } while (cursor.moveToNext());
        }

        // return categories
        return categories;
    }

    // Updating single contact
    public int updateCategory(Category category) {
        SQLiteDatabase db = this.getWritableDatabase();

        ContentValues values = new ContentValues();
        values.put(KEY_NAME, category.getName());

        // updating row
        return db.update(TABLE_CATEGORIES, values, KEY_ID + " = ?",
            new String[] { String.valueOf(category.getId()) });
    }

    // Deleting single contact
    public void deleteCategory(Category category) {
        SQLiteDatabase db = this.getWritableDatabase();
        db.delete(TABLE_CATEGORIES, KEY_ID + " = ?",
            new String[] { String.valueOf(category.getId()) });
        db.close();
    }
}

 

在属性中，我说明了数据库的一些相关参数，如数据库版本，数据库名和表名。我还在数据库中定义了表的属性名称。

onCreate()方法负责了表格的创建。而onUpgrade()方法中，则说明了数据库升级后，需要删除所有数据，重新创建表格。

此外，我还编写了进行数据库操作的CRUD方法。这些方法的核心实际上是一些操作数据库的SQL语句。如果上面的CRUD方法无法满足数据库操作的需求，你还可以根据需要增加方法。

 

 

数据库使用

在之前编写的MainActivity的onCreate()方法中，调用数据库：

......
    @Override
    public void onCreate() {
            ......
        ContactsManager cm = new ContactsManager(this);

        // add categories to the database
        cm.createCategory(new Category("Friend"));
        cm.createCategory(new Category("Enermy"));

        // add contact to the database
        Category cat1 = cm.getCategory(1);
        cm.createContact(new Contact("vamei", "http://www.cnblogs.com/vamei", cat1));

        // retrieve and display
        Toast.makeText(this, cm.getContact(1).getName(), Toast.LENGTH_LONG).show();
    }
......

上面进行了简单的数据存储和读取。效果如下：

我将在下一讲中，利用数据库实现更复杂的功能。

 

adb查看数据库

adb是安卓提供的命令行工具。你可以在计算机上使用该命令行，查看安卓设备中的SQLite数据库。首先，查看连接在计算机上的安卓设备：

adb devices -l

该命令会列出所有的设备及其端口。

 

打开某个设备：

adb -s 192.168.56.101:5555 shell

-s参数说明了设备的端口。这样就进入了该设备的命令行Shell。我们可以在该命令行使用常用的如cd, ls, pwd命令。

 

应用的数据库存在下面文件夹中：

/data/data/me.vamei.vamei/databases/

其中的me.vamei.vamei是我们正在编写的应用。

 

之前部分已经创建了contactsManager数据库。使用sqlite3打开：

sqlite3 /data/data/me.vamei.vamei/databases/contactsManager

将进入SQLite提供的命令行。可以按照SQLite终端的使用方法操作。例如

.tables   #显示所有的表格

或者直接使用SQL语句：

select * from categories;

使用结束后，按Ctrl + D推出SQLite终端。

 

在开发过程中，这一命令行工具可以帮助我们快捷查询数据库状态，方便debug。

 

总结

SQLiteOpenHelper

adb终端查看数据库

时间： 2024-10-02 12:30:24

安卓第七夜 雅典学院的相关文章

10天学安卓-第七天

原文:10天学安卓-第七天 我们上次学习了百度定位以及SharedPreferences的使用,不知道大家有没有注意到我们新加了一个方法: protected void onStop() { super.onStop(); mLocationClient.stop(); }   这个方法的作用是在界面停止的时候,同时停止百度定位功能.   联想到我们还有onCreate,那么这两个方法是做什么用的?是什么原理呢? 这就需要我们来了解一下Activity的生命周期. Activity生命周期 Ac

安卓第四夜 概念漫游（下）

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!   在安卓第三夜 概念漫游(上)中,我介绍了安卓最基本的功能单元和Intent的连接方式.在这个骨架之上,我们可以进一步增加一些与开发密切相关的重要概念.   Context 一个应用是由多个Activity和Service这样的功能单元组成.一个应用共享有一个Application Context对象.在功能单元内部,可以用特定的方法来调用该对象.正如名字所表示的,Contex

安卓第五夜 维纳斯的诞生

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!   之前各讲中,分别讲解了安卓的开发环境.架构和基本概念.从这一讲开始,我将制作一个简单的应用,并通过逐步升级它的功能,连带出安卓开发的多个情境. <维纳斯的诞生>是文艺复兴早期名画.相传美神维纳斯从海的泡沫中诞生,波提切利用大胆的笔触描绘这一古典神话.画面洋溢着对人体和美的热爱.如果在中世纪或者西班牙宗教审判时期,这幅画足够波提切利上火刑架了.    任务描述 我将制作一个简

安卓第六夜 凡高的自画像

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!   在上一讲中,我已经制作了一个简单的Android应用.项目的主要文件包括: MainActivity.java activity_main.xml 在这一讲,我将拓展应用的功能,从而允许用户输入个人信息.   <自画像>,凡高.凡高一生不得志,精神更是越来越差.在割掉自己的耳朵一部分后,画家给自己留下了这幅自画像.在当时,这幅画依然是无人问津.   描述 我将创建一个新的A

安卓第八夜 玛丽莲梦露

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!    上一讲说明了数据库中存取数据的方法.这一讲将以条目的视图方式,来以相似的视图方式,显示多个数据对象.这种方式特别适合于显示从数据库中取出的多个结构相似的数据,比如多个联系人,或者多个联系人分类. <玛丽莲梦露>,这是一副现代艺术作品.听到玛丽莲梦露自杀的消息后,现代艺术家沃霍尔深为震惊.他通过重复玛丽莲梦露的形象,创作了这幅波普艺术的名作.每一个形象既是重复,又有变化.

安卓第十夜 亚当的诞生

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!   上一讲介绍了用WebView来抓取一个网页内容.这一讲我将介绍如何在安卓内部直接进行HTTP通信. <亚当的诞生>,西斯廷礼拜堂的吊顶画,米开朗基罗之作.当时的教皇强迫沉迷于雕塑的米开朗基罗画巨幅壁画.米开朗基罗认为这是在浪费自己的才华,充满愤怒的作画.当然,他又成功了.   描述 这一讲中,我将使用JSON,将数据库备份到远程的数据库中.反过来我也将从远程数据库中抓取条目

安卓第三夜 概念漫游（上）

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!    拿起一个手机,总是满屏的应用图标.点击图标,选择应用,玩一把游戏,刷一下微博,写一篇日记."叮咚"一声,邮件应用提醒有一封新来的邮件.在安卓里,眼花缭乱的应用承载着各种有趣的功能.欢迎来到安卓应用的世界. 每一个应用都是存储在手机中的一段小程序.编写这段小程序,是每个安卓开发者的主要工作.程序运行后成为一个进程后,在进程的内存空间中新建一个Dalvik虚拟机.程序

Java快速教程

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!      Java是面向对象语言.这门语言其实相当年轻,于1995年才出现,由Sun公司出品.James Gosling领导了Java的项目小组.该项目的最初只想为家电设计一门容易移植的语言.然而,在获得了Netscape浏览器支持后,Java快速推广,应用广泛. Java受到C和C++的强烈影响.Java与C++相近,都是静态类型,但移除了C++中容易出错的一些特征,比如指针和

安卓第九夜 狂风

作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢!   我们经常需要在安卓应用中包含简易的网页显示功能.我将在这一讲中实现网页的显示. <狂风>,来自小Willem,荷兰画派黄金时代的作品.作为当时海上马车夫的荷兰,对航海题材的画情有独钟. 这种倾斜的船身,是当时的画家常用的手法,用于表现很强的风.   描述 上一讲实现了一个类别条目页面.现在,我希望点击某个类别后,能再次以条目的方式显示所有的联系人.在这个新的条目页面中,点击