【KRouter】一个简单且轻量级的Kotlin Routing框架

【KRouter】一个简单且轻量级的Kotlin Routing框架

KRouter（Kotlin-Router）是一个简单而轻量级的Kotlin路由框架。

具体来说，KRouter是一个通过URI来发现接口实现类的框架。它的使用方式如下：

val homeScreen = KRouter.route<Screen>("screen/home?name=zhangke")

之所以这样做，是因为在使用Voyager一段时间后，我发现模块之间的通信不够灵活，需要一些配置，而且使用DeepLink有点奇怪，所以我更喜欢使用路由来实现模块之间的通信，于是我开发了这个库。

这个库主要通过KSP、ServiceLoader和反射来实现。

使用方法

上述代码基本上就是使用的全部内容。

如前所述，这是用于发现接口实现类并通过URI匹配目标的库，因此我们首先需要定义一个接口。

interface Screen

然后我们有一个包含许多独立模块的项目，这些模块实现了这个接口，每个模块都不同，我们需要通过它们各自的路由（即URI）来区分它们。

// HomeModule
@Destination("screen/home")
class HomeScreen(@Router val router: String = "") : Screen// ProfileModule
@Destination("screen/profile")
class ProfileScreen : Screen {@Routerlateinit var router: String
}

现在我们有两个独立的模块，它们各自拥有自己的屏幕（Screens），并且它们都有自己的路由地址。

val homeScreen = KRouter.route<Screen>("screen/home?name=zhangke")
val profileScreen = KRouter.route<Screen>("screen/profile?name=zhangke")

现在，您可以通过KRouter获取这两个对象，并且这些对象中的路由属性将被分配给对KRouter.route的特定调用的路由。

现在，您可以在HomeScreen和ProfileScreen中获取通过URI传递的参数，并且可以使用这些参数进行一些初始化和其他操作。

@Destination

@Destination 注解用于标记目的地（Destination），包含两个参数：

  • route：目的地的唯一标识路由地址，必须是 URI 类型的字符串，不需要包含查询参数。
  • type：目的地的接口。如果类只有一个父类或接口，您无需设置此参数，它可以自动推断。但如果类有多个父类或接口，您需要通过 type 参数明确指定。

需要特别注意的是，被 @Destination 注解标记的类必须包含一个无参数构造函数，否则 ServiceLoader 无法创建对象。对于 Kotlin 类，您还需要确保构造函数的每个输入参数都具有默认值。

@Router

@Router 注解用于指定目的地类的哪个属性用于接收传入的路由参数，该属性必须是字符串类型。

使用此注解标记的属性将自动分配一个值，或者您可以不设置注解。例如，在上述示例中，当创建 HomeScreen 对象时，其 router 字段的值将自动设置为 screen/home?name=zhangke。

特别要注意，如果被@Router注解的属性不在构造函数中，那么该属性必须声明为可修改的，即在 Kotlin 中应为 var 修饰的可变属性。

KRouter 是一个 Kotlin Object 类，它只包含一个函数：

inline fun <reified T : Any> route(router: String): T?

此函数接受一个泛型类型和一个路由地址。路由地址可以包含或不包含查询参数，但在匹配目的地时，查询参数将被忽略。匹配成功后，将使用此 URI 构造对象，并将 URI 传递给目标对象中的 @router 注解字段。

集成

首先，您需要在项目中集成 KSP。

https://kotlinlang.org/docs/ksp-overview.html

然后，添加以下依赖项：

// 模块的 build.gradle.kts
implementation("com.github.0xZhangKe.KRouter:core:0.1.5")
ksp("com.github.0xZhangKe.KRouter:compiler:0.1.5")

由于使用了 ServiceLoader，您还需要设置 SourceSet。

// 模块的 build.gradle.kts
kotlin {sourceSets.main {resources.srcDir("build/generated/ksp/main/resources")}
}

可能还需要添加 JitPack 仓库：

