Android新手（懂Java/OOP）：如何开发与PHP服务端交互的App？

Hey there! 作为有一学期Java基础的Android新手，你已经有不错的起步资本啦～咱们一步步拆解这个任务，保证你能稳稳上手：

要调用老师的PHP脚本，先得搞明白几个核心信息，不然写代码都是瞎忙活：

• 先找老师要接口的完整URL（就是你的App要发请求的网络地址）
• 确认请求方式：是GET还是POST？如果是查询类请求，大概率是GET，有没有需要传的参数？比如查询关键词、分页页码这类
• 一定要让老师给个JSON返回示例，比如：

  {
    "code": 200,
    "data": [
      {"id": 1, "name": "张三", "course": "Android开发"},
      {"id": 2, "name": "李四", "course": "Java基础"}
    ],
    "total": 400000
  }
  

  这个示例是你后续解析JSON的核心依据，绝对不能少！

作为新手，首推Retrofit——它是目前Android生态里最流行、封装最友好的网络请求库，结合Gson解析JSON会特别省心。当然Volley也可以，但Retrofit更适合后续扩展。

• 首先在你的build.gradle(Module级)里添加依赖，记得同步项目：

  implementation 'com.squareup.retrofit2:retrofit:2.9.0'
  implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
  

• 然后创建一个接口类，定义你的请求方法，比如如果是带关键词的分页GET请求：

  public interface TeacherApiService {
      @GET("teacher_query_script.php")
      Call<QueryResponse> getQueryResults(@Query("keyword") String keyword, @Query("page") int page, @Query("pageSize") int pageSize);
  }
  

• 这里的QueryResponse是你根据JSON示例创建的实体类，推荐用Android Studio的GsonFormat插件自动生成，能省超多手动写字段的时间。

40万条数据绝对不能一次性加载，不然App直接崩溃给你看！必须用分页加载（或者上拉加载更多）：

• 先和老师沟通，让PHP接口支持分页参数，比如page（当前页码）和pageSize（每页加载的条数，比如每页20条就很合适）
• 用RecyclerView来展示数据，它比传统的ListView效率高太多，专门适配大数据列表场景
• 给RecyclerView加滚动监听，当用户滚动到列表最后一项时，自动发起下一页的请求

• 用Retrofit发起请求后，在回调里拿到返回的QueryResponse对象，把里面的data列表取出来
• 给RecyclerView写一个Adapter和ViewHolder，把列表里的每一条数据绑定到对应的布局上（比如每个列表项显示姓名、课程这些内容）
• 划重点：Android规定网络请求不能在主线程执行，Retrofit默认会在子线程处理请求，回调会自动切回主线程，刚好适合你更新UI！

• 网络请求难免失败（比如没网、接口报错），一定要加错误处理，比如弹出Toast提示用户"网络请求失败，请稍后重试"
• 加载数据的时候显示一个加载动画（比如ProgressBar），加载完成后再隐藏
• 如果某一页没有数据，或者总数据为空，要显示一个友好的空页面，别让用户对着空白发呆

在你的AndroidManifest.xml里加上网络权限，不然App连不上网：

<uses-permission android:name="android.permission.INTERNET" />

如果老师的接口是http而不是https（Android 9及以上默认禁止明文网络请求），还需要在res/xml下创建network_security_config.xml，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

然后在Manifest的application标签里加上：

android:networkSecurityConfig="@xml/network_security_config"

• 先从简单的测试开始：写一个只请求第一页数据的页面，能成功解析并展示后，再去实现分页加载
• 多利用Logcat打印日志，比如在Retrofit的回调里加Log.d("QueryTest", response.body().toString())，方便调试看返回的数据对不对
• 如果实体类的字段名和JSON里的键名不一样，用@SerializedName注解指定映射关系，比如JSON里是user_name，实体类里是userName，就写：@SerializedName("user_name") private String userName;

内容的提问来源于stack exchange，提问作者SSJ998