博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
打造自己的 APP「冰与火百科」(二):接口、索引页
阅读量:7064 次
发布时间:2019-06-28

本文共 6456 字,大约阅读时间需要 21 分钟。

开始「冰与火百科」开发之旅!

网络数据

先说一下我的接口是怎么来的。

存放数据

首先确定自己需要一些什么数据,在满足自己要求的情况下越简单越好。对每个详情页面,我需要一张图片和一个 html 显示描述就够了。以奶德为例,在服务器的对应目录下,就会有 Eddard_Stark.png 和 Eddard_Stark.html 这两个文件。

这一步其实是整个项目最麻烦的地方。图片还好,但收集整理描述的内容真的要非常有耐心,至今才造了十几条数据。

创建数据集合

我需要两个实体类。一个是分类,也就是到时 TabLayout 中的 Tab,另一个就是内容。对应的要生成两个 json 文件。

创建一个 java 项目,添加 Gson 依赖,建立两个要转换 json 的集合:

private static List
tabList = new ArrayList<>();private static List
contentList = new ArrayList<>();复制代码

再次以奶德为例,往里面添加数据:

tabList.add(new TabDTO(10100,"person","Stark","史塔克"));复制代码
String starkUrl = "person/Stark/";contentList.add(new ContentDTO(        "Eddard_Stark",        "person",        "Stark",        starkUrl + "Eddard_Stark.png",        "艾德·史塔克",        "临冬城公爵、北境守护",        starkUrl + "Eddard_Stark.html"));复制代码

生成 json 文件

完了输出为 json 文件就好了,以 content 为例:

Gson gson = new Gson();String jsonString = gson.toJson(contentList);File contentJsonFile = new File("../IceAndFireServer/content.json");try {    OutputStreamWriter osw = new OutputStreamWriter(            new FileOutputStream(contentJsonFile), "UTF-8");    BufferedWriter bw = new BufferedWriter(osw);    bw.write(jsonString, 0, jsonString.length());    bw.flush();    bw.close();} catch (IOException e) {    e.printStackTrace();}复制代码

然后将数据上传到网络就好了,json 文件所在的网络地址就是你的接口了。刚开始我上传到了 GitHub,但发现经常会发生灵异事件,导致数据无法访问或者速度超慢,后来又上传到了九牛云。

这部分内容大家看一下就好了,毕竟不是常规的做法。有兴趣的可以到,数据和代码都在里面了。

APP主题色

下面终于来到我们的 Android 项目了。

创建 Android 项目后,第一反应是主题色得改一改。

在官方 Material Design 的色板里面,我选用了这一套:

对应的,color 文件的主题色值修改如下:

#607d8b
#546e7a
#40c4ff
复制代码

索引页

我也学着别的 APP,做一个索引页 IndexActivity。就简单展示一句「挖了蘑菇立死」,噢不对,展示一句「Valar Morghulis」就好了,像这样:

加入一点简单的动画,然后还能做一些耗时的启动操作。

DataBinding

我会比较在意代码的简洁性,在实现同样功能的情况下代码越少越好,而且排版一定要看上去舒服,缩进要少,甚至不允许代码里面有警告。

DataBinding 是一个可以增加代码简洁性的东西。这里以索引页为例,简单介绍一下它最简单的一个应用,代替 findViewByid。

配置

在对应 Module 的 build.grade 里配置:

android {    ....    dataBinding {        enabled = true    }}复制代码

布局

在需要绑定的布局文件里,最外层增加一个 layout 标签,比如这里的 activity_index.xml :

复制代码

使用

创建一个成员变量:

private ActivityIndexBinding binding;复制代码

注意,这里的变量类型是和布局文件相关的,比如 ActivityIndexBinding 对应 activity_index。

然后将原来 setContentView 的地方修改为:

binding = DataBindingUtil.setContentView(this, R.layout.activity_index);复制代码