maven { setUrl("https://jitpack.io") }

工作原理

正如前面所提到的，KRouter 主要通过 ServiceLoader + KSP + 反射来实现。

这个框架由两个主要部分组成：编译阶段和运行时阶段。

KSP 插件
与 KSP 插件相关的代码位于编译器模块中。

KSP 插件的主要任务是根据 Destination 注解生成 ServiceLoader 的服务文件。

KSP 代码的其余部分基本相同，主要工作包括首先配置服务文件，然后根据注解获取类，最后通过 Visitor 进行迭代。您可以直接查看 KRouterVisitor 来了解更多细节。

override fun visitClassDeclaration(classDeclaration: KSClassDeclaration, data: Unit) {val superTypeName = findSuperType(classDeclaration)writeService(superTypeName, classDeclaration)
}

visitClassDeclaration 方法主要有两个主要功能，第一是获取父类，第二是编写或创建服务文件。

流程首先是获取指定类型的父类，如果没有父类，且只有一个父类时，可以直接返回，否则会引发异常。

// find super-type by type parameter
val routerAnnotation = classDeclaration.requireAnnotation<Destination>()
val typeFromAnnotation = routerAnnotation.findArgumentTypeByName("type")?.takeIf { it != badTypeName }// find single-type
if (classDeclaration.superTypes.isSingleElement()) {val superTypeName = classDeclaration.superTypes.iterator().next().typeQualifiedName?.takeIf { it != badSuperTypeName }if (!superTypeName.isNullOrEmpty()) {return superTypeName}
}

一旦获取到父类，我们需要创建一个文件，其文件名以接口或抽象类的权限作为所需的 ServiceLoader 文件名。

然后，我们将已实现类的权限名称写入该文件。

val resourceFileName = ServicesFiles.getPath(superTypeName)
val serviceClassFullName = serviceClassDeclaration.qualifiedName!!.asString()
val existsFile = environment.codeGenerator.generatedFile.firstOrNull { generatedFile ->generatedFile.canonicalPath.endsWith(resourceFileName)}
if (existsFile != null) {val services = existsFile.inputStream().use { ServicesFiles.readServiceFile(it) }services.add(serviceClassFullName)existsFile.outputStream().use { ServicesFiles.writeServiceFile(services, it) }
} else {environment.codeGenerator.createNewFile(dependencies = Dependencies(aggregating = false, serviceClassDeclaration.containingFile!!),packageName = "",fileName = resourceFileName,extensionName = "",).use {ServicesFiles.writeServiceFile(setOf(serviceClassFullName), it)}
}

KRouter主要有三个关键功能：

  1. 通过ServiceLoader获取接口的所有实现类。
  2. 将特定的目标类与URI进行匹配。
  3. 从URI构建目标类对象。
    第一件事非常简单：
inline fun <reified T> findServices(): List<T> {val clazz = T::class.javareturn ServiceLoader.load(clazz, clazz.classLoader).iterator().asSequence().toList()
}

一旦你获取到它，你就可以开始与URL进行匹配。

这个匹配的方式是获取每个目标类的Destination注解中的路由字段，然后将其与路由进行比较。

fun findServiceByRouter(serviceClassList: List<Any>,router: String,
): Any? {val routerUri = URI.create(router).baseUrival service = serviceClassList.firstOrNull {val serviceRouter = getRouterFromClassAnnotation(it::class)if (serviceRouter.isNullOrEmpty().not()) {val serviceUri = URI.create(serviceRouter!!).baseUriserviceUri == routerUri} else {false}}return service
}private fun getRouterFromClassAnnotation(targetClass: KClass<*>): String? {val routerAnnotation = targetClass.findAnnotation<Destination>() ?: return nullreturn routerAnnotation.router
}

匹配策略是忽略查询字段，只需通过baseUri进行匹配即可。

接下来的步骤是创建对象。有两种情况需要考虑：

