開源代碼要慎用,容易中毒

本文原創,轉載請以鏈接形式注明地址:http://kymjs.com/code/2016/08/13/01

開源代碼要慎用,容易中毒
先說感受再看看我是怎么中毒以及怎么解毒的。
何為中毒,并不是說性能多么差,也不是代碼多么爛,而是你容易受到別人代碼的影響,不知不覺間就順著他的思路走了。
當然,有一種避免的辦法就是,拿來主義。我只拿你的代碼用,完全不看你怎么寫的,也不做功能定制和擴展,那當然也就百毒不侵。

開源實驗室-Android劃詞

事情的經過是這樣的(我要開始講故事了)。

很久很久以前,天地混沌,盤古開天辟地以后有了太陽和月亮,天空和大地,Android 操作系統也隨之崛起。但是,還缺少一樣東西,那就是自定義控件。有一天,我奉眾神之王宙斯之命創建一個通用劃詞模塊,讓每條產線都接入這個控件。 何為通用劃詞模塊,就是要通用,要有劃詞,還是個模塊。
?????? 扯不下去了,你們自己看圖識意吧。

開源實驗室-Android劃詞

開源實驗室-Android劃詞

開源實驗室-Android劃詞

中毒開始

就是這樣兩個效果,點按選中文字高亮,并彈出懸浮窗。
這種控件,偷個懶吧,去 GitHub 上找找,這一找,就成了我中毒的,開始。為了不坑大家,我就不說我找的那個項目地址了。

看了代碼,那個項目是這樣來做的:在 TextView 長按下的時候,通過getOffsetForPosition()來獲取到當前點擊坐標最近的一個字符在全部文本的第幾個位置,以及layout.getPrimaryHorizontal()來根據一個位置獲取到這個位置的字符在 View 內部的坐標。然后在這個文本相應的位置顯示一個懸浮窗,這個懸浮窗是一個自定義 View,里面有一個 PopupWindow ,在 PopupWindow 里面自定義了一個布局顯示自己的內容。
結合我們自己的邏輯,原本網上的開源項目只有一個懸浮窗,而我們自己的業務需要顯示三個懸浮窗,分別是:數據加載中的樣子、正常顯示翻譯內容的樣子,找不到翻譯內容的樣子。
既然已經有了一個雛形了,那就在這個項目上做擴展吧。(從有這個想法開始,就跌入了一個大大的深坑)

慢性中毒

擴展的方法就是仿照原有的寫法,再自定義兩個懸浮窗,然后根據顯示邏輯來切換什么時候應該顯示哪個懸浮窗。好不容易做好了三種狀態要顯示的懸浮窗都做好了,又發現長按的時候操作菜單和游標也需要顯示在正確的位置上。
那再改改,根據長按的坐標,找到對應的文本在 TextView 第幾個字,找到這個字在第幾行,找到這行文字的頂部坐標再減去行間距,再把懸浮操作菜單。原項目為了方便直接獲取到 TextView 的邊界值,直接在 TextView 的外層套了一個 Scrollview,方便實時獲取到 TextView 的坐標。

Android劃詞2

結果又發現如果 TextView 在一個 Scrollview 里面的時候,如果 Scrollview 發生滾動,懸浮窗應該自動 dismiss;
那再改改,滾動狀態獲取不到啊,那不如讓 TextView 在初始化的時候遞歸遍歷父控件,如果是可以滾動的控件就給這個控件添加一個滾動狀態監聽器,發生滾動直接 dismiss 懸浮窗。
至此,一個劃詞模塊的開發是完成了,功能表現也良好。

中毒太深

我靠,這通用劃詞模塊根本不通用啊,誰特么也不知道業務線接入時候的環境是怎樣的。

  1. 你控件使用的是自定義控件,可業務線有可能自己想使用劃詞功能的控件也是個自定義的 TextView,那沒辦法讓一個 Java 類同時繼承兩個類啊。
  2. 業務線有可能一個界面同時有多個 TextView 都要接劃詞功能,我們之前完全沒有考慮這種情況啊。照這種狀態可能每個界面同時顯示多個懸浮窗出來。
  3. 每個 TextView 在使用的時候,外面都套了一個 ScrollView,這要是接入這控件的界面有多個 TextView,界面估計要卡到爆。

