開源代碼要慎用,容易中毒:記劃詞模塊重構感覺
本文原創,轉載請以連接形式註明地址:http://kymjs.com/code/2016/08/13/01服務器
先說感覺再看看我是怎麼中毒以及怎麼解毒的。
何爲中毒,並非說性能多麼差,也不是代碼多麼爛,而是你容易受到別人代碼的影響,不知不覺間就順着他的思路走了。
固然,有一種避免的辦法就是,拿來主義。我只拿你的代碼用,徹底不看你怎麼寫的,也不作功能定製和擴展,那固然也就百毒不侵。網絡
事情的通過是這樣的(我要開始講故事了)。佈局
好久好久之前,天地混沌,盤古開天闢地之後有了太陽和月亮,天空和大地,Android 操做系統也隨之崛起。可是,還缺乏同樣東西,那就是自定義控件。有一天,我奉衆神之王宙斯之命建立一個通用劃詞模塊,讓每條產線都接入這個控件。 何爲通用劃詞模塊,就是要通用,要有劃詞,仍是個模塊。
😂😂😂 扯不下去了,大家本身看圖識意吧。性能
就是這樣兩個效果,點按選中文字高亮,並彈出懸浮窗。
這種控件,偷個懶吧,去 GitHub 上找找,這一找,就成了我中毒的,開始。爲了避免坑你們,我就不說我找的那個項目地址了。操作系統
看了代碼,那個項目是這樣來作的:在 TextView 長按下的時候,經過getOffsetForPosition()
來獲取到當前點擊座標最近的一個字符在所有文本的第幾個位置,以及layout.getPrimaryHorizontal()
來根據一個位置獲取到這個位置的字符在 View 內部的座標。而後在這個文本相應的位置顯示一個懸浮窗,這個懸浮窗是一個自定義 View,裏面有一個 PopupWindow ,在 PopupWindow 裏面自定義了一個佈局顯示本身的內容。
結合咱們本身的邏輯,本來網上的開源項目只有一個懸浮窗,而咱們本身的業務須要顯示三個懸浮窗,分別是:數據加載中的樣子、正常顯示翻譯內容的樣子,找不到翻譯內容的樣子。
既然已經有了一個雛形了,那就在這個項目上作擴展吧。(從有這個想法開始,就跌入了一個大大的深坑)翻譯
擴展的方法就是仿照原有的寫法,再自定義兩個懸浮窗,而後根據顯示邏輯來切換何時應該顯示哪一個懸浮窗。好不容易作好了三種狀態要顯示的懸浮窗都作好了,又發現長按的時候操做菜單和遊標也須要顯示在正確的位置上。
那再改改,根據長按的座標,找到對應的文本在 TextView 第幾個字,找到這個字在第幾行,找到這行文字的頂部座標再減去行間距,再把懸浮操做菜單。原項目爲了方便直接獲取到 TextView 的邊界值,直接在 TextView 的外層套了一個 Scrollview,方便實時獲取到 TextView 的座標。
code
結果又發現若是 TextView 在一個 Scrollview 裏面的時候,若是 Scrollview 發生滾動,懸浮窗應該自動 dismiss;
那再改改,滾動狀態獲取不到啊,那不如讓 TextView 在初始化的時候遞歸遍歷父控件,若是是能夠滾動的控件就給這個控件添加一個滾動狀態監聽器,發生滾動直接 dismiss 懸浮窗。
至此,一個劃詞模塊的開發是完成了,功能表現也良好。繼承
我靠,這通用劃詞模塊根本不通用啊,誰特麼也不知道業務線接入時候的環境是怎樣的。遞歸
沒辦法,意識到本身中毒太深了之後,只想說一句,活該你他媽偷懶想用別人代碼。
首先理清項目的結構。整個項目分三大塊:接入控件(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 的問題。
問題解決,又能夠浪了。
記劃詞模塊重構感覺 ——開源代碼要慎用,容易中毒