第一种情况是@Router注解位于构造函数中，在这种情况下，需要再次使用构造函数创建对象。

第二种情况是@Router注解位于普通属性中。在这种情况下，可以直接使用ServiceLoader创建的对象，然后将值分配给它。

如果@Router注解位于构造函数中，您可以首先获取routerParameter，然后使用PrimaryConstructor重新创建对象。

private fun fillRouterByConstructor(router: String, serviceClass: KClass<*>): Any? {val primaryConstructor = serviceClass.primaryConstructor?: throw IllegalArgumentException("KRouter Destination class must have a Primary-Constructor!")val routerParameter = primaryConstructor.parameters.firstOrNull { parameter ->parameter.findAnnotation<Router>() != null} ?: return nullif (routerParameter.type != stringKType) errorRouterParameterType(routerParameter)return primaryConstructor.callBy(mapOf(routerParameter to router))
}

如果它是一个普通的变量属性，首先获取属性，然后进行一些类型权限和其他检查，然后调用setter方法分配值。

private fun fillRouterByProperty(router: String,service: Any,serviceClass: KClass<*>,
): Any? {val routerProperty = serviceClass.findRouterProperty() ?: return nullfillRouterToServiceProperty(router = router,service = service,property = routerProperty,)return service
}private fun KClass<*>.findRouterProperty(): KProperty<*>? {return declaredMemberProperties.firstOrNull { property ->val isRouterProperty = property.findAnnotation<Router>() != nullisRouterProperty}
}private fun fillRouterToServiceProperty(router: String,service: Any,property: KProperty<*>,
) {if (property !is KMutableProperty<*>) throw IllegalArgumentException("@Router property must be non-final!")if (property.visibility != KVisibility.PUBLIC) throw IllegalArgumentException("@Router property must be public!")val setter = property.setterval propertyType = setter.parameters[1]if (propertyType.type != stringKType) errorRouterParameterType(propertyType)property.setter.call(service, router)
}

上面是关于KRouter的全部内容，希望对你有所帮助！

GitHub

https://github.com/0xZhangKe/KRouter

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/98970.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

如何设计一个好的游戏剧情（Part 1：主题的设定）

如何设计一个好的游戏剧情（Part 1：主题的设定）

提醒&#xff1a;此教程仅仅为作者的一些经验和感悟&#xff0c;非专业教程&#xff0c;若介意请前往网上搜集或者书本查阅相关资料&#xff01; 前言&#xff1a;游戏为什么要有剧情——游戏剧情的重要性 游戏剧情的重要性难以低估。一个精彩的剧情可以让玩家感受到强烈的情感…
阅读更多...
SpringMVC入门详细介绍

SpringMVC入门详细介绍

一. SpringMVC简介 Spring MVC是一个基于Java的实现了MVC设计模式的请求驱动类型的轻量级Web框架&#xff0c;通过把Model&#xff0c;View&#xff0c;Controller分离&#xff0c;将web层进行职责解耦&#xff0c;把复杂的web应用分成逻辑清晰的几部分&#xff0c;简化开发&a…
阅读更多...
巨人互动|游戏出海游戏出海效果怎样？

巨人互动|游戏出海游戏出海效果怎样？

游戏出海是指将原本面向国内市场的游戏产品进行调整和优化&#xff0c;以适应海外市场的需求&#xff0c;并进行推广和销售。下面小编讲讲关于游戏出海对于游戏效果的影响的一些讨论点。 1、市场扩大 通过游戏出海&#xff0c;可以将游戏产品的目标受众从国内扩展到全球范围内…
阅读更多...
LLM大模型推理加速 vLLM；Qwen vLLM使用案例

LLM大模型推理加速 vLLM；Qwen vLLM使用案例

