构建完整消息接收加载流程
在 “开发简单Android聊天软件(5)” 中,完成了会话窗口的绘制,以及消息发送。现在我们来完成消息接收和加载,构建一个完整的聊天流程。
消息加载,那必然不能全部依靠服务器请求,那样太吃服务器性能了,也会带来大量的耗时。想要加载完整的消息列表,消息历史记录的数据来源必然分为两部分:1、手机端本地存量历史记录、2、手机端离线时,服务器存储的离线消息记录。
所以一次消息页面的加载数据来源是分为这两部分的,那我们本次就以手机端本地存量历史记录,和实时聊天数据进行处理进行说明。手机端没在线时的离线聊天数据,我们放后面再说。
一、接收实时消息时候,聊天页面刷新、且聊天记录存本地。
1、首先,引用一下郭神的数据库框架
//sqlite
implementation 'org.litepal.guolindev:core:3.1.1'
2、修改AndroidManifest.xml的android:name。
<application
android:name="org.litepal.LitePalApplication"
...
...
>
</application>
3、在main目录下,与java文件夹同层级,创建assets文件夹。并在assets目录中新建litepal.xml。声明创建名为chat的数据库,且关联实体类,新建两个表user和im_msg_content。litepal框架会关联实体类的字段,帮我们自动完成数据库表字段的创建。litepal更多具体操作和方法可以去网上查更详细的资料,或者直接关注“郭霖”大佬的账号。
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="chat" />
<version value="1" />
<list>
<mapping class="com.liuzi.chatdemo.bean.User"/>
<mapping class="com.liuzi.chatdemo.bean.chat.Im_msg_content"/>
</list>
</litepal>
4、在第一个页面活动中MainActivity中,添加如下代码,即可完成sqlite数据库创建。
LitePal.getDatabase();
5、重新规划一下Im_msg_content实体类。
public class Im_msg_content extends LitePalSupport { //继承LitePalSupport,数据库框架需要
private int mid; //所有消息id序号,服务器数据库全局自增主键
private int id; //消息id序号
private String cid; //会话发送方接收方拼接id,用于会话识别判断
private String content;
private String sender_id;
private String recipient_id;
private int msg_type;
private String create_time;
private String ishost; //该消息发出用户是否为当前用户,服务端数据不存在该字段
private String isSendOk; //该消息是否发送成功,服务端不存在该字段 0:发送中, 1:发送失败 空白字段:完成
//set、get、构造方法
}
6、然后还记得我们之前在socket的onMessage()的方法中,捕获到了服务器转发给我们的json格式消息,然后我们通过gson工具转为了消息实体类吗。这个时候可以进行保存了。
@Override
public void onMessage(String message) {
//在这里处理服务端发来的消息
KLog.d("onMessage", message);
Gson gson=new Gson();
Im_msg_content im=gson.fromJson(String.valueOf(message), Im_msg_content.class);
String recipient_msg = im.getContent //获取到消息
//本次新增逻辑
Cursor cursor=LitePal.findBySQL("select * from Im_msg_content where mid = ?" , String.valueOf(im.getMid())); //获取全局id主键,判断本机是否存在该mid数据
if (cursor.moveToFirst()==false) { //不存在该mid,属于正常新增数据,可以保存
MyApplication application = (MyApplication) getApplication(); //获取全局变量
if (i.getSender_id().equals(application.get("user_code"))) { //判断此条消息中,当前用户属于发送方还是接收方。理论上此处用户应该都是接收方,此处属于保护代码健壮性,防止异常数据导致的报错甚至崩溃。
i.setIshost("1");
} else {
i.setIshost("0");
}
i.save(); //litepal保存数据的方法
KLog.d("保存了" + i.getId());
}
cursor.close();
}
7、消息保存了,但是还没实时更新数据页面,这也是不行的,继续在刚刚后面写。
new Handler(Looper.getMainLooper()).post(new Runnable(){ //使用handle的消息机制,触发ui更新。
@Override
public void run() {
if (ActivityCollector.isActivityExist(ChatActivity.class)){ //判断聊天会话界面是否正在打开状态,是的话,就可以刷新页面了。
ChatActivity.initMsg(); //chatActicvity中的msglist添加逻辑
ChatActivity.adapter.notifyDataSetChanged(); //调用recycler适配器的刷新
}
//MyApplication application=(MyApplication)getApplication();
//initImList(String.valueOf(application.get("user_code")));
//try {
// ChatFragment.adapter.notifyDataSetChanged(); //此处是消息列表页消息通知刷新,消息列表页就是我们微信,QQ那个好友消息列表页,我们还没画这个界面,所以暂且不提,注释掉,后面再说。
//}catch (Exception e){
// e.printStackTrace();
//}
}
});
上面逻辑里面有一个类:ActivityCollector,这个是用来更新activity活动的工具类。平时可以用它来判断页面活动是否在线。原理就是一个activity集合,页面启动的时候,就调用一下add,销毁的时候调用remove。这样就收集到了每个activity的情况了。这部分代码也是参考网上其他大神的。
public class ActivityCollector {
//存放activity的列表
public static HashMap<Class<?>, Activity> activities = new LinkedHashMap<>();
public static void addActivity(Activity activity, Class<?> clz) {
activities.put(clz, activity);
}
@TargetApi(Build.VERSION_CODES.JELLY_BEAN_MR1)
public static <T extends Activity> boolean isActivityExist(Class<T> clz) {
boolean res;
Activity activity = getActivity(clz);
if (activity == null) {
res = false;
} else {
if (activity.isFinishing() || activity.isDestroyed()) {
res = false;
} else {
res = true;
}
}
return res;
}
public static <T extends Activity> T getActivity(Class<T> clazz) {
return (T) activities.get(clazz);
}
public static void removeActivity(Activity activity) {
if (activities.containsValue(activity)) {
activities.remove(activity.getClass());
}
}
public static void removeAllActivity() {
if (activities != null && activities.size() > 0) {
Set<Map.Entry<Class<?>, Activity>> sets = activities.entrySet();
for (Map.Entry<Class<?>, Activity> s : sets) {
if (!s.getValue().isFinishing()) {
s.getValue().finish();
}
}
}
activities.clear();
}
}
8、好了,这样消息就可以做到收到即刷新,且能存储到本地了。
二、打开聊天页面时,加载本地历史聊天记录
1、回到我们的chatActivity界面,onCreate中,当时我们留下了一个initMsg的方法,现在可以开始用上了。
public static void initMsg(){
//初始化历史聊天数据
imMsgContentList.clear(); //清空list中的数据,重新加载
MyApplication application=(MyApplication)getApplication();
initImList(String.valueOf(application.get("user_code")));
String chat_toUser ="u_00002"; //此处是当前会话的聊天对象用户code。此处应该由消息列表页传入,但是消息列表页还没做,此处先直接写死一个id
Cursor cursor= LitePal.findBySQL("select * from Im_msg_content where sender_id in(?,?) and recipient_id in(?,?) order by mid",chat_toUser,application.get("user_code"),chat_toUser,application.get("user_code"));
//获取当前用户code和对象用户code的所有聊天记录,按照mid排序
if (cursor.moveToFirst()==true){ //如果存在数据
do {
Im_msg_content i=new Im_msg_content();
i.setMid(Integer.valueOf(cursor.getString(cursor.getColumnIndex("mid"))));
i.setId(Integer.valueOf(cursor.getString(cursor.getColumnIndex("id"))));
i.setCid(cursor.getString(cursor.getColumnIndex("cid")));
i.setIshost(cursor.getString(cursor.getColumnIndex("ishost")));
i.setCreate_time(cursor.getString(cursor.getColumnIndex("create_time")));
i.setContent(cursor.getString(cursor.getColumnIndex("content")));
i.setMsg_type(Integer.valueOf(cursor.getString(cursor.getColumnIndex("msg_type"))));
i.setRecipient_id(cursor.getString(cursor.getColumnIndex("recipient_id")));
i.setSender_id(cursor.getString(cursor.getColumnIndex("sender_id")));
i.setCreate_time(cursor.getString(cursor.getColumnIndex("create_time")));
imMsgContentList.add(i); //获取数据信息添加到list中
}while (cursor.moveToNext());
}
cursor.close();
layoutManager.setStackFromEnd(true); //将recyclerView的界面滑动到最后一行
recyclerView.setLayoutManager(layoutManager);
adapter=new ChatAdapter(imMsgContentList); //适配器加载list数据
recyclerView.setAdapter(adapter); //更新界面
}
三、总结
本次我们完成了两个部分的内容:
1、socket消息实时接收时,完成消息的本次存储,以及页面的实时更新。
2、chatActivity页面在onCreate中,获取本地数据库数据,初始化历史聊天记录。
在操作数据库的时候使用到了郭神的litepal数据库框架,当然这个框架不是必须的,你也可以用其他数据库框架,或者直接用android系统的数据库操作方法,效果上没有区别。
下一章我们说一下如果加载离线消息记录。这个就涉及到服务端程序的改造了,所以我们单独开一篇幅讲。