Android compose wanandroid app之搜索页面实现

Posted 2021-12-21 theyangchoi

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Android compose wanandroid app之搜索页面实现相关的知识，希望对你有一定的参考价值。

实现搜索页面

前言

前言

今天来实现一下搜索页面，使用ROOM数据库保存搜索的历史记录，根据不同加载状态展示不同布局，并使用官方的Flow layout来展示数据等操作。

先来看一下效果图，很丑~将就看一下

ROOM数据库

Room是一个数据持久化库，它是 Architecture Component的一部分。它让SQLiteDatabase的使用变得简单，大大减少了重复的代码，并且把SQL查询的检查放在了编译时。

Room数据库主要由Dao、Entity、DataBase三部分组成。

使用Room之前要导入依赖：

//jetpack room
implementation 'androidx.room:room-runtime:2.2.6'
kapt 'androidx.room:room-compiler:2.2.6'

并在build.gradle的plugins中添加以下代码：

plugins 
    ...
    id 'kotlin-kapt'

Entity

在声明数据库实体类的时候需要使用@Entity来标注改实体类，主要属性如下：

tableName 设置表名
indices 设置索引
primaryKeys 设置主键
foreignKeys 设置外键
inheritSuperIndices 父类索引是否被当前类继承

创建一个tableName为search_table的Entity，同时设置主键，注意设置主键的时候的初始值要为0：

@Entity(tableName = "search_table")
data class SearchModule(
    @PrimaryKey(autoGenerate = true)//主键自增
    val id:Int = 0,//主键初始值为0

    @ColumnInfo(name = "time_stamp")//列名
    @SerializedName("time_stamp")
    val time_stamp:String,

    @ColumnInfo(name = "search_content")
    @SerializedName("search_content")
    val search_content:String,

    @ColumnInfo(name = "is_delete")
    @SerializedName("is_delete")
    val is_delete:Boolean = false,

    @ColumnInfo(name = "create_time")
    @SerializedName("create_time")
    val create_time:String
)

Dao

数据访问对象，全称Data Access Objects，是Room的主要组件，负责定义访问数据库的方法，Room在编译时创建每个DAO实例。DAO抽象地以一种干净的方式去访问数据库，它可以是一个接口也可以是一个抽象类。如果它是一个抽象类，它可以有一个构造函数，它将RoomDatabase作为其唯一参数。

定义一个Dao，并实现增加，查询，删除三个方法；同时该类也要被@Dao进行注解：

@Dao
interface Dao 

    @Insert
    fun insert(searchModule: SearchModule):Long

    @Delete
    fun delete(searchList:List<SearchModule>):Int

    @Query("SELECT * FROM SEARCH_TABLE WHERE is_delete ==:isDelete")
    fun queryDataList(isDelete:Boolean):List<SearchModule>

DataBase

数据库持有者，并作为与应用持久关联数据的底层连接的主要访问点。在运行时，通databaseBuilder() 或者 inMemoryDatabaseBuilder()获取Database实例。

使用DataBase要注意以下几个地方：

该类必须是 abstract的
该类必须继承RoomDatabase
该类必须包含至少一个@Entity标注的类
该类必须包含一个被@Dao标注的类

//至少包含一个@Entity标注的类
@Database(entities = [SearchModule::class],exportSchema = false,version = 1)
abstract class SearchDataBase : RoomDatabase() 
	//至少包含一个@Dao标注的类
    abstract val dao:Dao


@Volatile
private var dbInstance: SearchDataBase? = null

val Context.db: SearchDataBase
    get() 
        if (dbInstance == null)
            synchronized(SearchDataBase::class) 
                if (dbInstance == null) 
                    val ctx = MyApplication.context
                    dbInstance = Room
                        .databaseBuilder(ctx, SearchDataBase::class.java, "search")
                        .build()
                
            
        
        return dbInstance!!

viewmodel定义操作方法

创建好room相对应的三个类之后，就可以执行数据增删改查操作了；创建一个SearchViewModel来实现数据操作，在viewmodel中操作数据。

在viewmodel中创建插入方法：

fun insetData(context: Context,searchModule: SearchModule):Long
    val db = context.db
    val insert = db.dao.insert(searchModule)
    return insert

在viewmodel中创建查询方法：

