内容提要
本文内容较长,包含一个功能整个重构从想法到设计以及落地的完整过程,通过阅读本文你可以收获:
-
Glide 几个关键特性的设计原理以及对它们的思考(面试可用)
-
编码从拓展性层面的考虑到面向对象编程的实践
-
类似于RxJava的工作流的设计思想以及实践
-
一些kotlin和Java 互相调用的小技巧
-
一个功能强大的调用系统相机、系统相册的库以及它是如何被设计出来的
鉴于最近对原有项目进行了老的代码的重构,其中的调用系统拍照选图模块就是我们日常遇到一个痛点,需要在调用系统相机(相册)的部分写Intent :
//示例代码
Intent intent = new Intent(Intent.ACTION_GET_CONTENT, null);
intent.setType(“image/*”);
activity.startActivityForResult(intent, getRequestCode());
在onActivityResult中获得照片以后、异步处理(方向纠正、压缩等)获得的数据、如果有业务需要还需实现上传到后端的逻辑:
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable final Intent data) {
//示例代码
//异步处理图片、压缩、旋转等
File result = compressPhotoFromAlbumAsy(data);
// 上传给后端、等业务处理
uploadAsy(result);
}
所以梳理下来有几点痛点:
-
处理入口分散、触发拍照行为和接收不在一个地方、依赖重写onActivityResult方法,非常不利于后期模块化组件化拆分。
-
图片需要异步处理以提高用户体验,所以此时还需要考虑容器的生命周期,需要添加很多判断代码,从而导致可读性比较差,每次梳理图片的逻辑处理曾和业务上的图片上传层都需要不少时间
重构结果:
故鉴于以上几个痛点,我借鉴Glide中的几个思想对此模块进行了重构,设计了CoCo 库->一行代码灵活完成原生系统提供的拍照、选图、压缩、裁剪等脱离业务层的操作。先随便贴两个功能:
- 调用系统相机拍张照:
CoCo.with(this@MainActivity)
.take(createSDCardFile())
.start(object : CoCoCallBack {
override fun onSuccess(data: TakeResult) {
iv_image.setImageBitmap(Utils.getBitmapFromFile(data.savedFile!!.absolutePath))
}
})
上述便可自动拿到原图去展示我们的结果,当然如果你需要压缩或者处理一下原图的话,只需切换一个操作符即可:
CoCo.with(this@TakePictureActivity)
.take(createSDCardFile())
//切换操作符执行下一步功能
.then()
//处理图片
.dispose()
.start(object : CoCoCallBack {
override fun onSuccess(data: DisposeResult) {
iv_image.setImageBitmap(data.compressBitmap)
}
})
用dispose 操作符可以压缩并纠正原图的转向,并且异步操作自动像Glide一样绑定with()中传入容器的生命周期,而且dispose 对于图片文件的处理方式可以自定义,按需修改策略。
当然、CoCo还提供了 系统相册选图、系统裁剪等的功能、并且这一系列的操作符可以组合使用,你可以选图、压缩并裁剪、选图裁剪等,按需自己组合即可。
对Glide 的致敬:
Glide 是我们Android 常用的图片库,它有几个特性是我们所熟知的:
-
一行代码完成图片加载、缓存、展示过程、并且异步操作自动绑定容器生命周期
-
执行加载操作load之后、拓展了很多不同的方法可灵活选择,比如图片大小、缓存类型等、 最终通过into 完成所有操作
1:上述令人舒服特性的原理在于在Glide 内部,自己通过添加Fragment的方式 在Fragment的生命周期中维护了个LifeCycle,因此可以感知调用容器的生命周期,从而在相关的时候做一些异步的解绑操作。
public class RequestManagerFragment extends Fragment {
@Override
public void onStart() {
super.onStart();
lifecycle.onStart();
}
@Override
public void onDestroy() {
super.onDestroy();
lifecycle.onDestroy();
}
}
2:而通过load操作符之后返回的对象其实是一个 Builder对象,根据load入参数的不同产生不同的子类Builder对象,不同子类封装自己特有的方法,比如load之后返回的是:DrawableTypeRequest 对象,本质也是一个Builder:
//简化了继承关系,只为了展示清楚核心代码
public class DrawableTypeRequest extends GenericRequestBuilder implements DownloadOptions {
/**
- 自己特有的方法。。。。。
*/
public <Y extends Target> Y downloadOnly(Y target) {
///
}
}
调用asBitmap 之后又返回 BitmapTypeRequest 对象,同样也是Builder:
//简化了继承关系,只为了展示清楚核心代码
public class BitmapTypeRequest extends GenericRequestBuilder<ModelType, Bitmap> {
/**
- 自己特有的方法。。。。。
*/
public BitmapRequestBuilder<ModelType, byte[]> toBytes() {
///
}
}
但是它们都继承自最终基类 GenericRequestBuilder,这个类中就包含了我们常用的into 方法:
public class GenericRequestBuilder<ModelType, DataType, ResourceType, TranscodeType> implements Cloneable { /**
- 基类共有的方法。。。。。
*/
public <Y extends Target> Y into(Y target) {
}
}
通过上述设计即可以保证每个子功能模块在Builder中维护自己特有的方法,又可以最终调用到父类的公用方法,一来比较符合面向对象的单一职责的设计原则,二来可以提高代码可读性,让使用者在使用的时候便于理解。
总结一下 Glide的核心思想就一行代码完成
-
在哪里?
-
做什么?
-
结果是?
//在哪里
Glide.with(this@MainActivity)
//干嘛
.load(“https://xxxxx.com.sxx.jpg”)
//结果是
.into(iv_image)
需求分析
-
我需要实现调用系统的相机、相册、裁剪、无非都需要通过intent来启动Activity,如果我采用Fragment的方式一来可以将其作为载体去启动Activity和重写onActivityResult接收返回的数据的方法,从而无须在业务层重写,从而减少代码入侵解决第一个痛点、而来可以借鉴Glide模拟生命周期的方式在后期处理图片比如压缩、旋转等异步操作的时候自动感知外部容器生命周期,从而减少业务代码
-
Glide的 功能对应基类Builder提供基本方法、然后在子类拓展其特有功能的方法可以借鉴到这个场景下:执行每个功能产生相关的功能特性Builder、然后在父类方法中收拢,最终拿到结果,所以设计了如下UML图:
UML 分析:
-
CoCo.with 方法传入当前容器,指定当前的工作场地[在哪里 Where] ,返回一个FunctionManager 对象,这个对象提供了我们当前场地能提供的基本方法,也就是我们接下来的事情[做什么 whate]拍照(take)、选图(pick)、裁剪(crop)、处理(dispose) 等功能均在此类提供和拓展。
-
当FunctionManager调用其中某一个操作符时候,产生其对应的Builder对象,比如调用了take功能,我们返回一个 TakerBuilder对象,因为是拍照功能,我们可以在这里提供摄像头面向(cameraFace)、拍照结果写入文件(fileToSave)等参数、同理如果你选择了pick 方法,则可以在这里拓展图片选择范围(range)等方法、而最终无论最终是哪种子功能Builder、它们都继承自BaseFunctionBuilder、而在这个父类中提供了start的方法,无论通过哪种子类拓展其方法来拼装参数、都可以通过父类的start 方法执行到下一步,即保证了一行代码的整洁性、又保证了子类之间方法的隔离,符合面向对象设计思想,便于后续拓展和维护 。
-
通过1、2步 我们完成了在哪里、干什么的封装,最终通过start的方法最终执行,拿到我们想要的结果,也就是一系列的Result
详细源码的设计与分析:
下面以选图功能作为链路详细分析整个大体设计(源码有所简化、方便理解):
//在哪里 [activity中]
CoCo.with(this@MainActivity)
//干嘛[选图]
.pick()
//结果是 [PickResult]
.start(object : CoCoCallBack {
override fun onSuccess(data: PickResult) {
iv_image.setImageURI(data.originUri)
}
override fun onFailed(exception: Exception) {
}
})
第一步当然定义容器的场景:
object CoCo {
@JvmStatic
fun with(activity: Activity): FunctionManager {
checkStatusFirst(activity)
return FunctionManager.create(activity)
}
@JvmStatic
fun with(fragment: androidx.fragment.app.Fragment): FunctionManager {
checkStatusFirst(fragment.activity)
return FunctionManager.create(fragment)
}
@JvmStatic
fun with(fragment: Fragment): FunctionManager {
checkStatusFirst(fragment.activity)
return FunctionManager.create(fragment)
}
}
定义使用场景以后、返回一个FunctionManager 对象,里面提供我们所有已有的和以后可以拓展的功能:
- 小技巧: 使用 @JvmStatic 注解可以保持Java 调用 kotlin 代码时 和kotlin 自己调用提供一致性的体验
class FunctionManager(internal val container: IContainer) {
/** 拍照
-
take photo from system camera
-
@param fileToSave the result of take photo to save
-
@see TakeBuilder
*/
fun take(fileToSave: File): TakeBuilder =
TakeBuilder(this).fileToSave(fileToSave)
/** 选图
-
select a photo from system gallery or file system
-
@see PickBuilder
*/
fun pick(): PickBuilder =
PickBuilder(this)
/** 异步处理文件
-
dispose an file in background thread ,and will bind the lifecycle with current container
-
@param disposer you can also custom disposer
-
@see Disposer
*/
@JvmOverloads
fun dispose(disposer: Disposer = DefaultImageDisposer.get()): DisposeBuilder =
DisposeBuilder(this)
.disposer(disposer)
//… expand other functions
}
当选用每一个功能之后,我们返回一个Builder、选图对应当就是PickBuilder,而拍照对应当就是TakeBuilder,当然这都继承自它的基类BaseFunctionBuilder:
abstract class BaseFunctionBuilder<Builder, Result>(
internal val functionManager: FunctionManager
) {
/**
- 开始执行
*/
fun start(callback: CoCoCallBack) {
generateWorker(getParamsBuilder()).start(null,callback)
}
/**
- 获取参数Builder
*/
internal abstract fun getParamsBuilder(): Builder
/**
- 生成真正干活儿的类
*/
internal abstract fun generateWorker(builder: Builder): Worker<Builder, Result>
}
在这个基类里面定义了两个泛型参数 Builder 、Result、第一个Builder 参数的其具体实现用于封装干活时候的所有参数、一个用于承载最终完成的结果,我们来看看PickBuilder的实现:
class PickBuilder(fm: FunctionManager) :
BaseFunctionBuilder<PickBuilder, PickResult>(fm) {
internal var pickRange = Range.PICK_DICM
/**
-
在这里拓展选图特有的功能,比如是选择系统相册还是
-
@param pickRange the range you can choose
-
@see Range.PICK_DICM the system gallery
-
@see Range.PICK_CONTENT the system content file
*/
fun range(@PickRange pickRange: Int = Range.PICK_DICM): PickBuilder {
this.pickRange = pickRange
return this
}
override fun getParamsBuilder(): PickBuilder {
return this
}
override fun generateWorker(builder: PickBuilder): Worker<PickBuilder, PickResult> {
return PickPhotoWorker(functionManager.container, builder)
}
}
这里生成Worker的最终实现是生成了一个 PickPhotoWorker,里面完成了选图的最终实现, 所以现在设计我们的Worker类:
先设计接口抽象行为:
interface Worker<Builder, ResultData> {
fun start( callBack: CoCoCallBack)
}
再设计一个抽象类,这一层去持有容器引用(比如我们需要启动Activity去选图、也需要感知容器生命周期) 和 我们构建好的Builder参数:
abstract class BaseWorker<Builder, ResultData>(val iContainer: IContainer, val mParams: Builder) :
Worker<Builder, ResultData>
再看看这个选图的最终PickPhotoWorker:
class PickPhotoWorker(iContainer: IContainer, builder: PickBuilder) :
BaseWorker<PickBuilder, PickResult>(iContainer, builder) {
override fun start(
callBack: CoCoCallBack
) {
val activity = iContainer.provideActivity()
activity ?: return
pickPhoto(activity, callBack)
}
private fun pickPhoto(activity: Activity, callBack: CoCoCallBack) {
val pickIntent = Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI)
if (null === pickIntent.resolveActivity(activity.packageManager)) {
callBack.onFailed(BaseException(“activity status error”))
return
}
try {
//start activity for result
iContainer.startActivityResult(
pickIntent, Constant.REQUEST_CODE_IMAGE_PICK
) { _: Int, resultCode: Int, data: Intent? ->
handleResult(resultCode, data, callBack)
}
} catch (e: Exception) {
callBack.onFailed(e)
}
}
private fun handleResult(
resultCode: Int,
intentData: Intent?,
callBack: CoCoCallBack
) {
if (null != intentData && null != intentData.data) {
val result = PickResult()
result.originUri = intentData.data!!
callBack.onSuccess(result)
} else {
callBack.onFailed(BaseException(“null result intentData”))
}
}
}
再看看容器的接口 iContainer:
interface IContainer {
//提供activity 判断状态、或者一些需要Context特有方法的场景
fun provideActivity(): Activity?
// startActivityResult 启动activty、拿到回调结果
fun startActivityResult(intent: Intent, requestCode: Int,
callback: (requestCode: Int, resultCode: Int, data: Intent?) -> Unit
)
//获得外部容器宿主
fun getLifecycleHost(): Host
}
再看看它的具体实现当然也就是我们实际用于承载一切的的Fragment:
class AcceptResultSupportFragment : Fragment(), IContainer,
Host {
/**
- 当前生命周期状态
*/
private var current = Host.Status.INIT
private var requestCode: Int = 0
private var callback: ((requestCode: Int, resultCode: Int, data: Intent?) -> Unit)? = null
override fun startActivityResult(
intent: Intent, requestCode: Int,
callback: (requestCode: Int, resultCode: Int, data: Intent?) -> Unit
) {
this.requestCode = requestCode
this.callback = callback
startActivityForResult(intent, requestCode)
}
override fun provideActivity(): Activity? = activity
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
callback!!(requestCode, resultCode, data)
}
override fun onActivityCreated(savedInstanceState: Bundle?) {
super.onActivityCreated(savedInstanceState)
//当外部想感知容器是否销毁当时候,读取这个变量即可
current = Host.Status.LIVE
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则近万的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:Android)
题外话
我们见过很多技术leader在面试的时候,遇到处于迷茫期的大龄程序员,比面试官年龄都大。这些人有一些共同特征:可能工作了7、8年,还是每天重复给业务部门写代码,工作内容的重复性比较高,没有什么技术含量的工作。问到这些人的职业规划时,他们也没有太多想法。
其实30岁到40岁是一个人职业发展的黄金阶段,一定要在业务范围内的扩张,技术广度和深度提升上有自己的计划,才有助于在职业发展上有持续的发展路径,而不至于停滞不前。
不断奔跑,你就知道学习的意义所在!
注意:我们之前因为秋招收集的二十套一二线互联网公司Android面试真题(含BAT、小米、华为、美团、滴滴)和我自己整理Android复习笔记(包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。)
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门即可获取!
049153010)]
[外链图片转存中…(img-CldnvptN-1712049153010)]
[外链图片转存中…(img-ORgZ1lIb-1712049153011)]
[外链图片转存中…(img-rcX6tgSO-1712049153011)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:Android)
题外话
我们见过很多技术leader在面试的时候,遇到处于迷茫期的大龄程序员,比面试官年龄都大。这些人有一些共同特征:可能工作了7、8年,还是每天重复给业务部门写代码,工作内容的重复性比较高,没有什么技术含量的工作。问到这些人的职业规划时,他们也没有太多想法。
其实30岁到40岁是一个人职业发展的黄金阶段,一定要在业务范围内的扩张,技术广度和深度提升上有自己的计划,才有助于在职业发展上有持续的发展路径,而不至于停滞不前。
不断奔跑,你就知道学习的意义所在!
注意:我们之前因为秋招收集的二十套一二线互联网公司Android面试真题(含BAT、小米、华为、美团、滴滴)和我自己整理Android复习笔记(包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。)
[外链图片转存中…(img-KNIzikCy-1712049153011)]