(Android) Diycode SDK Beta 公测版发布啦

· sloop · Created at · Last by kkmmi68 Replied at · 2472 hits
1644

项目简介

该项目是对 diycode api 的再次封装,从标准的 http 接口转化为用户可以直接调用的接口,在封装过程中会屏蔽掉部分细节,让其更加容易使用。

例如,让身份认证机制的透明化,用户正常登录后可以直接调用 API ,不需要为每一次请求都手动添加认证信息和捕获异常状态,假如用户操作了没有权限的内容,会返回错误信息,程序可以根据错误信息进一步的处理。

目前 SDK 是 Beta 公测版,可能某些接口是有问题的,如果使用过程中遇到了问题,可以提交 Issues 反馈问题详情,以方便我在后续版本中修复。

更多信息请移步: GcsSloop/diycode-sdk

创作动机

Diycode 社区、项目、News、sites 的 API 发布了

diycode 的 api 发布已经很长时间了,想必有很多想做客户端练手的小伙伴看到它复杂的接口后都打了退堂鼓,毕竟相对于干货集中营这类的开放 api 来说,diycode api 的使用难度是其数倍之多。

为了让小伙伴们能更快速,更方便的开发出一个属于自己的 app,我才特地将数据请求这一层单独摘出来做了这个开源库,使用它,会让复杂的逻辑瞬间变的简单起来。

不信的话看下面,不到 10 行代码就能完成一次数据的请求处理,并且是用 EventBus 异步返回的,完全不用担心各种回调和线程问题。

使用方式

使用方式大概有 3 步,非常简单。

Step 1. 初始化 Diycode

初始化过程中使用的 应用ID 和 私钥 请到 Diycode 上自行注册获得。 点击此处注册应用

// (上下文,应用ID,私钥)
Diycode.init(context, client_id, client_secret);

初始化过程只需要执行一次,建议将该初始化的调用位置放在 Application 的 onCreate 方法中

Step 2. 获取实例

Diycode mDiycode = Diycode.getSingleInstance();

理论上只要你对其进行了初始化,就可以在任意的位置获取到 Diycode 的实例,并使用该实例进行数据请求。

Step 3. 请求数据并接收返回的内容

mDiycode.getTopic(topic.getId()); // 发出请求

// 接收数据
@Subscribe(threadMode = ThreadMode.MAIN)
public void onTopicDetail(GetTopicEvent event) {
    if (event.isOk()) {
        TopicContent topicContent = event.getBean();
    }
}

所有返回的 Event 命名都是很有规律的,一律为 “方法名+Event” ,例如:

  • getTopic => GetTopicEvent
  • login => LoginEvent

如果不知道返回的 Event 类型,也可以去查看注释中的内容,例如 getTopic 的注释,其中 @see 就是返回的 Event 类型:

/**
 * 获取 topic 内容
 *
 * @param id topic 的 id
 * @see GetTopicEvent <= 返回的 Event 类型
 */

当然了,使用 EventBus 的时候不要忘记注册,不然是接收不到事件的。

@Override
protected void onStart() {
    super.onStart();
    EventBus.getDefault().register(this);
}

@Override
protected void onStop() {
    super.onStop();
    EventBus.getDefault().unregister(this);
}

如果想要了解更多的 API 的话请查看 在线文档

Demo 效果

这是我开发的一个尚未完成的客户端,使用了这个 sdk 后,每一个 Activity(Fragment) 的代码量不超过 300 行就能完成所有功能。

如何添加

如何添加请到 GitHub 上查看最新版本,此处不再更新。

常见问题

1. 异常状况的处理

在 SDK 设计过程中已经已经考虑到了可能会出现的一些意外情况,例如,网络差,数据请求失败,没有权限等等。

当出现异常情况时,结果依旧按照之前的方式返回,当出现意外状况时 eveng.isOk() 会被置为 false 状态,此时你可以使用 event.getCode() 来获取错误状态码,通过 event.getCodeDescribe() 来获取对错误状态码的描述。可以根据这些信息进行下一步的处理。

2. 如何处理重复请求

由于设计中使用了 EventBus 作为传递的媒介,在某些特殊的条件下很可能会出现如下的情况,在用户网络状态不好的情况下,用户重复的调用加载方法,发出多次重复请求,这些请求结果可能会在网络变好之后在很短的时间内一同返回,如何判断处理这些数据呢?

