ViewManager
在了解anko之前届榄,我們必須要先了解一下ViewManager這個(gè)類抡砂,這個(gè)是一個(gè)接口喉前,通過這個(gè)接口,我們可以在Activity中添加轻专、移除和更新View忆矛,我們可以通過 Context.getSystemService()來或者這個(gè)類。
public void addView(View view, ViewGroup.LayoutParams params);
public void updateViewLayout(View view, ViewGroup.LayoutParams params);
public void removeView(View view);
也就是說请垛,只有實(shí)現(xiàn)了這個(gè)接口的類才能夠在activity中對(duì)view進(jìn)行操作催训。系統(tǒng)的ViewGroup就實(shí)現(xiàn)了這個(gè)接口。
AnkoContext
在anko中宗收,所有的View的操作是通過AnkoContext這個(gè)類來實(shí)現(xiàn) 的漫拭,所以,AnkoContext實(shí)現(xiàn)了ViewManager接口混稽,但是AnkoContext只提供添加功能采驻,不提供view的移除和更新审胚。
interface AnkoContext<out T> : ViewManager {
val ctx: Context
val owner: T
val view: View
override fun updateViewLayout(view: View, params: ViewGroup.LayoutParams) {
throw UnsupportedOperationException()
}
override fun removeView(view: View) {
throw UnsupportedOperationException()
}
一旦我們調(diào)用了updateViewLayout或者removeView方法,那么將會(huì)拋異常礼旅,UnsupportedOperationException膳叨,不支持這種操作。
這個(gè)類中包含了下面的三個(gè)參數(shù)
- ctx: Context-- 上下文信息
- owner: T-- 這個(gè)owner是這個(gè)UI的依附者痘系,可能是Activity菲嘴、fragment、viewHolder
- view: View--AnkoComponent生成并返回的View
下面來看看ankoContext提供的幾個(gè)靜態(tài)方法:
companion object {
fun create(ctx: Context, setContentView: Boolean = false): AnkoContext<Context>
= AnkoContextImpl(ctx, ctx, setContentView)
fun createReusable(ctx: Context, setContentView: Boolean = false): AnkoContext<Context>
= ReusableAnkoContext(ctx, ctx, setContentView)
fun <T> create(ctx: Context, owner: T, setContentView: Boolean = false): AnkoContext<T>
= AnkoContextImpl(ctx, owner, setContentView)
fun <T> createReusable(ctx: Context, owner: T, setContentView: Boolean = false): AnkoContext<T>
= ReusableAnkoContext(ctx, owner, setContentView)
fun <T: ViewGroup> createDelegate(owner: T): AnkoContext<T> = DelegatingAnkoContext(owner)
}
這4個(gè)方法返回的都是AnkoContext實(shí)體汰翠,那么區(qū)別是什么龄坪?
- create表示直接創(chuàng)建出AnkoContext,并且不能重用复唤,一旦已經(jīng)綁定了View健田,那么將拋出異常。
- createReusable表示創(chuàng)建出可以復(fù)用的AnkoContext,如果一個(gè)AnkoContext已經(jīng)添加了子View佛纫,那么它會(huì)重新add View
- createDelegate妓局;表示將view添加到相應(yīng)的委托對(duì)象中,用來在自定義View中代替inflate方法雳旅。
我們來看看這幾個(gè)方法的實(shí)現(xiàn):
AnkoContextImpl
create方法返回的是AnkoContextImpl
open class AnkoContextImpl<T>(
override val ctx: Context,
override val owner: T,
private val setContentView: Boolean
) : AnkoContext<T> {
private var myView: View? = null
override val view: View
get() = myView ?: throw IllegalStateException("View was not set previously")
//將View添加到context中
override fun addView(view: View?, params: ViewGroup.LayoutParams?) {
if (view == null) return
if (myView != null) {
//如果myView跟磨!=null,表示已經(jīng)添加了View了攒盈,如果是create方法調(diào)用的抵拘,那么將會(huì)拋出異常
alreadyHasView()
}
this.myView = view
if (setContentView) {
//如果需要setContentView,那么執(zhí)行addView操作
doAddView(ctx, view)
}
}
private fun doAddView(context: Context, view: View) {
when (context) {
//找到activity型豁,然后執(zhí)行setContentView
is Activity -> context.setContentView(view)
is ContextWrapper -> doAddView(context.baseContext, view)
else -> throw IllegalStateException("Context is not an Activity, can't set content view")
}
}
open protected fun alreadyHasView(): Unit = throw IllegalStateException("View is already set: $myView")
}
ReusableAnkoContext
createReusable返回的是ReusableAnkoContext實(shí)例
internal class ReusableAnkoContext<T>(
override val ctx: Context,
override val owner: T,
setContentView: Boolean
) : AnkoContextImpl<T>(ctx, owner, setContentView) {
override fun alreadyHasView() {}
}
因?yàn)閏reateReusable表示創(chuàng)建的是可重用布局僵蛛,而AnkoContextImpl在已經(jīng)綁定了View的時(shí)候,將會(huì)通過alreadyHasView拋出異常迎变。所以ReusableAnkoContext通過復(fù)寫alreadyHasView充尉,并且來讓布局可重用。
DelegatingAnkoContext
createDelegate(owner: T)返回的是DelegatingAnkoContext實(shí)例
internal class DelegatingAnkoContext<T: ViewGroup>(override val owner: T): AnkoContext<T> {
override val ctx: Context = owner.context
override val view: View = owner
override fun addView(view: View?, params: ViewGroup.LayoutParams?) {
if (view == null) return
if (params == null) {
owner.addView(view)
} else {
owner.addView(view, params)
}
}
}
DelegatingAnkoContext會(huì)將view添加到owner上衣形,而不是Activity驼侠。
AnkoComponen
在Anko中,如果我們想要它的預(yù)覽特性谆吴,那么我們就需要用到AnkoComponen倒源,只有繼承了AnkoComponen,并且結(jié)合anko support句狼,就能?夠預(yù)覽了笋熬,我們需要在實(shí)現(xiàn)createView方法
interface AnkoComponent<in T> {
fun createView(ui: AnkoContext<T>): View
}
我們通過createView方法繪制我們想要的View并返回。AnkoComponent有一個(gè)擴(kuò)展方法setContentView,是用來給Activity設(shè)置ContentView的腻菇。
fun <T : Activity> AnkoComponent<T>.setContentView(activity: T): View =
createView(AnkoContextImpl(activity, activity, true))
擴(kuò)展
AnkoContext內(nèi)部添加了幾個(gè)擴(kuò)展函數(shù)
inline fun Context.UI(setContentView: Boolean, init: AnkoContext<Context>.() -> Unit): AnkoContext<Context> =
createAnkoContext(this, init, setContentView)
inline fun Context.UI(init: AnkoContext<Context>.() -> Unit): AnkoContext<Context> =
createAnkoContext(this, init)
inline fun Fragment.UI(init: AnkoContext<Fragment>.() -> Unit): AnkoContext<Fragment> =
createAnkoContext(activity, init)
在Activity和fragment中胳螟,可以直接通過UI的方式調(diào)用昔馋。
UI {
.....
}
然后內(nèi)部會(huì)調(diào)用createAnkoContext,將UI里面的View傳入
inline fun <T> T.createAnkoContext(
ctx: Context,
init: AnkoContext<T>.() -> Unit,
setContentView: Boolean = false
): AnkoContext<T> {
val dsl = AnkoContextImpl(ctx, this, setContentView)
dsl.init()
return dsl
}
內(nèi)部還是調(diào)用AnkoContextImpl糖耸,并且調(diào)用內(nèi)部還是調(diào)用AnkoContextImpl的init方法秘遏,初始化UI,并添加ctx中.
AnkoUI布局的動(dòng)態(tài)創(chuàng)建
在了解AnkoUI的布局的創(chuàng)建之前蔬捷,我們需要先了解一下anko支持的dsl.
DSL(Domain-Specific-Language)
dsl指的是特定領(lǐng)域的語言垄提,kotlin的DSL特性支持就是擴(kuò)展榔袋,anko通過dsl周拐,才有了anko layout庫。
帶接收者的函數(shù)字面值
在kotlin中凰兑,支持給函數(shù)指定接收者對(duì)象妥粟,而無需額外的限定符,有點(diǎn)類似于擴(kuò)展函數(shù)吏够。
init: (@AnkoViewDslMarker _RelativeLayout).() -> Unit
相當(dāng)于() -> Unit指定的接收者對(duì)象為_RelativeLayout
如果在函數(shù)體內(nèi)部可以調(diào)用接收者對(duì)象的方法勾给,那么假若這個(gè)方法又是帶接收者類型的方法,那么就可以不斷的往下調(diào)用了锅知。
anko布局
下面是一個(gè)簡(jiǎn)單的anko布局
relativeLayout {
imageView {
adjustViewBounds = true
scaleType = ImageView.ScaleType.CENTER_CROP
imageResource = R.drawable.bg_members
}.lparams(width = matchParent, height = matchParent)
statusBar = view {
id = statusBarHolder
}
anko給ViewManager添加了大部分組件的擴(kuò)展函數(shù),這個(gè)根節(jié)點(diǎn)relativeLayout將會(huì)調(diào)用到擴(kuò)展函數(shù)中播急,
inline fun ViewManager.relativeLayout(): android.widget.RelativeLayout = relativeLayout() {}
inline fun ViewManager.relativeLayout(init: (@AnkoViewDslMarker _RelativeLayout).() -> Unit): android.widget.RelativeLayout {
return ankoView(`$$Anko$Factories$Sdk15ViewGroup`.RELATIVE_LAYOUT, theme = 0) { init() }
}
在上面這個(gè)relativeLayout方法中,接收一個(gè)() -> Unit的lambada表達(dá)式售睹,這個(gè)表達(dá)式限定于relativeLayout桩警,所以這個(gè)參數(shù)就是relativelayout里面的元素,在上面的例子就是這個(gè)方法:
imageView {
adjustViewBounds = true
scaleType = ImageView.ScaleType.CENTER_CROP
imageResource = R.drawable.bg_members
}.lparams(width = matchParent, height =matchParent){
statusBar = view {
id = statusBarHolder
}
有一個(gè)注解AnkoViewDslMarker,這個(gè)參數(shù)會(huì)給對(duì)應(yīng)_RelativeLayout的View對(duì)象擴(kuò)展一個(gè)applyRecursively方法
@DslMarker
@Target(AnnotationTarget.TYPE)
annotation class AnkoViewDslMarker
/**
* Apply [f] to this [View] and to all of its children recursively.
*
* @return the receiver.
*/
inline fun <T : View> T.applyRecursively(noinline f: (View) -> Unit): T {
AnkoInternals.applyRecursively(this, f)
return this
}
applyRecursively擴(kuò)展T對(duì)象昌妹,并且接收一個(gè)f函數(shù)捶枢,在這里指的是View的init方法,會(huì)先執(zhí)行f方法飞崖,然后遍歷所有的子元素烂叔,并進(jìn)行創(chuàng)建。
fun applyRecursively(v: View, style: (View) -> Unit) {
//執(zhí)行init方法固歪,創(chuàng)建對(duì)象
style(v)
if (v is ViewGroup) {
//如果是ViewGroup蒜鸡,那么可以添加子View,看看是否有子View
val maxIndex = v.childCount - 1
for (i in 0 .. maxIndex) {
//對(duì)子View執(zhí)行applyRecursively方法
v.getChildAt(i)?.let { applyRecursively(it, style) }
}
}
}
將會(huì)調(diào)用ViewManager的ankoView方法牢裳。
anko默認(rèn)支持的工廠
我們上面的用的構(gòu)造工廠是sdk15提供的工廠逢防,我們看看工廠里面的實(shí)現(xiàn):
internal object `$$Anko$Factories$Sdk15ViewGroup` {
val APP_WIDGET_HOST_VIEW = { ctx: Context -> _AppWidgetHostView(ctx) }
val ABSOLUTE_LAYOUT = { ctx: Context -> _AbsoluteLayout(ctx) }
val FRAME_LAYOUT = { ctx: Context -> _FrameLayout(ctx) }
val GALLERY = { ctx: Context -> _Gallery(ctx) }
val GRID_LAYOUT = { ctx: Context -> _GridLayout(ctx) }
val GRID_VIEW = { ctx: Context -> _GridView(ctx) }
val HORIZONTAL_SCROLL_VIEW = { ctx: Context -> _HorizontalScrollView(ctx) }
val IMAGE_SWITCHER = { ctx: Context -> _ImageSwitcher(ctx) }
val LINEAR_LAYOUT = { ctx: Context -> _LinearLayout(ctx) }
val RADIO_GROUP = { ctx: Context -> _RadioGroup(ctx) }
val RELATIVE_LAYOUT = { ctx: Context -> _RelativeLayout(ctx) }
val SCROLL_VIEW = { ctx: Context -> _ScrollView(ctx) }
val TABLE_LAYOUT = { ctx: Context -> _TableLayout(ctx) }
val TABLE_ROW = { ctx: Context -> _TableRow(ctx) }
val TEXT_SWITCHER = { ctx: Context -> _TextSwitcher(ctx) }
val VIEW_ANIMATOR = { ctx: Context -> _ViewAnimator(ctx) }
val VIEW_SWITCHER = { ctx: Context -> _ViewSwitcher(ctx) }
}
對(duì)于每一個(gè)View,內(nèi)部都有一個(gè)相對(duì)應(yīng)的構(gòu)建方法贰健。
open class _RelativeLayout(ctx: Context): RelativeLayout(ctx) {
...
inline fun <T: View> T.lparams(
width: Int = android.view.ViewGroup.LayoutParams.WRAP_CONTENT,
height: Int = android.view.ViewGroup.LayoutParams.WRAP_CONTENT,
init: RelativeLayout.LayoutParams.() -> Unit
): T {
val layoutParams = RelativeLayout.LayoutParams(width, height)
layoutParams.init()
this@lparams.layoutParams = layoutParams
return this
}
...
}
這個(gè)_RelativeLayout內(nèi)部都是重載的lparams胞四,也就是通過這個(gè)方法來創(chuàng)建布局的param屬性。
ankoView的實(shí)現(xiàn)
inline fun <T : View> ViewManager.ankoView(factory: (ctx: Context) -> T, theme: Int, init: T.() -> Unit): T {
//獲取需要依附的context對(duì)象
val ctx = AnkoInternals.wrapContextIfNeeded(AnkoInternals.getContext(this), theme)
//通過工廠模式返回View
val view = factory(ctx)
view.init()
//添加View伶椿,并返回
AnkoInternals.addView(this, view)
return view
}
這個(gè)ankoView將會(huì)接收工廠方法辜伟,返回View氓侧,然后執(zhí)行init方法。這個(gè)init方法就行上面的工廠對(duì)象的構(gòu)造函數(shù)导狡。下面看看View添加
fun <T : View> addView(manager: ViewManager, view: T) = when (manager) {
//針對(duì)于根節(jié)點(diǎn)下的View
is ViewGroup -> manager.addView(view)
//針對(duì)于根節(jié)點(diǎn)
is AnkoContext<*> -> manager.addView(view, null)
else -> throw AnkoException("$manager is the wrong parent")
}
將會(huì)直接添加到parent節(jié)點(diǎn)或者context下约巷。
下面是一個(gè)自己理解的ankoView的繪制步驟:
[圖片上傳失敗...(image-60d706-1542512107977)]