参考&#xff1a; https://github.com/vllm-project/vllm https://zhuanlan.zhihu.com/p/645732302 https://vllm.readthedocs.io/en/latest/getting_started/quickstart.html ##文档 1、vLLM 这里使用的cuda版本是11.4&#xff0c;tesla T4卡 加速原理&#xff1a; Paged…
阅读更多...
AI智剪，批量剪辑视频的神器

AI智剪，批量剪辑视频的神器

在数字时代&#xff0c;视频剪辑已经成为各种行业中的重要工作。然而&#xff0c;传统的视频剪辑方式既耗时又费力&#xff0c;常常需要大量的时间和人力。幸运的是&#xff0c;随着人工智能技术的发展&#xff0c;我们有了新的解决方案——AI智剪软件。 AI智剪软件&#xff0c…
阅读更多...
SVN基本使用笔记——广州云科

SVN基本使用笔记——广州云科

简介 SVN是什么? 代码版本管理工具 它能记住你每次的修改 查看所有的修改记录 恢复到任何历史版本 恢复己经删除的文件 SVN跟Git比&#xff0c;有什么优势 使用简单&#xff0c;上手快 目录级权限控制&#xff0c;企业安全必备 子目录Checkout&#xff0c;减少不必要的文件检出…
阅读更多...
数学建模--一维插值法的多种插值方式的Python实现

数学建模--一维插值法的多种插值方式的Python实现

目录 1.算法流程步骤 2.算法核心代码 3.算法效果展示 1.算法流程步骤 #算法的核心就是利用scipy中的interpolate来完成工作 #一共是5种一维插值算法形式: #插值方法&#xff1a;1.阶梯插值 2.线性插值 3.2阶样条插值 4.3阶样条插值 #"nearest"阶梯插值 #"zero&…
阅读更多...
Beats：安装及配置 Metricbeat （二）- 8.x

Beats：安装及配置 Metricbeat （二）- 8.x

这篇文章是继文章 “Beats&#xff1a;安装及配置 Metricbeat &#xff08;一&#xff09;- 8.x” 的续篇。你可以先阅读之前的那篇文章再继续阅读这篇文章。我们在这篇文章中继续之前的探讨。 使用 fingerprint 来代替证书 在实际的使用中&#xff0c;我们需要从 Elasticsear…
阅读更多...
骨传导和普通耳机哪个危害大？哪款更值得入手一些？

骨传导和普通耳机哪个危害大？哪款更值得入手一些？

先说结论&#xff0c;普通耳机对人体的危害要比骨传导耳机大一些&#xff0c;区分方式也很简单&#xff0c;想要了解骨传导耳机和普通耳机哪个对人体的危害更大&#xff0c;首先就要了解它们的传声方式&#xff0c;普通耳机的传声原理很简单&#xff0c;利用空气传声&#xff0…
阅读更多...
【系统设计系列】 回顾可扩展性

【系统设计系列】 回顾可扩展性

系统设计系列初衷 System Design Primer&#xff1a; 英文文档 GitHub - donnemartin/system-design-primer: Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards. 中文版&#xff1a; https://github.com/donnemart…
阅读更多...
SpringBoot实现发送邮件功能

SpringBoot实现发送邮件功能

平时注册或者登录一个网站时&#xff0c;可能收到过邮件用来发送验证码等&#xff0c;邮件在项目中经常会被用到&#xff0c;比如邮件发送通知&#xff0c;比如通过邮件注册&#xff0c;认证&#xff0c;找回密码&#xff0c;系统报警通知&#xff0c;报表信息等。 发送邮件用…
阅读更多...
Vue组件之间传值

Vue组件之间传值

聊一聊vue里面组件之间的传值 首先总结一下vue里面传值的几种关系&#xff1a; 如上图所示, A与B、A与C、B与D、C与F组件之间是父子关系&#xff1b; B与C之间是兄弟关系&#xff1b;A与D、A与E之间是隔代关系&#xff1b; D与F是堂兄关系&#xff0c;针对以上关系 我们把组件…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023