致敬Glide-借用其思想设计一个拍照选图控件

内容提要

本文内容较长,包含一个功能整个重构从想法到设计以及落地的完整过程,通过阅读本文你可以收获:

  • 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)

需求分析
  1. 我需要实现调用系统的相机、相册、裁剪、无非都需要通过intent来启动Activity,如果我采用Fragment的方式一来可以将其作为载体去启动Activity和重写onActivityResult接收返回的数据的方法,从而无须在业务层重写,从而减少代码入侵解决第一个痛点、而来可以借鉴Glide模拟生命周期的方式在后期处理图片比如压缩、旋转等异步操作的时候自动感知外部容器生命周期,从而减少业务代码

  2. Glide的 功能对应基类Builder提供基本方法、然后在子类拓展其特有功能的方法可以借鉴到这个场景下:执行每个功能产生相关的功能特性Builder、然后在父类方法中收拢,最终拿到结果,所以设计了如下UML图:

UML 分析:
  1. CoCo.with 方法传入当前容器,指定当前的工作场地[在哪里 Where] ,返回一个FunctionManager 对象,这个对象提供了我们当前场地能提供的基本方法,也就是我们接下来的事情[做什么 whate]拍照(take)、选图(pick)、裁剪(crop)、处理(dispose) 等功能均在此类提供和拓展。

  2. 当FunctionManager调用其中某一个操作符时候,产生其对应的Builder对象,比如调用了take功能,我们返回一个 TakerBuilder对象,因为是拍照功能,我们可以在这里提供摄像头面向(cameraFace)、拍照结果写入文件(fileToSave)等参数、同理如果你选择了pick 方法,则可以在这里拓展图片选择范围(range)等方法、而最终无论最终是哪种子功能Builder、它们都继承自BaseFunctionBuilder、而在这个父类中提供了start的方法,无论通过哪种子类拓展其方法来拼装参数、都可以通过父类的start 方法执行到下一步,即保证了一行代码的整洁性、又保证了子类之间方法的隔离,符合面向对象设计思想,便于后续拓展和维护 。

  3. 通过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工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则近万的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《Android移动开发全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

img

img

img

img

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频

如果你觉得这些内容对你有帮助,可以扫码领取!!!!

总结

笔者之前工作是在金融公司可能并不是特别追求技术,而笔者又是喜欢追求技术的人,所以格格不入,只能把目标放在互联网大厂了。也希望大家都去敢于尝试和追逐自己的梦想!
BATJ大厂Android高频面试题

觉得有收获的记得点赞,关注+收藏哦!你们的点赞就是我的动力!
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》点击传送门,即可免费领取!

roid工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则近万的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!**

因此收集整理了一份《Android移动开发全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

[外链图片转存中…(img-OqPqmHfz-1711298936278)]

[外链图片转存中…(img-12dS9VL4-1711298936279)]

[外链图片转存中…(img-9W3WTazq-1711298936279)]

[外链图片转存中…(img-bOcH6nN0-1711298936280)]

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频

如果你觉得这些内容对你有帮助,可以扫码领取!!!!

总结

笔者之前工作是在金融公司可能并不是特别追求技术,而笔者又是喜欢追求技术的人,所以格格不入,只能把目标放在互联网大厂了。也希望大家都去敢于尝试和追逐自己的梦想!
BATJ大厂Android高频面试题

[外链图片转存中…(img-HaglcfI0-1711298936280)]

[外链图片转存中…(img-k0HZnDGn-1711298936281)]

[外链图片转存中…(img-UAeGr25A-1711298936281)]

[外链图片转存中…(img-eZUfsqQO-1711298936281)]

觉得有收获的记得点赞,关注+收藏哦!你们的点赞就是我的动力!
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》点击传送门,即可免费领取!

  • 16
    点赞
  • 24
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值