当我要使用布局里的 TextView 的时候,直接用 binding.tvIndex 就可以了。tvIndex 这个名字是和布局里的 id:tv_title 相对应的。

DataBinding 的一些更高级的用法这里就不赘述了,网上的教程很多,大家可以多搜索了解一下。

动画

为了让索引页的字更生动,我打算加一个渐变放大的动画效果。

xml

我这里用的是 View Animation(视图动画),动画过程是通过 xml 文件定义的。在 res/anim 文件夹下新建一个 xml 文件,代码如下:

复制代码

这个的意思很好理解,就是用 1.3 秒的时间,控件大小从 95% 渐变到 100%,透明度从 0 渐变到10%。

使用

执行动画的代码也很简单,大家直接看吧:

Animation animation = AnimationUtils        .loadAnimation(this, R.anim.anim_valar_morghulis);animation.setAnimationListener(new AnimationListener() {    @Override    public void onAnimationStart(Animation animation) {    }    @Override    public void onAnimationEnd(Animation animation) {        SystemClock.sleep(500);        animationComplete = true;        goMainPage();    }    @Override    public void onAnimationRepeat(Animation animation) {    }});SystemClock.sleep(200);binding.tvIndex.startAnimation(animation);复制代码

为了让用户能看清动画,我在里面加入了一些停顿。经过我自己的多次试验,最终定下的这个停顿时常,我认为长度是在能看清动画的情况下,又不会长到让人感到厌烦的,效果如下:

耗时操作

前面说到,在索引页可以做一些耗时的操作。动画的执行总共有两秒的时间,用户的时间是宝贵的,要是在这两秒里面什么都不做就太浪费了。

最耗时的操作,应该是调接口了。

其实刚开始我是进入到首页才调接口的,进入不同的页面获取不同的数据。但这样会有一个问题,由于我没有后台,只有两个假接口,所以搜索功能就无法实现了。

所以现在改为,在索引页获取到所有数据并保存起来,在不同分类页面下通过筛选展示数据,这样搜索也可以实现了。

下面就简单讲一下目前比较流行的两个框架 Retrofit 2 和 Realm,来完成数据的获取和保存。

Retrofit 2

Retrofit 的厉害之处我就不多说了,网上的教程很多的,我只讲最最简单的用法。

配置

在 Module 的 build.grade 里添加依赖:

compile "com.squareup.retrofit2:retrofit:${RETROFIT_VERSION}"compile "com.squareup.retrofit2:converter-scalars:${RETROFIT_VERSION}"compile "com.squareup.retrofit2:converter-gson:${RETROFIT_VERSION}"复制代码

目前最新版是 2.3.0,大家可以自行替换。

这里面 converter-scalars 是添加 String 类型的返回,converter-gson 是添加 Gson 的支持(返回实体类)。

接口定义

新建一个接口文件(interface),用来统一管理所有要调用的接口(url),我暂时只有两个接口,再留一个通用的 Get 请求备用:

public interface RequestServes {    @GET("{url}")    Call
get(@Path("url") String url); @GET("tab.json") Call
> getTab(); @GET("content.json") Call
> getContent();}复制代码

注解 @GET 后面的内容就是要请求的接口,这里不用写基础域名(BaseUrl)。

初始化

需要通过 Retrofit.Builder 初始化 Retrofit,调用 baseUrl 设置基础域名:

Retrofit retrofit = new Retrofit.Builder()        .baseUrl(ServerAPI.BASE_URL)        //增加返回值为String的支持        .addConverterFactory(ScalarsConverterFactory.create())        //增加返回值为实体类的支持        .addConverterFactory(GsonConverterFactory.create())        .build();requestServes = retrofit.create(RequestServes.class);复制代码

需要注意的是,BaseUrl 必须以斜杠「/」结尾,否则会报错。

考虑到可能多个页面都需要调用接口,可以把这段代码放在 BaseActivity 里。