fun queryDataList(context: Context,isDelete:Boolean)
    var dataList:List<SearchModule>? = null
    val db = context.db
    dataList = db.dao.queryDataList(isDelete)
    _dataList.postValue(dataList)

这里给数据源设置值的时候要注意，因为操作数据库要在子线程中操作，所以不能直接使用_dataList.value的方法设置值，而是要改为使用postValue的方法设置值。

在viewmodel中创建删除方法：

fun clearDataBase(context: Context,dataList:List<SearchModule>):Int
    val db = context.db
    val int = db.dao.delete(dataList)
    if (int != 0)
         _dataList.postValue(null)
     
    return int

page实现数据操作

在page页面调用viewmodel的方法，进行输入的新增查询等操作。

在page页面点击搜索的时候往数据库插入数据，在插入数据之前需要先定义插入数据的相关类：

val searchModule = SearchModule(
time_stamp = "$System.currentTimeMillis()",
search_content = searchTv.value,
is_delete = false, 
create_time = formatTime())

新开一个子线程进行输入插入：

thread 
    val insertLong = searchViewModel.insetData(MyApplication.context,searchModule)

insertLong 返回的是插入成功的条数。

在page页面查询数据：

val searchViewModel:SearchViewModel = viewModel()
val dataList by searchViewModel.dataList.observeAsState()
thread 
    searchViewModel.queryDataList(MyApplication.context,false)

官方Flow Layout

前面在绘制分类页面的时候，自定义了一个FlowLayout，当时只是为了尝试一下compose的自定义view；在搜索这里同样要实现内容的Flow 排列，这里使用官方的Flow Layout。

要使用官方的Flow Layout需要导入以下依赖：

implementation "com.google.accompanist:accompanist-flowlayout:$accompanist_pager"

Flow Layout属性

使用FlowLayout实现历史记录的展示，如下图：

在使用组件之前还是要先知道组件的属性，才能更好的使用该组件。

@Composable
public fun FlowRow(
    modifier: Modifier = Modifier,
    mainAxisSize: SizeMode = SizeMode.Wrap,
    mainAxisAlignment: FlowMainAxisAlignment = FlowMainAxisAlignment.Start,
    mainAxisSpacing: Dp = 0.dp,
    crossAxisAlignment: FlowCrossAxisAlignment = FlowCrossAxisAlignment.Start,
    crossAxisSpacing: Dp = 0.dp,
    lastLineMainAxisAlignment: FlowMainAxisAlignment = mainAxisAlignment,
    content: @Composable () -> Unit
)

modifier 修饰
mainAxisSize 布局在主轴方向上的大小
mainAxisAlignment 每行的子对象在主轴方向上的对齐。
mainAxisSpacing 每行子对象之间的主轴间距。
crossAxisAlignment 每行的子项在横轴方向上的对齐。
crossAxisSpacing 布局行之间的横轴间距。
lastLineMainAxisAlignment 替代最后一行的主轴对齐方式。
content flowlayout的内容，可以理解为放置的子元素

同时还要注意Flow Layout分为Flow Row 和 Flow Column两种，我们这里使用的是Flow Row。

使用示例如下：

FlowRow(modifier = Modifier
                .fillMaxWidth()
                .padding(12.dp, 20.dp, 0.dp, 0.dp)) 
                /***/

FlowRow添加数据

直接在FlowRow的content里面循环添加子元素

dataList?.forEach 
      Card(
           modifier = Modifier.padding(0.dp,12.dp,12.dp,0.dp),
           border = BorderStroke(color = Color.Black, width = Dp.Hairline),
           shape = RoundedCornerShape(8.dp)
      ) 
            Row(
                modifier = Modifier.padding(start = 8.dp, top = 4.dp, end = 8.dp, bottom = 4.dp),
                verticalAlignment = Alignment.CenterVertically
                ) 
                   Spacer(Modifier.width(4.dp))
                   Text(text = it.search_content)

状态布局

简单实现一个数据加载状态布局，分别对应数据加载的加载中，加载失败，加载成功，数据为空等状态时显示不同的布局。

定义状态枚举

创建四个枚举，分别对应不同状态：

enum class LoadingState
    Loading,
    Error,
    Empty,
    Success

展示布局

根据不同状态显示不同布局，首先要定义四个布局回调：

