《第一行代码Android》学习总结第六章 LitePal操作数据库

最新推荐文章于 2022-07-27 22:43:09 发布

原创最新推荐文章于 2022-07-27 22:43:09 发布 · 495 阅读

0 ·

CC 4.0 BY-SA版权

Android 同时被 2 个专栏收录

30 篇文章

订阅专栏

第一行代码

30 篇文章

订阅专栏

本文介绍了Android数据库框架LitePal的使用，包括配置、创建数据库、升级数据库、添加、更新和删除数据以及查询操作。通过面向对象的方式，简化了传统SQL语句的使用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

LitePal是一款开源的Android数据库框架，它采用对象关系映射（ORM）的模式，并将平时开发常用的一些数据库功能进行了封装，使得不用编写一行SQL语句就可以完成建表和增删改查操作。

对象关系映射（ORM）：Java使用的编程语言是面向对象的语言，而使用的数据库则是关系型数据库，那么面向对象的语言与面向关系的数据库之间建立一种映射关系，这就是对象关系映射。

一、配置LitePal

1、该项目已经提交到jcenter上，所以只需在app/build.gradle文件中，dependencies闭包中添加。

compile 'org.litepal.android:core:1.4.1'

2、右击main目录→New→Directory，创建一个assets目录，然后在assets目录中新建litepal.xml文件，并配置litepal.xml文件。

<?xml version="1.0" encoding="utf-8" ?>
<litepal>
    <dbname value="BookStore"></dbname>
    <version value="1"></version>
    <list>
    </list>
</litepal>

<dbname>标签用于指定数据库名。

<version>标签用于指定数据库版本号。

<list>标签用于指定所有映射模型。

3、修改AndroidManifest.xml中代码，配置将项目application 配置为org.litepal.LitePalApplication。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.launcher.litepaltest" >
    <application
        android:name="org.litepal.LitePalApplication"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" >
        <activity android:name=".MainActivity" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

二、创建数据库

Litepal采用对象映射关系（ORM）模式，使得我们可以用面向对象的思维操作数据库，而不用再和SQL语句打交道。

1、添加activity_main.xm代码。

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <Button
        android:id="@+id/create_database"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Create Batabase"/>
    <Button
        android:id="@+id/add_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Add Data"/>
    <Button
        android:id="@+id/update_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Update Data"/>
    <Button
        android:id="@+id/delete_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Delete Data"/>
    <Button
        android:id="@+id/query_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Query Data"/>
</LinearLayout>

2、定义一个Book类对应数据库中的Book表。

public class Book {
//这是一个典型的Java bean，它定义了一些字段并提供了相应的getter()与setter()方法。
    private int id;
    private String author;
    private double price;
    private int pages;
    private String name;
    public String getAuthor() {
        return author;
    }
    public void setAuthor(String author) {
        this.author = author;
    }
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getPages() {
        return pages;
    }
    public void setPages(int pages) {
        this.pages = pages;
    }
    public double getPrice() {
        return price;
    }
    public void setPrice(double price) {
        this.price = price;
    }
}

3、将Book类添加到映射模型列表中，修改litepal.xml。

<?xml version="1.0" encoding="utf-8" ?>
    <litepal>
    <dbname value="BookStore"></dbname>
    <version value="1"></version>
    <list>
        <mapping class="com.launcher.litepaltest.Book"></mapping>
    </list>
</litepal>

其中<mapping>标签需要我们来声明要配置的映射模型类，一定要使用完整类名。

4、修改MainActivity中代码，此时只要进行任意一次数据库操作，BookStore.db数据库就会自动创建出来。

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button createDatabase = (Button) findViewById(R.id.create_database);
        createDatabase.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                LitePal.getDatabase();
            }
        });
   }
}

三、升级数据库

只需修改任何想改的内容，再将版本号加1即可。

1、修改Book类添加press字段。

public class Book {
    ……
    private  String press;
    ……
    public String getPress() {
        return press;
    }
    public void setPress(String press) {
        this.press = press;
    }
}

2、再添加一张Category表，新建Category类。

public class Category {
    private int id;
    private String categoryName;
    private int categotyCode;
    public void setCategoryName(String categoryName) {
        this.categoryName = categoryName;
    }
    public void setCategotyCode(int categotyCode) {
        this.categotyCode = categotyCode;
    }
    public void setId(int id) {
        this.id = id;
    }
}

