就算开发Android APP也得懂一点API接口开发

2024-02-03 04:10

本文主要是介绍就算开发Android APP也得懂一点API接口开发,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

code小生,一个专注 Android 领域的技术分享平台

作者:天兵公园
地址:https://www.jianshu.com/p/3252b0ba84ab
声明:本文已获 天兵公园 授权,转发等请联系原作者授权

很多开发 APP 的童鞋还只是会在 Android Studio 上写一些 Java 代码,对 API 接口,服务之类的知之甚少,也对 HTML/CSS/JS 一片朦胧,我觉得这是不好的,扩大知识面还是很有必要的,就算不能解决实际问题,有时候会提供一种解决问题的思路,比如某个产品老板要你一个月上线,怎么办呢。原生代码一行一行不知道要写到什么时候去了,公司 UI,前端,JS工程师一个都调动不起来。相反如果了解快速开发技巧,混合开发之类的技术,就能减少很多工作量了。

640

我一直喜欢用 .NET 作为后端接口开发语言,因为 .NET 开发效率确实非常高,标准库也非常成熟健全,不至于随便什么都要第三方的,用它主要看中的就是在开发效率和工业标准能够两者都能兼顾的特点,我觉得还行。

640

很多人一打开 Visual Studio 就已经啥了,创建项目都不知道点哪个,也不知道该创建什么类型的项目。是酱紫的,目前微软主要是推 .NET Core 和 .NET Framework 的,.NET Framework 是只能运行在 Windows 平台上的,虽然在 Linux 上有 Mono Runtime 支持 .NET 程序的运行,但是运行效率比 .NET 在 Windows 上的还是有些差距。.NET Core 是微软推出的下一代编程框架,在1.X 版本的时候,只能支持开发 Web 和 CLI 程序,不过如今可以开发 WPF 桌面程序了,虽然目前还只能在 Windows 上运行,但是谁知道以后会不会在 Linux 上也实现了桌面 GUI 环境呢。

.NET Core 很好,网上教程也很多,这个是灰常建议去学习的,不过我还是比较习惯用 ASP.NET MVC 和 WebForm 方式,当然拖控件是不可能拖控件了,这辈子都不可能拖控件,就是用用一般处理程序写写接口,才能维持得了生活的样子。

既然是服务接口,那就意味着没有什么界面,或者及少量的界面,用一般处理程序是坠吼的。

640

创建一个 ASP.NET Web 应用程序 (.NET Framework),然后选择空项目,下一步就可以了。

接下来需要创建一个 HttpHandler 的实现类,并稍作封装,让它成为我们接口的基础类,因为直接使用 HttpHandler 是不那么友好的,目前不需要了解为什么要这么做。

如果是为了考虑稳定性,不那么在乎性能,可以将整个 ProcessRequest 都用 Try Catch 包裹,避免因为接口中的错误,导致 APP 未能处理正确的返回而导致闪退,虽然这种办法很挫,但是我很喜欢用。

 public void ProcessRequest(HttpContext context)
 
{

     if (context.Request.RequestType != "POST")
     {
         context.Response.StatusCode = 405;
         return;
     }

     AllowCrossDomain = true;
     TryExecute.Execute(() =>
     {
         Context = context;
         ProcessUserRequest();
     }, error =>
      {
          bool processed = false;

          if (error is SilverStarAmsException)
          {
              var serror = error as SilverStarAmsException;
              if (serror != null)
              {
                  ResponseAsErrorJson(serror.ErrorCode, serror.Message);
                  processed = true;
              }
          }

          if (!processed)
          {
              ResponseAsErrorJson(-11"process api request error");
          }
      });
 }

其次,API 接口或许会被小程序或其它服务用到,我们对其做一个跨域的测试,在 Header 头输出对应的消息,客户端即可实现跨域请求,这时的客户端通常是浏览器,因为浏览器为了安全性会设置同源策略,如果接口不支持跨域,接口就不能被使用。

在 ASP.NET 里设置 Header 有很多种方法,为了适应 IIS 的经典和集成模式,以及或许有其他 Web 容器的支持,我都会写一遍,哪种支持就是用哪种,然后就有了下面的奇怪的代码:

protected void AppenHeader(string key, string value)
{

    bool done = false;

    try
    {
        Context.Response.AppendHeader(key, value);
        done = true;
    }
    catch
    {

    }

    if (!done)
    {
        try
        {
            Context.Response.Headers.Add(key, value);
            done = true;
        }
        catch
        {

        }
    }

    if (!done)
    {
        try
        {
            Context.Response.AddHeader(key, value);
            done = true;
        }
        catch
        {

        }
    }
}

对于 APP 接口来说,通常是不会或者对于安全性很低的情况下才会用到 GET 请求,当然合服 Restful 规范的可能也会用的多,比如订单的增删改查:

PUT /api/order
DELETE /api/order/12
PATCH /api/order/12
GET /api/order/12

如果觉得不需要这么多的 HTTP 谓词,只用 POST 也是可以的。

640

我上家公司的 APP 接口全部是这种实现,好吧,其实都是我实现的,虽然只有数十万用户,但是目前来看,这种架构还能支撑,而且这也不是性能的瓶颈,只能说在可维护性上断然没有 Restful 方式的好。

640

接下来我需要建立一个数据库,继续是 .NET 当然配合 MSSQL 是坠吼的了,设计数据库和表此处略去不表,ORM 我是用 EntityFramework 6.x 。

以一个简单例子,在数据库中创建了一个 Category 表,表示文章或者某种物体的分类,现在要在 APP 里获取 Category 列表,每页显示 20 条数据,或者由 APP 指定参数。