为例应对这种情况,我对所有的请求都进行了唯一的编号,可以根据编号进行处理。首先,在发出请求的时候可以获得一个编号:

String uuid = mDiycode.getTopic(topic.getId());

在数据返回的时候会附加上这一个编号,可以使用 getUUID 获得:

@Subscribe(threadMode = ThreadMode.MAIN)
public void onTopicDetail(GetTopicEvent event) {
    String uuid = event.getUUID();
}

可以通过对比这两个编号来确定是哪次请求。

例如:用户多次调用上拉加载函数,我们只想保留第一次请求成功的结果,并且忽略后续重复的请求,就可以将请求同一区间数据的 uuid 全部记录下来,当返回结果属于这些 uuid 并且成功时,更新状态,并且忽略后续请求结果。

3. Diycode SDK 有缓存机制吗

就目前而言是没有的,Diycode SDK 仅仅是一个 api 的再次封装,如果是需要缓存建议放在上层应用,或者重新抽象一个数据层出来。

之前有考虑过载 Diycode 中添加数据缓存机制,但是由于不清楚上层应用的状态,随意的使用缓存机制反而可能会导致数据与服务器不同步,从而引发一些异常状态,所以推荐将缓存放在上层应用中,该 SDK 只做一些简单的数据请求。

作者简介

作者微博: @GcsSloop

个人网站: http://www.gcssloop.com

版权信息

Copyright (c) 2017 GcsSloop

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
共收到 6 条回复
96
troy · #1 ·

棒棒哒

96
mm685265 · #2 ·

臺灣找小姐+賴:211861 大奶大粉嫩可看照.洗澡愛愛按摩口交全套服務
好吃的東西當然要一起分享~ 小弟昨天趁休假找茶姊約了個正妹 果然幫我安排的素質很讚 妹妹叫童童 目前還是個大學生 22歲 身材臉蛋都是我的菜 身高160 甜美可愛 美腿哦 罩杯Dcup 真材實料 吸起來彈性十足 妹妹雖然年紀小 但是性欲很強 喜歡在床上纏著我的腰扭屁股 真的是視覺上肉體上的100分滿足!!全程真的很主動 很會挑逗 皮膚也很棒很白嫩 全身鮑魚都可以隨意摸哦 全身都很敏感 妹妹也很緊 還會夾我的小弟 插起來水水很多 很有感覺 超級讚!!! 真的是個很淫蕩的小女生 讓你有回味無窮的感覺 喜歡的可以嘗試看看 加賴:211861 找童童可看照片 她家還要其他的姊妹 類型很多 加賴說是阿傑介紹 有好康喔!!!

96
ll211861 · #3 ·