3、修改litepal.xml文件，版本号加1，添加Category模型到映射模型列表。

<?xml version="1.0" encoding="utf-8" ?>
    <litepal>
    <dbname value="BookStore"></dbname>
    <version value="2"></version>
    <list>
        <mapping class="com.launcher.litepaltest.Book"></mapping>
        <mapping class="com.launcher.litepaltest.Category"></mapping>
    </list>
</litepal>

四、使用LitePal添加数据

只需创建出模型类的实例，再将要储存的数据设置好，最后调用一下save()方法即可。此时的模型类必须要继承DataSupport类才行。

1、修改Book类代码，使其继承自DataSupport类。

public class Book extends DataSupport{
             ……
}

2、修改MainActivity中代码。

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ……
        Button addData = (Button) findViewById(R.id.add_data);
        addData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
//创建Book实例并添加数据
                Book book = new Book();
                book.setName("The Da Vinci Code");
                book.setAuthor("Dan Brown");
                book.setPages(454);
                book.setPrice(16.96);
                book.setPress("Unknow");
//DataSupport类中的方法
                book.save();
            }
        });
   }
}

五、使用LitePal更新数据。

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ……
        Button updateData = (Button) findViewById(R.id.update_data);
        updateData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Book book = new Book();
                book.setPrice(14.95);
                book.setPress("Anchor");
// updateAll()方法执行更新操作，该方法可以指定条件约束，如果不指定则表示更新所有数据。
                book.updateAll("name = ? and author = ?", "The Lost Symbol","Dan Brown");

            }
        });
   }
}

注意当想把一个字段设置成默认值时不能使用用setXxx()方法，对于所有想要将为数据更新成默认值的操作需使用setToDefault()方法。

六、使用LitePal删除数据

方法一：直接调用已储存对象的delete()方法。

方法二：调用DataSupport的deleteAll()方法删除数据。

第一个参数：指定删除哪张表的数据。

第二、三个参数：指定约束条件。如果不指定则删除所有。

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ……
        Button deleteData = (Button) findViewById(R.id.delete_data);
        deleteData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                DataSupport.deleteAll(Book.class,"price < ?","15");
            }
        });
    }
}

七、使用LitePal查询数据。

只需调用findAll()方法，自动完成赋值，返回一个模型类的List集合。

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ……..
        Button queryData = (Button) findViewById(R.id.query_data);
        queryData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                List<Book> books = DataSupport.findAll(Book.class);
//遍历模型类的List集合
                for (Book book: books){
                    Log.d("MainActivity", "book name is "+book.getName());
                    Log.d("MainActivity", "book author is "+book.getAuthor());
                    Log.d("MainActivity", "book pages is "+book.getPages());
                    Log.d("MainActivity", "book price is "+book.getPrice());
                    Log.d("MainActivity", "book press is "+book.getPress());
                }
            }
        });
    }
}

除了findAll()方法以外，LitePal还提供了很多其他的API：

1）查询表中第一条数据。

Book firstBook = DataSupport.findFirst(Book.class);

2）查询表中最后一条数据。

Book lastBook = DataSupport.findLast(Book.class);

3）select()方法指定查询哪几列，对应于SQL的select关键字。

List<Book> books = DataSupport.select("name","author").find(Book.class);

4）where()方法指定查询约束条件，对应于SQL的where关键字。

List<Book> books = DataSupport.where("page > ?","400").find(Book.class);

5）order()方法用于指定结果的排序方式

List<Book> books = DataSupport.order("price desc").find(Book.class);

6）limit()方法指定查询结果的数量。

List<Book> books = DataSupport.limit(3).find(Book.class);

7）offset()方法指定查询结果的偏移量。

List<Book> books = DataSupport.limit(3).offset(1).find(Book.class);

8）任意连缀组合复杂查询。

List<Book> books = DataSupport.select("name","author","pages")

                              .where("pages> ? ","400")

                              .order("pages")

                              .limit(10)

                              .offset(10)

                              .find(Book.class);

9）LitePal同样支持原生SQL查询。

Cursor cursor = DataSupport.findBySQL("select * from Book where pages > ? and price < ?","400","20");

其中第一个参数为SQL语句，后面的参数用于指定占位符的值，该方法返回Cursor对象作为查询结果。