修改注释问题

This commit is contained in:
2022-07-27 15:46:28 +08:00
parent a0cfba5dd9
commit 1c4ca8a721
16 changed files with 54 additions and 92 deletions

View File

@@ -2,14 +2,14 @@ package com.synebula.gaea.data.serialization
/** /**
* 序列化器 * 序列化器
* @param <S> 源数据类型 * @param S 源数据类型
*/ */
interface IDeserializer<S> { interface IDeserializer<S> {
/** /**
* 反序列化 * 反序列化
* *
* @param <T> 目标数据类型 * @param T 目标数据类型
* @param src 源数据 * @param src 源数据
* @param targetClass 目标对象。 * @param targetClass 目标对象。
* @return 目标数据 * @return 目标数据

View File

@@ -2,13 +2,13 @@ package com.synebula.gaea.data.serialization
/** /**
* 序列化器 * 序列化器
* @param <T> 目标数据类型 * @param T 目标数据类型
*/ */
interface ISerializer<T> { interface ISerializer<T> {
/** /**
* 序列化 * 序列化
* @param <S> 源数据类型 * @param S 源数据类型
* *
* @param src 源数据 * @param src 源数据
* @return 目标数据 * @return 目标数据

View File

@@ -36,7 +36,7 @@ interface ISpecificRepository<TAggregateRoot : IAggregateRoot<ID>, ID> {
/** /**
* 通过id删除该条数据 * 通过id删除该条数据
* *
* @param id * @param id 对象ID。
* @return * @return
*/ */
fun remove(id: ID) fun remove(id: ID)

View File

@@ -10,21 +10,21 @@ import com.synebula.gaea.domain.model.IAggregateRoot
interface IContext : IUnitOfWork { interface IContext : IUnitOfWork {
/** /**
* 将指定的聚合根标注为“新建”状态。 * 将指定的聚合根标注为“新建”状态。
* @param obj * @param obj 聚合根
*/ */
fun <TType : IAggregateRoot<ID>, ID> add(obj: TType) fun <T : IAggregateRoot<ID>, ID> add(obj: T)
/** /**
* 将指定的聚合根标注为“更改”状态。 * 将指定的聚合根标注为“更改”状态。
* *
* @param obj * @param obj 聚合根
*/ */
fun <TType : IAggregateRoot<ID>, ID> update(obj: TType) fun <T : IAggregateRoot<ID>, ID> update(obj: T)
/** /**
* 将指定的聚合根标注为“删除”状态。 * 将指定的聚合根标注为“删除”状态。
* *
* @param obj * @param obj 聚合根
*/ */
fun <TType : IAggregateRoot<ID>, ID> remove(obj: TType) fun <T : IAggregateRoot<ID>, ID> remove(obj: T)
} }

View File

@@ -5,19 +5,12 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
* 规约对象的类型 * @param left 表达式左侧规约对象。
* @param right 表达式右侧规约对象。
*/ */
class AndNotSpecification<T> class AndNotSpecification<T>(left: ISpecification<T>, right: ISpecification<T>) :
/** CompositeSpecification<T>(left, right) {
* 构造一个新的混合规约对象。
*
* @param left
* 表达式左侧规约对象。
* @param right
* 表达式右侧规约对象。
*/
(left: ISpecification<T>, right: ISpecification<T>) : CompositeSpecification<T>(left, right) {
override fun isSatisfiedBy(obj: T): Boolean { override fun isSatisfiedBy(obj: T): Boolean {
return left.isSatisfiedBy(obj) && NotSpecification(right).isSatisfiedBy(obj) return left.isSatisfiedBy(obj) && NotSpecification(right).isSatisfiedBy(obj)

View File

@@ -5,19 +5,11 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
* 规约对象的类型 * @param left 表达式左侧规约对象。
* @param right 表达式右侧规约对象。
*/ */
class AndSpecification<T> class AndSpecification<T>(left: ISpecification<T>, right: ISpecification<T>) : CompositeSpecification<T>(left, right) {
/**
* 构造一个新的混合规约对象。
*
* @param left
* 表达式左侧规约对象。
* @param right
* 表达式右侧规约对象。
*/
(left: ISpecification<T>, right: ISpecification<T>) : CompositeSpecification<T>(left, right) {
override fun isSatisfiedBy(obj: T): Boolean { override fun isSatisfiedBy(obj: T): Boolean {
return left.isSatisfiedBy(obj) && right.isSatisfiedBy(obj) return left.isSatisfiedBy(obj) && right.isSatisfiedBy(obj)

View File

@@ -5,8 +5,7 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
* 规约对象的类型。
*/ */
class AnySpecification<T> : Specification<T>() { class AnySpecification<T> : Specification<T>() {

View File

@@ -4,23 +4,11 @@ package com.synebula.gaea.domain.repository.specifications
* 实现了接口ICompositeSpecification<T>,混合规约的基类。 * 实现了接口ICompositeSpecification<T>,混合规约的基类。
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
</T> */ * @param left 表达式左侧规约对象。
abstract class CompositeSpecification<T> * @param right 表达式右侧规约对象。
/**
* 构造一个新的混合规约对象。
*
* @param left
* 表达式左侧规约对象。
* @param right
* 表达式右侧规约对象。
*/ */
( abstract class CompositeSpecification<T>(
/** override val left: ISpecification<T>,
* 表达式左侧规约对象。 override val right: ISpecification<T>
*/ ) : Specification<T>(), ICompositeSpecification<T>
override val left: ISpecification<T>,
/**
* 表达式右侧规约对象。
*/
override val right: ISpecification<T>) : Specification<T>(), ICompositeSpecification<T>

View File

@@ -5,8 +5,7 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
* 规约对象的类型。
*/ */
interface ICompositeSpecification<T> : ISpecification<T> { interface ICompositeSpecification<T> : ISpecification<T> {

View File

@@ -5,14 +5,13 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
*/ */
interface ISpecification<T> { interface ISpecification<T> {
/** /**
* 判断是否符合条件。 * 判断是否符合条件。
* *
* @param obj * @param obj 规约类型的对象。
* 规约类型的对象。
* @return 符合条件的返回True。 * @return 符合条件的返回True。
*/ */
fun isSatisfiedBy(obj: T): Boolean fun isSatisfiedBy(obj: T): Boolean
@@ -20,8 +19,7 @@ interface ISpecification<T> {
/** /**
* 结合当前规约对象和另一规约对象进行与判断。 * 结合当前规约对象和另一规约对象进行与判断。
* *
* @param other * @param other 需要进行与结合的另一个规约对象。
* 需要进行与结合的另一个规约对象。
* @return 结合后的规约对象。 * @return 结合后的规约对象。
*/ */
fun and(other: ISpecification<T>): ISpecification<T> fun and(other: ISpecification<T>): ISpecification<T>
@@ -29,8 +27,7 @@ interface ISpecification<T> {
/** /**
* 结合当前规约对象和另一规约对象进行或判断。 * 结合当前规约对象和另一规约对象进行或判断。
* *
* @param other * @param other 需要进行或结合的另一个规约对象。
* 需要进行或结合的另一个规约对象。
* @return 结合后的规约对象。 * @return 结合后的规约对象。
*/ */
fun or(other: ISpecification<T>): ISpecification<T> fun or(other: ISpecification<T>): ISpecification<T>
@@ -38,8 +35,7 @@ interface ISpecification<T> {
/** /**
* 结合当前规约对象和另一规约对象进行与且非判断 * 结合当前规约对象和另一规约对象进行与且非判断
* *
* @param other * @param other 需要进行非结合的另一个规约对象。
* 需要进行非结合的另一个规约对象。
* @return 结合后的规约对象。 * @return 结合后的规约对象。
*/ */
fun andNot(other: ISpecification<T>): ISpecification<T> fun andNot(other: ISpecification<T>): ISpecification<T>
@@ -47,8 +43,7 @@ interface ISpecification<T> {
/** /**
* 结合当前规约对象和另一规约对象进行或非判断。 * 结合当前规约对象和另一规约对象进行或非判断。
* *
* @param other * @param other 需要进行或非结合的另一个规约对象。
* 需要进行或非结合的另一个规约对象。
* @return 结合后的规约对象。 * @return 结合后的规约对象。
*/ */
fun orNot(other: ISpecification<T>): ISpecification<T> fun orNot(other: ISpecification<T>): ISpecification<T>

View File

@@ -5,8 +5,7 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
* 规约对象的类型。
*/ */
class NoneSpecification<T> : Specification<T>() { class NoneSpecification<T> : Specification<T>() {

View File

@@ -5,7 +5,7 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> 规约对象的类型。 * @param T 规约对象的类型。
* *
* @param spec 需要逆反的规约对象。 * @param spec 需要逆反的规约对象。
* *

View File

@@ -5,19 +5,12 @@ package com.synebula.gaea.domain.repository.specifications
* *
* @author alex * @author alex
* *
* @param <T> * @param T 规约对象的类型。
* 规约对象的类型 * @param left 表达式左侧规约对象。
* @param right 表达式右侧规约对象。
*/ */
class OrNotSpecification<T> class OrNotSpecification<T>(left: ISpecification<T>, right: ISpecification<T>) :
/** CompositeSpecification<T>(left, right) {
* 构造一个新的混合规约对象。
*
* @param left
* 表达式左侧规约对象。
* @param right
* 表达式右侧规约对象。
*/
(left: ISpecification<T>, right: ISpecification<T>) : CompositeSpecification<T>(left, right) {
override fun isSatisfiedBy(obj: T): Boolean { override fun isSatisfiedBy(obj: T): Boolean {
return left.isSatisfiedBy(obj) || NotSpecification(right).isSatisfiedBy(obj) return left.isSatisfiedBy(obj) || NotSpecification(right).isSatisfiedBy(obj)

View File

@@ -1,16 +1,14 @@
package com.synebula.gaea.domain.repository.specifications package com.synebula.gaea.domain.repository.specifications
class OrSpecification<T>
/** /**
* 构造一个新的混合规约对象。 * 构造一个新的混合规约对象。
* *
* @param left * @param T 规约对象的类型。
* 表达式左侧规约对象。 *
* @param right * @param left 表达式左侧规约对象。
* 表达式右侧规约对象。 * @param right 表达式右侧规约对象。
*/ */
(left: ISpecification<T>, right: ISpecification<T>) : CompositeSpecification<T>(left, right) { class OrSpecification<T>(left: ISpecification<T>, right: ISpecification<T>) : CompositeSpecification<T>(left, right) {
override fun isSatisfiedBy(obj: T): Boolean { override fun isSatisfiedBy(obj: T): Boolean {
return left.isSatisfiedBy(obj) || right.isSatisfiedBy(obj) return left.isSatisfiedBy(obj) || right.isSatisfiedBy(obj)
} }

View File

@@ -1,5 +1,11 @@
package com.synebula.gaea.domain.repository.specifications package com.synebula.gaea.domain.repository.specifications
/**
* 抽象的的规约对象。
*
* @param T 规约对象的类型。
*
*/
abstract class Specification<T> : ISpecification<T> { abstract class Specification<T> : ISpecification<T> {
abstract override fun isSatisfiedBy(obj: T): Boolean abstract override fun isSatisfiedBy(obj: T): Boolean

View File

@@ -38,7 +38,7 @@ class ClassScanner(private var packageName: String) {
* 构造方法。 * 构造方法。
* *
* @param packageName 需要扫描的包名。 * @param packageName 需要扫描的包名。
* @param classFilter * @param classFilter 过滤器
*/ */
constructor(packageName: String, vararg classFilter: IClassFilter) : this(packageName) { constructor(packageName: String, vararg classFilter: IClassFilter) : this(packageName) {
this.classFilters = classFilter this.classFilters = classFilter