创建一个一般处理程序,GetCategory.ashx ,继承刚才上面的自定义的 Handler,重写 ProcessUserRequest 接口。

声明三个参数,表示总页数,当前页码,分页大小:

  int page, pageSize, totalPage;

对于数据库的访问,其实超简单,看我怎么查出所有数据:

totalPage = (int)(Math.Ceiling((double)all.Count() / pageSize));

if (page > totalPage) page = totalPage;
if (page < 1) page = 1;

var data = all.OrderByDescending(s => s.CategoryLastChangeDate).Skip((page - 1) * pageSize).Take(pageSize).ToList();

然后输出查询出当前页的数据,并输出到 JSON,对象转为 JSON ,并不能保证是 100% 成功的,对于 APP 的接口服务来说,稳定性最重要,就算是接口出错,也必须得返回出错代码,所以前面的 Handler 的子类有一个超大的 Try ,对于 JSON 输出,也应如此。

protected void ResponseAsJson(object data)
{
    string json = "[]";

    TryExecute.Execute(() =>
    {
        json = Newtonsoft.Json.JsonConvert.SerializeObject(data);

    }, error =>
    {
        json = GetGenericErrorJson(-10"serialize data error");
    });

    ResponseAsJsonString(json);
}

完整的接口代码如下:

/// <summary>
/// GetCategory 的摘要说明
/// </summary>
public class GetCategory : Core.SilverCoreHandlerBase
{

    public override void ProcessUserRequest()
    
{
        base.ProcessUserRequest();

        int page, pageSize, totalPage;

        page = (Context.Request["page"] + "").AsInt(0);
        pageSize = (Context.Request["page_size"] + "").AsInt(0);

        if (page < 1) page = 1;
        if (pageSize < 1 || pageSize > 50) pageSize = 50;

        var db = new Data.SilverStarDB();
        var all = db.KoteiAssetCategory;

        totalPage = (int)(Math.Ceiling((double)all.Count() / pageSize));

        if (page > totalPage) page = totalPage;
        if (page < 1) page = 1;

        var data = all.OrderByDescending(s => s.CategoryLastChangeDate).Skip((page - 1) * pageSize).Take(pageSize).ToList();
        ResponseAsJson(new { page = page, total_page = totalPage, data = data });

    }
}

F5 执行看看,会提示不支持的谓词,当然了,只支持 POST 的啊!可以用 POSTMAN 工具调试。

640

好了,看看最终输出的 JSON 结果:

640

如此,在 APP 中使用相关的 HTTP 库,就可以完成接口的调用了,敲你吗简单!

APP开发

碎阅:一款基于 douban 及 ONE API 开发的资讯类 App

使用 Charles 抓取 app 数据包

Android 新手如何学习开发一款 app?

640


这篇关于就算开发Android APP也得懂一点API接口开发的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/672948

相关文章

Android中Dialog的使用详解

《Android中Dialog的使用详解》Dialog(对话框)是Android中常用的UI组件,用于临时显示重要信息或获取用户输入,本文给大家介绍Android中Dialog的使用,感兴趣的朋友一起... 目录android中Dialog的使用详解1. 基本Dialog类型1.1 AlertDialog(

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis

Python基于wxPython和FFmpeg开发一个视频标签工具

《Python基于wxPython和FFmpeg开发一个视频标签工具》在当今数字媒体时代,视频内容的管理和标记变得越来越重要,无论是研究人员需要对实验视频进行时间点标记,还是个人用户希望对家庭视频进行... 目录引言1. 应用概述2. 技术栈分析2.1 核心库和模块2.2 wxpython作为GUI选择的优

go中空接口的具体使用

《go中空接口的具体使用》空接口是一种特殊的接口类型,它不包含任何方法,本文主要介绍了go中空接口的具体使用,具有一定的参考价值,感兴趣的可以了解一下... 目录接口-空接口1. 什么是空接口?2. 如何使用空接口?第一,第二,第三,3. 空接口几个要注意的坑坑1:坑2:坑3:接口-空接口1. 什么是空接

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》:本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark

Android Kotlin 高阶函数详解及其在协程中的应用小结

《AndroidKotlin高阶函数详解及其在协程中的应用小结》高阶函数是Kotlin中的一个重要特性,它能够将函数作为一等公民(First-ClassCitizen),使得代码更加简洁、灵活和可... 目录1. 引言2. 什么是高阶函数?3. 高阶函数的基础用法3.1 传递函数作为参数3.2 Lambda

利用Go语言开发文件操作工具轻松处理所有文件

《利用Go语言开发文件操作工具轻松处理所有文件》在后端开发中,文件操作是一个非常常见但又容易出错的场景,本文小编要向大家介绍一个强大的Go语言文件操作工具库,它能帮你轻松处理各种文件操作场景... 目录为什么需要这个工具?核心功能详解1. 文件/目录存javascript在性检查2. 批量创建目录3. 文件

Android自定义Scrollbar的两种实现方式

《Android自定义Scrollbar的两种实现方式》本文介绍两种实现自定义滚动条的方法,分别通过ItemDecoration方案和独立View方案实现滚动条定制化,文章通过代码示例讲解的非常详细,... 目录方案一:ItemDecoration实现(推荐用于RecyclerView)实现原理完整代码实现

Android App安装列表获取方法(实践方案)

《AndroidApp安装列表获取方法(实践方案)》文章介绍了Android11及以上版本获取应用列表的方案调整,包括权限配置、白名单配置和action配置三种方式,并提供了相应的Java和Kotl... 目录前言实现方案         方案概述一、 androidManifest 三种配置方式