1. API按照业务功能分类，但所有业务具有统一的调用风格。

2. API不包含方法实现，接口的实现对调用者隐藏。

在功能形式上，SDK需要提供以下类型的API：

1.1. 同步接口：在调用线程完成函数调用，并立即返回结果。

1.3. 可中断异步接口：在后台线程完成函数调用，可以添加回调函数，可以中断调用。

同一个业务下有多个API，按照调用的主动性，分为回调接口和功能接口，分别放在与业务一一对应的接口类Observer和Service中。例如：用户认证服务下的所有回调接口和功能接口都位于AuthServiceObserver和AuthService中。其中由用户主动调用来实现功能的功能接口在AuthService中，如登录、登出等；而用于注册回调的回调接口都在AuthServiceObserver中，如监听在线状态、监听数据同步等。

和用户服务的接口类AuthService和AuthServiceObserver一样，SDK也为其他的所有业务定义了接口类。所有接口类和实现类呈一一对应关系，可以方便地找到API对应的实现。

NimClient.getService方法同步返回一个Proxy对象。该对象的构造方式为懒加载，业务被调用的时候才构造对应实例。如图3.2所示。

生成Proxy对象基于Proxy.newProxyInstance方法，所有生成的Proxy对象都由专门的容器类来管理。以用户认证服务为例，第一次调用NimClient.getService(AuthService.class)获取用户认证服务的Proxy对象时，容器理类创建一个对应的Proxy对象并缓存。之后再次获取用户认证服务Proxy对象时，容器类将缓存直接返回。

执行完毕后，invoke方法根据同步异步特性以及返回值，来确定功能函数的返回结果。如果是同步函数，则直接返回结果；如果是异步函数，则根据业务需求返回InvocationFuture或者AbortableFuture。

执行事务这一环节还可以细分为回调接口的执行和功能接口的执行，如果是执行回调接口，则判断是否需要回调当前状态，如果是，则立即回调。

在调用可中断异步接口后，同步返回的是AbortableFuture实例。调用方可以直接调用abort方法中止执行。例如：调用了用于下载消息附件的downloadAttachment函数后，由于文件太大，网络状况不好等情况需要取消下载时，可以主动调用abort方法来终止。调用方式如图3.5所示。可中断异步接口对应的abort方法由SDK内部实现，调用者不需要关心其实现方式。

TransactionFuture回调的基本类型为RequestCallback，SDK在此基本类型中定义了onSuccess、onFailed和onException函数，分别用于在成功、失败和异常情况下根据执行结果的不同，回调到不同的函数。到此整个流程结束。