使用

用起来超简单:

Call
> call = requestServes.getTab();call.enqueue(new Callback
>() { @Override public void onResponse(@NonNull Call
> call, @NonNull retrofit2.Response
> response) { List
tabList = response.body(); //... goMainPage(); } @Override public void onFailure(@NonNull Call
> call, @NonNull Throwable t) { netError(); }});复制代码

请求失败的时候,我会弹吐司提醒,并且让页面可点击重试。

Realm

Realm 是 SQLite 的替代者,它更快速、更易用。下面看看 Realm 的简单使用。

配置

修改 Project 下的 build.gradle :

buildscript {    repositories {        jcenter()    }    dependencies {        classpath 'com.android.tools.build:gradle:2.3.3'        classpath "io.realm:realm-gradle-plugin:3.5.0"        // NOTE: Do not place your application dependencies here; they belong        // in the individual module build.gradle files    }}复制代码

目前最新版是 3.5.0。然后再到 Module 的 build.gradle,添加:

apply plugin: 'realm-android'复制代码

配置完毕

初始化

在使用 Realm 之前,必须先调用:

Realm.init(this);复制代码

获取 Realm 实例有以下两种方法:

Realm mRealm = Realm.getDefaultInstance();复制代码

这里有个小细节。如果实体类的字段发生了改变,这里是会报错的。我的做法比较粗暴,清空数据库后再重新获取:

try {    mRealm = Realm.getDefaultInstance();} catch (RuntimeException e) {    Realm.deleteRealm(Realm.getDefaultConfiguration());    mRealm = Realm.getDefaultInstance();}复制代码

保存

让需要保存下来的实体类继承 RealmObject,然后就可以使用以下代码保存了:

mRealm.beginTransaction();mRealm.copyToRealm(list);mRealm.commitTransaction();复制代码

查询

查询也很简单,就一句代码的事:

List list = mRealm.where(Data.class).findAll();复制代码

复杂查询这里就不多说了。

需要注意的是,如果要对查询的结果进行修改或删除等操作,则必须要在 transaction 里完成,修改的结果会同步到数据库。比如,我想对上面查询到的第一个元素进行修改:

Data data = list.get(0)mRealm.beginTransaction()mRealm.copyFromRealm(data)data.num = 666mRealm.commitTransaction()复制代码

小结

就先到这吧,一个索引页都能扯这么多。

其实我没什么想总结的,我只想提醒一下:GOT Session 7 !!!

转载地址:http://wuill.baihongyu.com/

你可能感兴趣的文章
RvmTranslator 3.0 is released
查看>>
Mac禁用ipv6
查看>>
10 个原则让动画带你飞
查看>>
在线网络安全体验项目真能解决安全技术人才短缺吗?
查看>>
新连接?新商业 一场关于商业变革的活动正在进行
查看>>
新奇二合一固态硬盘盒上市
查看>>
中国人工智能学会通讯——2016机器智能前沿论坛召开
查看>>
Radware荣获ICSA实验室“卓越信息安全测试奖”
查看>>
带你认识DaoCloud这家做Docker的创业公司!
查看>>
迪普科技为上海银视通打造“下一代”数据中心
查看>>
Salesforce:到2021年人工智能将创造80万工作岗位和1.1亿美元收入
查看>>
把云计算引进到SOA的两个步骤
查看>>
Web 开发者需要知道的 12 个终端命令
查看>>
《社交网站界面设计(原书第2版)》——3.16 欢迎界面
查看>>
终端计算、集中计算、云计算优缺点的比较
查看>>
保险领域网络安全形势最严峻
查看>>
金融创新推动资产管理公司发展
查看>>
《精通Spring MVC 4》——1.7 错误与转码配置
查看>>
《Spark大数据分析:核心概念、技术及实践》一1.7 总结
查看>>
警惕一大波银行类木马正在靠近,新型BankBot木马解析
查看>>