周五和今天上午完成了kotlin基础笔记的整理,下面把自己写android项目的东西整理出来。
支持文档目录结构
[第一个kotlin项目基础笔记
anko相关的知识点
anko 是用来替换android中使用xml布局,改用代码布局的一个库更详细的资料
使用anko直接布局
下面是使用anko写的一个界面,里面就是dsl的一种写法,项目中还是使用传统的xml布局。现在anko布局有个问题就是android stdio不能够预览,现在kotlin已经是官方推荐语言了,不能预览的问题可能很快就会恢复。
setContentView(rootVertical {
paddingWithBottomFixed = dip(16)
backgroundResource = R.color.entrance_bg
relativeLayout {
verticalLayout {
linearLayout {
orientation = LinearLayout.HORIZONTAL
imageView {
gravity = Gravity.LEFT
imageResource = R.drawable.back_white
onClick { finish() }
}.lparams {
width = dip(30)
height = dip(30)
}
textView {
textColor = resources.getColor(R.color.white)
textSize = 16f
text = "手机号登录"
gravity = Gravity.RIGHT
onClick { finish() }
}.lparams {
width = matchParent
minimumHeight = dip(40)
}
}.lparams {
width = matchParent
height = wrapContent
}
textView {
textSize = 22f
textColor = resources.getColor(R.color.white)
text = "登录"
}.lparams {
width = wrapContent
height = wrapContent
topMargin = dip(50)
}
linearLayout {
orientation = LinearLayout.VERTICAL
textView {
textSize = 16f
textColor = resources.getColor(R.color.white)
text = "用户名"
}.lparams {
width = wrapContent
height = wrapContent
topMargin = dip(20)
}
loginName = autoCompleteTextView {
textColor = resources.getColor(R.color.white)
textSize = 16f
maxLength = 11
maxLines = 1
hintTextColor = resources.getColor(R.color.white)
singleLine = true
backgroundResource = R.color.transparent
}.lparams {
width = matchParent
height = wrapContent
}
view {
backgroundResource = R.color.white
}.lparams {
width = matchParent
height = dip(0.5f)
}
}.lparams {
width = matchParent
height = wrapContent
}
linearLayout {
orientation = LinearLayout.VERTICAL
textView {
textSize = 16f
textColor = resources.getColor(R.color.white)
text = "密码"
}.lparams {
width = wrapContent
height = wrapContent
topMargin = dip(20)
}
password = editText {
textColor = resources.getColor(R.color.white)
textSize = 16f
maxLength = 11
hintTextColor = resources.getColor(R.color.white)
backgroundResource = R.color.transparent
}.lparams {
width = matchParent
}
view {
backgroundResource = R.color.white
}.lparams {
width = matchParent
height = dip(0.5f)
}
}.lparams {
width = matchParent
height = wrapContent
}
}.lparams {
width = matchParent
height = matchParent
}
val nextIv = imageView {
imageResource = R.drawable.next_white
onClick { login() }
}.lparams {
width = dip(30)
height = width
alignParentRight()
alignParentBottom()
}
errorHint = textView {
textColor = resources.getColor(R.color.white)
drawableLeft = R.drawable.error_tip.toDrawable(context)
gravity = Gravity.CENTER_VERTICAL
text = "请输入正确的用户名和密码"
}.lparams {
height = dip(30)
sameBottomWith(nextIv)
}
}
})
使用anko特性,不再使用findViewById(int id)
在我们使用 xml 布局的时候,找到界面的控件一般使用findViewById(int id)或者使用ButeerKnife注解的方式,使用了anko后,变得更加简单,像导入一个java类一样导入这个布局,就可以直接使用界面中定义的控件了。在登陆界面中,如下:
//导入这个布局
import kotlinx.android.synthetic.main.activity_login.*
// 对按钮设置一个点击事件,email_sign_in_button 这个名字就是界面中定义的名字
email_sign_in_button.setOnClickListener { attemptLogin() }
项目基础
1. BaseActivity
被继承的类需要使用open关键字修饰
package practice.yhai.com.kotlinpractice.common
import android.support.v7.app.AppCompatActivity
open class BaseActivity : AppCompatActivity()
因为这个类不需要有类体,所以{}可以省略不写
2. App
使用了延迟加载和伴随对象
伴随对象
因为kotlin使用伴随对象实现的static类似的功能,
LaunchActivity中使用到的特性
在启动页中,利用Handler类的postDelayed延迟两秒跳转到下一个界面,postDelayed需要两个参数,一个是Runnable,另一个是Int
匿名类
定义一个匿名类,实现Runnable接口
Handler().postDelayed(object: Runnable{
override fun run() {
}
},2000)
闭包作为参数
因为Runnable接口只有一个方法,这个方法没有返回值,那么对应的闭包写法如下
Handler().postDelayed({
},2000)
LoginActivity 中的特性
下面代码生成的登陆界面的模板代码,里面涉及到终止的概念,昨天我在写基础中,对这个没有详细说,借助下面这段代码聊一下,生成的代码这个样子的:
password.setOnEditorActionListener(TextView.OnEditorActionListener{ _, id, _ ->
if (id == EditorInfo.IME_ACTION_DONE || id == EditorInfo.IME_NULL) {
attemptLogin()
return@OnEditorActionListener true//这里有个返回,但是这个返回比较奇怪,return@OnEditorActionListener true,那前面的@OnEditorActionListener 是什么指的是代码块前面TextView 的OnEditorActionListener的接口。
}
false
})
上面的这个代码我认为是通过如下步骤转换的。
第一步:
password.setOnEditorActionListener(object: TextView.OnEditorActionListener {
override fun onEditorAction(p0: TextView?, p1: Int, p2: KeyEvent?): Boolean {
// TODO("not implemented") //To change body of created functions use File | Settings | File Templates.
return true
}
})
因为上面的这个回调中只有一个函数,那这可以写成一个闭包的方式
password.setOnEditorActionListener({ _, id, _ ->
if (id == EditorInfo.IME_ACTION_DONE || id == EditorInfo.IME_NULL) {
attemptLogin()
}
false
})
上面的代码省略的if判断里面的返回,这个地方的return需要指定是谁的返回值。现在使用闭包就不知道返回给谁了,怎么办呢?
在闭包的前面加上TextView.OnEditorActionListener 接口名,在返回的时候指定我这个返回值是给OnEditorActionListener。这里还有一种方式参考资料
_ 忽略的值
闭包代码中,->的左边出现了_下划线,意思是这个字段被忽略掉。
点击事件的处理
自动生成的点击事件是如下:
email_sign_in_button.setOnClickListener { attemptLogin() }
手写是通过如下演变过来的:
- 第一步,使用object : 实现一个匿名内部类
email_sign_in_button.setOnClickListener(object : View.OnClickListener{
override fun onClick(p0: View?) {
attemptLogin()
}
})
- 第二步,因为这个接口只有一个方法,所以可以写成lambda
email_sign_in_button.setOnClickListener({attemptLogin()})
- 第三步,省略外面圆括号,这就成了代码生成的样子了。
email_sign_in_button.setOnClickListener { attemptLogin() }
但是,我们使用了anko库,那么还有更好的写法
email_sign_in_button.onClick { attemptLogin() }
使用扩展函数,增强Int类和Context类
我们一般获取资源文件的时候,使用如下代码
getResources().getDrawable(R.drawable.ic_launcher_background)
getResources().getString(R.string.abc_action_bar_home_description)
利用扩展方法的特性实现,对Int类型扩展两个方法,将resources.getString(this),ContextCompat.getColor(context, this)的功能扩展到Int类型的身上。
fun Int.toString(resources: Resources): String{
return resources.getString(this)
}
//兼容低版本
fun Int.toColor(context: Context): Int{
return ContextCompat.getColor(context, this)
}
fun Int.toDrawable(context: Context): Drawable {
return ContextCompat.getDrawable(context,this)
}
那么,在项目中就可以如下使用
//设置文本
titleTv.text = R.string.modify.toString(resources)
//设置背景图片
leftIcon.background = R.drawable.ic_arrow_back_white.toDrawable(this)
object 几种使用情况
学习kotlin中,接触到三种关于object 的使用
- 匿名内部类
email_sign_in_button.setOnClickListener(object : View.OnClickListener{
override fun onClick(p0: View?) {
attemptLogin()
}
})
- object+类名+{}
实现java中单例的一种方法。
区别Kotlin中的object和companion object关键字object ProfileQuery { val PROJECTION = arrayOf( ContactsContract.CommonDataKinds.Email.ADDRESS, ContactsContract.CommonDataKinds.Email.IS_PRIMARY) val ADDRESS = 0 val IS_PRIMARY = 1 }
- companion object,伴随对象的使用
伴随对象代码块必须要在一个类中,因为kotlin写代码比较随意,扩展名.kt的文件内就可以写代码,伴随对象的代码必须写在class 声明的类体重去写。
跟上面一种object 的使用方式的区别:我理解为*** companion object*** 修饰的是部分为static,上面一种是全局的
companion object {
/**
* Id to identity READ_CONTACTS permission request.
*/
private val REQUEST_READ_CONTACTS = 0
/**
* A dummy authentication store containing known user names and passwords.
* TODO: remove after connecting to a real authentication system.
*/
private val DUMMY_CREDENTIALS = arrayOf("[email protected]:hello", "[email protected]:world")
fun test(){
}
}
定义组合式控件
项目中UrlConfigView为组合控件,感觉没什么好说的!
网络请求
使用retrofit构建网络层
- 初始化Retrofit对象
import okhttp3.*
import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory
import java.util.concurrent.TimeUnit
/**
* Created by yh on 9/23/17.
*/
object YHaiServer {
val BASE_URL = "http://192.168.1.53:8888/yibaad/sdk/"
private val DEFAULT_TIMEOUT = 45
private var retrofit: Retrofit
var apiStore: ApiStore
init {
val clientBuilder = OkHttpClient.Builder()
clientBuilder.connectTimeout(DEFAULT_TIMEOUT.toLong(), TimeUnit.SECONDS)
clientBuilder.writeTimeout(10000, TimeUnit.SECONDS)
clientBuilder.readTimeout(10000, TimeUnit.SECONDS)
retrofit = Retrofit.Builder()
.baseUrl(BASE_URL)
.client(clientBuilder.build())
.addConverterFactory(GsonConverterFactory.create())
.build()
apiStore = retrofit.create(ApiStore::class.java)
}
}
apiStore的定义
import retrofit2.Call
import retrofit2.http.*
/**
* Created by yh on 9/23/17.
*/
interface ApiStore {
@Headers("Content-type:application/json;charset=UTF-8")
@POST("modifyAdSourceDeployDetail")
fun modifyAdSourceDeployDetail(@Body detailData: BaseResponse): Call
}
Retrofit处理两个baseUrl的资料
使用retrofit 一般结合Rxjava使用 ,我在项目中没有使用Rxjava,代码一样很好理解;
doAsync {//开启一个异步线程
val param = BaseResponse()
val result = YHaiServer.apiStore.modifyAdSourceDeployDetail(param).execute().body() as BaseResponse
if (result.code == 200){
uiThread {//刷新UI界面
}
}else{ //错误的情况
uiThread {//刷新UI界面
}
}
}
在上面的调用中,我遇到了一个不能获取正确数据的情况,但是程序也没有发生异常,后面发现是doAsync代码块中已经把异常捕获了。如果想知道具体是什么异常,像java一样try{}catch(e: Exception){}finally{}就能捕获到时什么异常
RecyclerView 展示数据
recyclerView.layoutManager = LinearLayoutManager(this)
recyclerView.setHasFixedSize(true)
recyclerView.adapter = MainRecyclerAdapter(this,datas)
//请求数据
doAsync {
val data = YHaiServer.apiStore.getWeather("CN101010100").execute().body() as Data
datas.addAll(data.HeWeather5!![0].hourly_forecast)
uiThread {
recyclerView.adapter.notifyDataSetChanged()
}
}
inner class MainRecyclerAdapter(val context: Context, val datas: MutableList) : RecyclerView.Adapter() {
override fun onCreateViewHolder(p0: ViewGroup?, p1: Int): MainViewHolder {
val view = LayoutInflater.from(context).inflate(R.layout.item_weather_view,null)
return MainViewHolder(view)
}
override fun onBindViewHolder(holder: MainViewHolder?, postion: Int) {
val data = datas[postion]
//因为holder 被转换了一次,后面就知道通过内置的itemView找到界面上的控件
holder as MainViewHolder
holder.itemView.time.text = "time = ${data.date}"
holder.itemView.code.text = "cond.code = ${data.cond.code}"
holder.itemView.txt.text = "cond.txt = ${data.cond.txt}"
holder.itemView.dir.text = "wind.dir = ${data.wind.dir}"
holder.itemView.sc.text = "wind.sc = ${data.wind.sc}"
holder.itemView.deg.text = "wind.deg = ${data.wind.deg}"
holder.itemView.spd.text = "wind.spd = ${data.wind.spd}"
}
override fun getItemCount(): Int {
return datas.size
}
}
class MainViewHolder(itemView: View?) : RecyclerView.ViewHolder(itemView)
看起来舒服的资料
Demo