Bracer
在各个Activity或者各个Fragment之间安全快速的传递参数
First Blood
亲，都2020年了，还在写这样的代码吗？
val param1 = intent.getStringExtra("param1")
//param1 可能为空，所以我们要判空
if (param1 != null) {
//using param1
}
或者
class ActivityB : AppCompatActivity() {
private fun gotoActivityA() {
val intent = Intent(this, ActivityA::class.java)
intent.putExtra("key_1", "123")
startActivity(intent)
}
}
class ActivityA : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
//oh shit, wtf!! 写错了key的名字，导致一直获取不到值
val valueA = intent.getStringExtra("key_l")
}
}
更有甚者：
//Oh my god! 每个Fragment都要这么写一遍吗？
class FragmentA : Fragment() {
var a: String = ""
var b: String = ""
companion object {
fun newFragment(a: String, b: String): FragmentA {
val fragmentA = FragmentA()
val bundle = Bundle()
bundle.putString("key_a", a)
bundle.putString("key_b", b)
fragmentA.arguments = bundle
return fragmentA
}
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
arguments?.let {
a = it.getString("key_a") ?: ""
b = it.getString("key_b") ?: ""
}
}
}
我只是想简单传个参数，为什么要让我写这么多代码？？？我好累...
别怕，现在有了Bracer!!
Double kill
来看看新世纪应该如何正确传递参数吧
在Fragment中获取参数：
class MutableParamsFragment : Fragment() {
//基本类型
var intParams by mutableParams<Int>()
var booleanParams by mutableParams<Boolean>()
var stringParams by mutableParams<String>()
//自定义类型
var customParams by mutableParams<CustomParams1>()
//list
var intListParams by mutableParams<ArrayList<Int>>()
var stringListParams by mutableParams<ArrayList<String>>()
//array
var intArrayParams by mutableParams<IntArray>()
var arrayCustomParams by mutableParams<Array<CustomParams1>>()
//其他任意类型
//...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
//直接使用,不需要再手动从Arguments中读取了
println(intParams)
println(booleanParams)
println(stringParams)
println(customParams)
println(intListParams)
println(stringListParams)
println(intArrayParams)
}
}
如你所见，从Fragment里获取参数就是这么简单，并且非常安全！！
并且支持几乎所有的类型！
你不会再遇到空指针null，所有的参数都会有默认值；
不会遇到key写错的情况，所有的参数默认都以自身的名字作为key.
等同于：
val byteParams = arguments.getByte("byteParams", 0)
var stringParams = arguments.getString("stringParams") ?: ""
接下来我们来见识一下如何传递参数：
val fragment = MutableParamsFragment().apply {
intParams = 1 //赋值即可
booleanParams = true
stringParams = "123"
customParams = CustomParams1()
intListParams = arrayListOf(1,2,3)
intArrayParams = IntArray(2) { it }
}
//show this Fragment
val beginTransaction = supportFragmentManager.beginTransaction()
beginTransaction.add(R.id.frameLayout, fragment, "")
beginTransaction.commit()
Amazing!! 是的就是这么神奇，传递参数就是这么简单！
Double Kill
接下来看一下Activity的情况吧
class MutableParamsActivity : AppCompatActivity() {
//基本类型
var intParams by mutableParams<Int>()
var booleanParams by mutableParams<Boolean>()
var stringParams by mutableParams<String>()
//自定义类型
var customParams by mutableParams<CustomParams1>()
//list
var intListParams by mutableParams<ArrayList<Int>>()
var stringListParams by mutableParams<ArrayList<String>>()
//array
var intArrayParams by mutableParams<IntArray>()
var arrayCustomParams by mutableParams<Array<CustomParams1>>()
//其他任意类型
//...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_test)
//直接使用,不需要再手动从Intent中读取了
println(intParams)
println(booleanParams)
println(stringParams)
println(customParams)
println(intListParams)
println(stringListParams)
println(intArrayParams)
}
}
和Fragment类似，从Activity里获取参数依然这么简单，并且依旧非常安全！！
你不会再遇到空指针null，所有的参数都会有默认值；
不会遇到key写错的情况，所有的参数默认都以自身的名字作为key.
等同于：
val byteParams = intent.getByteExtra("byteParams", 0)
var stringParams = intent.getStringExtra("stringParams") ?: ""
接下来我们来见识一下如何传递参数：
MutableParamsActivity().apply {
intParams = 1 //赋值即可
booleanParams = true
stringParams = "123"
customParams = CustomParams1()
intListParams = arrayListOf(1,2,3)
intArrayParams = IntArray(2) { it }
}.start(context)
？？？确认你没写错？为什么能new一个Activity？？？
是的，就是这么神奇，和Fragment的用法几乎一致，只是略微做了点骚操作！
Triple Kill
除此之外，Bracer还支持一些其他特性.
例如自定义key：
var customKeyParams by mutableParams<Byte>("this is custom key")
或者支持自定义默认值：
var defaultParams by mutableParams<BigDecimal>(defaultValue = BigDecimal.ONE)