@Composable
fun LoadingStateLayout(modifier: Modifier,
                       loadingState: LoadingState,
                       loading:@Composable () ->Unit,//加载中
                       error:@Composable () ->Unit,//加载出错
                       empty:@Composable () ->Unit,//数据为空
                       success:@Composable () ->Unit)//加载成功
                       /***/

根据不同状态显示不同布局：

Box(modifier = modifier)
        val state = loadingState
        when(state)
            LoadingState.Loading->  loading()
            LoadingState.Error ->   error()
            LoadingState.Empty ->   empty()
            LoadingState.Success -> success()

记录数据状态

在viewmodel中记录请求状态

val searchLoadingState:MutableLiveData<LoadingState> = MutableLiveData(LoadingState.Loading)

在page页面同步请求状态：

//搜索内容加载状态loading
val searchLoadingState by searchViewModel.searchLoadingState.observeAsState()

viewmodel获取和page展示数据

在viewmodel中创建数据集合

//搜索结果
private val _searchList = MutableLiveData<SearchModule2>()
val searchList = _searchList

在viewmodel中创建请求数据的方法：

fun getSearchContent(page:Int,keyWord:String,pageSize:Int)
        NetWork.service.searchContent(page,keyWord,pageSize).enqueue(object : Callback<BaseResult<SearchModule2>>
            override fun onResponse(
                call: Call<BaseResult<SearchModule2>>,
                response: Response<BaseResult<SearchModule2>>) 
                response.body()?.let 
                    _searchList.value = it.data
                
            

            override fun onFailure(call: Call<BaseResult<SearchModule2>>, t: Throwable) 
                searchLoadingState.value = LoadingState.Error
            

        )

根据返回的数据来判断是否为空，如果为空则将保存的状态设置为empty，否则为success：

if (it.data?.datas != null)
       searchLoadingState.value = LoadingState.Success
else
		searchLoadingState.value = LoadingState.Empty

在page中获取数据：

val searchList by searchViewModel.searchList.observeAsState()
searchViewModel.getSearchContent(0,searchTv.value,3)

在page中使用状态布局展示数据：

Spacer(modifier = Modifier.height(20.dp))
Text(text = "搜索结果",fontSize = 14.sp,color = Color.Black,modifier = Modifier.padding(horizontal = 16.dp))
LoadingStateLayout(
            modifier = Modifier.fillMaxWidth(),
            loadingState = searchLoadingState!!,
            loading = 
                Column(modifier = Modifier
                    .padding(vertical = 20.dp)
                    .fillMaxWidth()
                    .height(100.dp),
                    horizontalAlignment = Alignment.CenterHorizontally,
                    verticalArrangement = Arrangement.Center) 
                    CircularProgressIndicator()
                    Text(text = "请先搜索",modifier = Modifier.padding(vertical = 10.dp))
                
            ,
            error = 
                Column(modifier = Modifier
                    .fillMaxWidth()
                    .height(100.dp),
                    horizontalAlignment = Alignment.CenterHorizontally,
                    verticalArrangement = Arrangement.Center) 
                    Text(text = "暂无数据")
                
            ,
            empty = 
                Column(modifier = Modifier
                    .fillMaxWidth()
                    .height(100.dp),
                    horizontalAlignment = Alignment.CenterHorizontally,
                    verticalArrangement = Arrangement.Center) 
                    Text(text = "暂无数据")
                
            ) 
            LazyColumn(modifier = Modifier.fillMaxWidth())
                itemsIndexed(searchList!!.datas) index: Int, item: SearchList ->
                    Column(modifier = Modifier
                        .fillMaxWidth()
                        .height(45.dp),
                        horizontalAlignment = Alignment.CenterHorizontally,
                        verticalArrangement = Arrangement.Center) 
                        Text(text = item.title,fontSize = 14.sp)
                    
                    Divider(
                        modifier = Modifier
                            .padding(0.dp, 0.dp, 12.dp, 0.dp,),
                        color = Color(229,224,227),
                        thickness = 1.dp,
                        startIndent = 16.dp)

源码地址

Gitee地址如下：戳我~
项目很丑，多担待，后面再美化了~

以上是关于Android compose wanandroid app之搜索页面实现的主要内容，如果未能解决你的问题，请参考以下文章

Android compose crane

Android笔记--Compose基础

Android Kotlin Jetpack Compose 使用

Android Jetpack Compose学习—— Jetpack compose基础布局