All Downloads are FREE. Search and download functionalities are using the official Maven repository.
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
com.tairitsu.ignotus.serializer.vo.BaseResponse.kt Maven / Gradle / Ivy
package com.tairitsu.ignotus.serializer.vo
import com.tairitsu.ignotus.exception.relation.RelationshipInvalidException
import com.tairitsu.ignotus.serializer.Serializer
/**
* 实体类基本定义
*
* 在本项目中所有的需要被序列化为客户端可见的信息的实体类均从本类继承。
*/
abstract class BaseResponse {
/**
* JSON:API 规范中 `type` 字段
*/
abstract val modelType: String
/**
* 本类型的 JSON:API 规范中的 `attributes` 字段的序列化类。
* 本属性的值为一个从 [Serializer] 中继承的类。
*/
open val modelSerializer: Class<*> = Serializer::class.java
/**
* JSON:API 规范中 `id` 字段
*/
abstract val id: String
/**
* JSON:API 规范中 `relationship` 字段
*/
val relationships = mutableMapOf()
/**
* 给当前对象添加一个关系
*
* @param [key] 为欲添加关系的关系名
* @param [value] 为欲添加关系的被关联对象
*/
fun setRelationship(key: String, value: BaseResponse?) {
this.relationships[key] = value
}
/**
* 给当前对象添加一个关系
*
* @param [key] 为欲添加关系的关系名
* @param [value] 为欲添加关系的被关联对象
*/
fun setRelationship(key: String, value: Collection?) {
this.relationships[key] = value
}
/**
* 给当前对象添加一个关系
*
* @param [key] 为欲添加关系的关系名
* @param [value] 为欲添加关系的被关联对象，该值必须为 `null`， [BaseResponse] 或 [BaseResponse] 的一个 [Collection]。
*/
fun setRelationship(key: String, value: Any?) {
if (value is BaseResponse) {
this.relationships[key] = value
} else if (value is Collection<*>) {
if (value.isEmpty()) {
this.relationships[key] = setOf()
} else {
val t = value.first()
if (t is BaseResponse) {
this.relationships[key] = value
} else {
throw RelationshipInvalidException(RelationshipInvalidException.Reason.INVALID_RELATED_COLLECTION, mapOf(
"type" to this.modelType,
"key" to key,
))
}
}
} else if (value == null) {
this.relationships[key] = null
} else {
throw RelationshipInvalidException(RelationshipInvalidException.Reason.INVALID_RELATED_OBJECT, mapOf(
"type" to this.modelType,
"key" to key,
))
}
}
/**
* 获取当前对象的一个关系
*
* @param [key] 为欲获取关系的关系名
* @return 返回这个关系的被关联对象，值可能为 `null`、[BaseResponse] 或 [BaseResponse] 的一个 [Collection]。
*/
fun getRelationship(key: String): Any? {
return this.relationships[key]
}
/**
* 给当前对象载入一个关系
*
* @param [relation] 为欲载入关系的关系名，请确认在当前对象存在名为 `"related" + relation` 的方法，
* 并且该方法的返回值为 `null`， [BaseResponse] 或 [BaseResponse] 的一个 [Collection]。
* 若不存在，则报 [RelationshipInvalidException] 异常。
* 如： [relation] = friends 则要存在一个名为 getFriends 的方法
* @param [overwrite] 为若该关系已被载入，是否覆盖掉原有的关系信息。一般取 `false`。
*/
fun loadRelationship(relation: String, overwrite: Boolean = false) {
val path = relation.split('.')
if (path.isEmpty()) {
throw RelationshipInvalidException(RelationshipInvalidException.Reason.EMPTY_RELATIONSHIP_NAME, mapOf("type" to this.modelType))
}
val aRelation = path[0]
if (this.relationships[aRelation] == null || overwrite) {
val type = this.javaClass
val functionName: String = if (aRelation[0] in 'a'..'z') {
"related" + (aRelation[0] - 0x20) + aRelation.substring(1)
} else {
"related$aRelation"
}
try {
val aMethod = type.getMethod(functionName)
val value = aMethod.invoke(this)
this.setRelationship(aRelation, value)
} catch (e: NoSuchMethodException) {
throw RelationshipInvalidException(RelationshipInvalidException.Reason.RELATIONSHIP_METHOD_NOT_FOUND, mapOf(
"class" to type.name,
"method" to functionName,
"type" to modelType,
"relation" to relation
))
} catch (e: SecurityException) {
throw RelationshipInvalidException(RelationshipInvalidException.Reason.RELATIONSHIP_METHOD_NOT_FOUND, mapOf(
"class" to type.name,
"method" to functionName,
"type" to modelType,
"relation" to relation
))
}
}
if (path.size > 1) {
val next = path.subList(1, path.size).joinToString(separator = ".")
val value = this.relationships[aRelation]
if (value is BaseResponse) {
value.loadRelationship(next, overwrite)
} else if (value is Collection<*> && value.isNotEmpty()) {
value.forEach(fun(s) {
val v = s as BaseResponse
v.loadRelationship(next, overwrite)
})
}
}
}
/**
* 给当前对象载入一组关系
*
* @param [relations] 为欲载入关系的关系名，具体介绍见 [BaseResponse.loadRelationship]
* @param [overwrite] 为若该关系已被载入，是否覆盖掉原有的关系信息。一般取 `false`。
*/
fun loadRelationship(relations: Set, overwrite: Boolean = false) {
relations.forEach { s ->
this.loadRelationship(s, overwrite)
}
}
companion object {
/**
* 给目标对象载入一组关系
*
* @param [model] 目标对象
* @param [relations] 为欲载入关系的关系名，具体介绍见 [BaseResponse.loadRelationship]
* @param [overwrite] 为若该关系已被载入，是否覆盖掉原有的关系信息。一般取 `false`。
*/
fun loadRelationship(
model: BaseResponse,
relations: Set,
overwrite: Boolean = false,
) {
relations.forEach { s ->
model.loadRelationship(s, overwrite)
}
}
/**
* 给目标对象载入一个关系
*
* @param [model] 目标对象
* @param [relation] 为欲载入关系的关系名，具体介绍见 [BaseResponse.loadRelationship]
* @param [overwrite] 为若该关系已被载入，是否覆盖掉原有的关系信息。一般取 `false`。
*/
fun loadRelationship(
model: BaseResponse,
relation: String,
overwrite: Boolean = false,
) {
model.loadRelationship(relation, overwrite)
}
/**
* 给目标对象载入一组关系
*
* @param [model] 目标对象
* @param [relations] 为欲载入关系的关系名，具体介绍见 [BaseResponse.loadRelationship]
* @param [overwrite] 为若该关系已被载入，是否覆盖掉原有的关系信息。一般取 `false`。
*/
fun loadRelationship(model: Collection<*>, relations: Set, overwrite: Boolean = false) {
relations.forEach { s ->
loadRelationship(model, s, overwrite)
}
}
/**
* 给目标对象载入一个关系
*
* @param [model] 目标对象
* @param [relation] 为欲载入关系的关系名，具体介绍见 [BaseResponse.loadRelationship]
* @param [overwrite] 为若该关系已被载入，是否覆盖掉原有的关系信息。一般取 `false`。
*/
fun loadRelationship(model: Collection<*>, relation: String, overwrite: Boolean = false) {
model.forEach { c ->
val s = c as BaseResponse
s.loadRelationship(relation, overwrite)
}
}
}
}