@.全套服務(特別服務可喬)
@.看照約妹~自己看到妹妹滿意現金消費維護客人消費權利~
台灣外送茶可可外送茶【賴211861】【賴211861】專營臺灣本土妹 #情愛全台灣外送茶看照約妹叫小姐 #台灣外送茶 全省外送茶外約援交茶訊魚訊匯總 line茶訊-台灣最大的茶訊、魚訊、外送茶外約網 台灣外送茶價位怎麼算?台灣找小姐上門服務看照約妹會遇雷嗎 台灣找小姐價位多少?看照約妹之台灣酒店找女人上門服務外送茶 援交、魚訊、茶訊、外送茶【賴211861】【賴211861】按摩網站導航 什麼是外送茶- 2020台灣外送茶小貼士 感?茶友的外送茶攻略投稿 - 悅人外送茶 台北外送茶– 茶莊外送茶全套外約叫小姐台灣網友最推薦 外送茶|台北曖昧外送茶即時外約 【賴211861】【賴211861】
台北外送茶彙整- 十八摸外約茶莊-全套-喝茶 【台北推薦】評價最好的5家外送茶!茶莊、價格、外約、到府服務 對味外送茶 讓你有戀愛感覺 台中外約- 叫小姐、外送茶迅速又安全,中部打炮首選- 天使心外約 維珍妮台中茶莊,台中叫小姐及台中外約! - COCO4.5K外送茶 台中外送茶彙整- 十八摸外約茶莊-全套-喝茶 台中女生名單– 糖果外送茶【看照約妹】 台中外送茶 - 激情娛樂外送茶莊 台中外送茶 台中外約學生妹台中一夜情 高雄24小時外約彙整- 十八摸外約茶莊-全套-喝茶 高雄外送茶有著2020茶莊界最好的美眉! 想在高雄叫小姐嗎 #高雄外送茶#高雄看照?妹#高雄叫小姐 高雄外送茶- 最夯E杯大奶妹,擁有傲人的上圍,讓你體驗波濤洶湧 老王-吃魚喝茶術語大全教學 所謂的喝茶就是援交或性交易【賴211861】【賴211861】小資族喝茶吃魚如何少花冤枉錢 萬維論壇 台灣喝茶吃魚可馨蘿莉幼齒學生妹甜美可愛清純粉 [討論] 關於吃魚喝茶心得分享的人- 看板sex - PTT網頁版 台灣喝茶吃魚可馨蘿莉幼齒學生妹甜美可愛清純粉 [討論] 關於吃魚喝茶心得分享的人- 看板sex - PTT網頁版 大台灣出差旅遊找小姐喝茶吃魚喝茶吃魚找小妹貼心 中文色情??,成人??,自拍,偷拍,成人??翻?? 情色網站大全- 成人網站- 色情網 成人貼圖區 - 一世發論壇 全球十大熱門成人網站排名【211861】【賴211861】線上直播網紅模式將成主流 台灣論壇,伊莉論壇區,維克斯論壇,論壇成人版,微風論壇--奇雅網 成人園地 SOGO論壇 夜遊討論- 伊莉討論區 水蜜桃外送茶拉莉塔外送茶海盜外送茶佳佳外送茶妮娜外送茶志玲外送茶小妖精外送茶小騷騷外送茶#台北夜遊論壇 夜遊討論~ 茶魚飯後閒聊版-魚訊交流歐洲論壇神奇論壇東歐個工 小司機帶路西斯板Dcard 夜遊論壇 - 新竹找茶,新竹找魚茶, 桃園中壢OL兼職, LINE 【心得】 夜遊論壇,按摩論壇【休閒娛樂】 魚訊與個工評價討論-歡樂論壇 夜遊討論區-貓都論壇 傑克論壇按摩舒壓理容 武士成人娛樂論壇娛樂網男人碼頭/夜遊討論一世一夜 外約學生妹約茶高檔正妹麻豆藝人小模空姐援交妹學生處女台灣蘿莉送茶吃魚喝茶人妻女優泰洗處女敢玩3P雙飛無套全場3K起【有圖】【賴211861】【賴211861】 #高雄外送茶,#高雄約炮,#高雄外約,#高雄吃魚喝茶,#高雄找小姐,#高雄全套,#高雄茶莊,#高雄茶訊【賴211861】【賴211861】 #高雄約炮神器,#高雄一夜情,#高雄炮友,#高雄買春,#高雄叫雞,#高雄嫖妓,台中外送茶 台中學生 台中一夜情 台中找小姐 台中全套茶旅館愛愛 台中單親媽媽 #高雄找炮友#高雄外送茶 #高雄外送茶,#高雄約炮,#高雄外約 #台北外約 #台北外送茶 #台北買春 #台北叫小姐 #台北叫全套 #台北按摩 #台北半套 #台北找援交妹 #台北茶莊 #台北上門按摩 #台北找茶 #台北外約小姐 #台北找一夜情 #台北外約 #台北外送茶 #台北買春 #台北叫小姐 #台北叫全套 #台北按摩 #台北外約 #台北外送茶 #台北買春 #台北叫小姐 #台北叫全套 #台北按摩約炮 #台北找援交妹 #台北茶莊 #台北上門按摩 #台北找茶 #台北外約小姐【賴211861】【賴211861】 #台北找一夜情 #台北外約 #台北外送茶 #台北買春 #台北叫小姐 #台北叫全套 #台北按摩 #台北半套 #台北外約 #台北外送茶 #台北買春 #台北叫小姐 #台北叫全套 #台北按摩 #台北找援交妹 #台北茶莊 #台北上門按摩 #台北找茶 #台北外約小姐 #台北找一夜情 #台北外約 #台北外送茶 #台北買春 #台北叫小姐 #台北叫全套 #台北按摩 外出茶妹臺北買春優質茶莊台灣蘿莉送茶臺灣嫖妓兼職外約臺北喝茶臺中喝茶高雄喝茶【賴211861】【賴211861】外送茶-叫小姐-外約-全套外送服