解毒,重構的開始

沒辦法,意識到自己中毒太深了以后,只想說一句,活該你他媽偷懶想用別人代碼。
首先理清項目的結構。整個項目分三大塊:接入控件(TextView),游標和高亮,懸浮窗。

第一步,為了控件能夠通用,把接入控件抽出來做成一個接口,只暴露出該 View 有的方法,然后所有要接入劃詞功能的 View 都實現這個接口就好了,其中 getTouchX() 和 Y 是返回用戶手指按下的坐標,需要在實現接口協議時重寫 onTouch() 事件記錄下坐標:

public interface IViewProtocol {
    Context getContext();
    CharSequence getText();
    CharSequence getSelectedText(); // 獲取當前選中的文本
    int getTop();
    int getBottom();
    int getLeft();
    int getRight();
    float getTouchX();
    float getTouchY();
    int[] getLocationInWindow();
}

第二步:創建一個 Controller 負責控制懸浮窗的顯示,并將原項目中的懸浮窗修改為自定義 PopupWindow(原項目是一個 View,包含一個 PopupWindow,又包含一個自定義布局)。 PopupWindow 最大的好處就是,它的顯示邏輯和隱藏邏輯都可以交給系統去控制,就不需要我們手動再控制顯示隱藏了。
定義一個接口,封裝懸浮窗應該包含的方法:

public interface IFloatWindow {
    PopupWindow getFloatWindow();
    boolean isShowing();
    void showAsDropDown(IViewProtocol anchor, int xoff, int yoff, int gravity);
    void showAtLocation(IViewProtocol anchor, int x, int y, int gravity);
    void update(int x, int y, int width, int height, boolean force);
    void dismiss();
    int getHeight();
    int getWidth();
}

懸浮窗有兩類,一類是非交互的,類似加載界面、游標。另一類是可交互的,例如上文截圖。
不可交互的很簡單,直接顯示就好了,抽出公共基類 AbsFloatWindow,實現 PopupWindow 創建、初始化、顯示位置等方法就夠了。

可交互的需要考慮內部控件的事件,他們的內容區域是不同的,但是外部顯示框框是一樣的。
所以需要再多寫一個基類 AbsContentView<T> extends AbsFloatWindow 其中泛型 T 表示這個懸浮窗要顯示的內容實體類。例如服務器返回一段翻譯好的數據給客戶端,客戶端要將翻譯后的內容顯示出來;但如果網絡請求失敗,應該顯示另一種內容;服務器無法翻譯的時候,又顯示另一種內容的文本。
并且需要注意的是,有交互的控件還得要暴露出控件給業務線,讓他們自己根據自己的業務修改控件的圖片、文字、點擊事件。

第三步:抽出 SelectionInfo,封裝高亮顯示的文本信息,包括文本的起始坐標,結束坐標,文本長度,高亮的背景顏色,在整個 TextView 文本的位置等。

public class SelectionInfo {
    public static final int DEFAULT_CLOLOR = 0xffb7d9f8;
    private Object mSpan; //用于顯示背景顏色
    private int mStart;
    private int mEnd;
    private Spannable mSpannable;
}

最后

從改為使用 PopupWindow 開始,我們已經解決了界面中多 TextView 彈出多個懸浮窗的問題。
使用接口協議也完美的解決了業務線自定義控件的兼容性問題,不過為了他們使用方便,我們還是可以定義一個默認的 TextView 讓他們選擇,同時也是他們修改自己的自定義控件的一個模板。
把之前所有基于控件內部的坐標全部轉換成根據View.getLocationInWindow()獲取屏幕絕對坐標,也解決了嵌套一層 ScrollView 的問題。

問題解決,又可以浪了。

浪起來

最后的最后

記劃詞模塊重構感受
——開源代碼要慎用,容易中毒

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,606評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,582評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 176,540評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,028評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,801評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,223評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,294評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,442評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,976評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,800評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,996評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,543評論 5 360
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,233評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,662評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,926評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,702評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,991評論 2 374

推薦閱讀更多精彩內容