背景#
APP 接入部网络货运信息交互平台，这里记录一下接入想法和过程。
实现#
iOS SDK 提供的方法，共有下面 6 个
- init
- start
- send
- pause
- restart
- stop
看起来很简单，但是需要考虑 SDK 某个方法可能会失败，而且可能会有同一个司机多个托运单、或者同一托运单分段多个司机运输以及托运过程中换车、司机运输中换手机等场景，想要持续记录位置信息，完成完整的一个单据链路就不那么容易了。
而这些场景的处理，需要服务端的协助，但是服务端没有和部网络货运信息平台直接交互的接口，无法直接从货运信息平台读取状态和数据，所以处理就显得麻烦了。
我们的设想是，服务端兜底处理异常，所以，首先要让服务端知道当前处理的单据和步骤，故而需要一个记录接口，每次执行 SDK 的方法后，成功或失败都同步给服务端。
为了避免出现其他手机或其他用户或后台手动关闭单子的情况，需要服务端提供另一个查询是否有待结束运单的接口，同样，这个接口在每次执行 SDK 的方法后，都要调用，用于获取是否有待关闭的运单。
而还有一种情况，即用户开始运单后，APP 被杀掉了再次打开时，这时候应该执行 SDK 的什么方法？或者司机中途换了另一个手机登陆了账号，这时候原手机上再次打开应该执行什么方法？新手机上应该执行什么方法？所以需要一个查询接口，用于这种情况下查询待执行的步骤。
但是问题来了，同一个司机，由于顺路或者车型大的原因，可能同时有多个运单，而每个运单的间隔发送时间不一定相同？所以如何同时开启多个 timer，不会混乱，且又能保证运单结束后，关闭对应的 timer？通过运单号和分单号作为 key，创建 timer 封装到单独的 Model 中，model 作为 value，存储在字典中。每次要创建 timer 前，根据运单号和分单号查询对应 timer 是否存在，存在则不重复创建；不存在则创建。当执行了 SDK 的 Stop 或 Pause 方法后，同样的方法获取到对应 timer，然后停止这个 timer。
但在实际中，遇到了 SDK 由于某种原因 Stop 失败，实际上这个运单已经结束的情况；还遇到了 SDK 执行方法成功，但是保存状态到服务端时失败的情况。这些异常情况，单独根据同步记录表是没有办法处理的，只能从业务表中获取对应状态后，再返回对应要执行的方法。