96
yt5206978 · #4 ·

+賴:5206978 可看照片 洗澡愛愛按摩口交全套服務 狂插 耐幹 奶泡
聽魚友介紹說她超讚 馬上衝來試一下 見面發現本人比照片好看很多啊! 【超驚喜 XD】 人很熱情很會聊天不會冷場 聊天聊到一半 妹子就自己坐到我身上撒嬌要親親 親到受不了 抱著她衝近了浴室洗澡 互相洗右手摟著我脖子 左手撫摸我下面 妹子慢慢從嘴巴親到脖子在慢慢的跪在地上幫我吹 邊吹邊看著我 這感覺真不錯 超會吹 差點就繳械 還好小弟忍住了 把妹子拉了起來 讓她扶著墻 從後面衝刺 幹到妹子 一直喊不要了 受不了 直到第一發結束 我們一起洗澡去了 床上和她一起做前戲 問她可不可以69 妹子同意了 就互相口 鮑魚很有感覺 粉粉的穴穴 不會像之前約的魚下面超黑 xd 妹子被口到受不了一直扭動著腰 流了很多愛液沒幾分鐘自己就顫抖了起來 說自己要去了 太舒服了~ 呻吟也叫的超淫蕩 ~ 等結束後 妹妹也不會馬上洗澡 還會抱著我躺一會 再拉著我一起去洗澡 超有女友fu ~ 做完評價:妹子很不錯 奶有D奶

服務十分 外貿十分 有女友fu 可69 喜歡上位 超會搖 【推薦出來各位大大要珍惜 妹子是短期兼職 】
密碼:160cm/D/47kg23歲
介紹人:阿傑
LINE : 5206978

96
xw233678 · #5 ·

+賴:233678 會玩水多 小母狗吹潮
介紹一個女生~小婉是個比較可憐缺愛的女生 一開始在賴上接觸小婉跟小婉聊天 覺得這女生蠻健談的 跟她的共同話題還是蠻多的 之後跟她約的時候我很激動 我們約在旅館的 小婉剛進房間就給我一個擁抱 慢慢的就到舌吻 在後面小婉就自己解開我的皮帶 脫下我的褲子 小舌頭會先在你的龜頭上纏繞 然後一口含住一吸一含爽翻了 實在是忍不住了把小婉拉起來讓她扶着墻 硬邦邦的肉棒從後面插進去 小婉就臉紅紅了 聲音甜甜的 叫床聲音也是 幹到小婉一直喊不要了~ 受不了了~ 小婉是一個蠻不錯的女生服務也很好 會主動為你口 按摩 配合好的話可以69 冰火口交 清搶 帝王浴做完也不會給趕時間
客評:小弟已經試過很多次了 全程下來是真的不錯很主動 健談不趕時間 很會撩
介紹人:小晨
密碼:162 D 24y
Line:233678

96
kkmmi68 · #6 ·

+賴:mmi68該怎麽認識你呢 淫蕩大奶妹還是幼齒學生妹 感性趣加賴
本人經朋友推薦加到可可 之前都是去店面或者是約個工的 有點不相信外約的 害怕不是本人 會買點數之類的 但是這家外約對我的態度非常好 就好像已經認識很久的朋友一樣 給我介紹是妹也好正 奶子又大又軟 奶頭還是粉色的 屁股很翹 我邊做邊怕拍她屁股 淫水一直往外涌 我激動弟弟一直抽插她 妹妹嫵媚的叫起來啊~ 啊哈~哥哥繼續插我~ 求我再給她一次 妹妹的服務真的沒話講 做完之後可可還問我對妹妹滿不滿意 這次外約真的驚訝到我小弟了 值得介紹給你們試試看 那個妹妹我都已經回約了兩次了 服務還是這麽好 我每次都可以做好久所以每次都加節 可可家的正妹是真的很不錯 有需要的朋友可以家可可的賴:mmi68 說阿傑介紹優先看正妹

需要 Sign In 后方可回复, 如果你还没有账号请点击这里 Sign Up