EffectDefinitionRepository.kt

package io.github.lishangbu.avalon.dataset.repository

import io.github.lishangbu.avalon.dataset.entity.*
import io.github.lishangbu.avalon.dataset.entity.dto.EffectDefinitionSpecification
import io.github.lishangbu.avalon.dataset.entity.dto.EffectDefinitionView
import org.babyfish.jimmer.Page
import org.babyfish.jimmer.spring.repository.KRepository
import org.babyfish.jimmer.spring.repository.orderBy
import org.babyfish.jimmer.sql.kt.ast.expression.eq
import org.springframework.data.domain.Pageable
import org.springframework.data.domain.Sort
import org.springframework.stereotype.Repository

/**
 * 战斗效果定义仓储。
 *
 * 这层负责把单表 `effect_definition` 暴露成 dataset 模块统一的 DTO-first 查询入口，
 * 方便管理端直接做分页、列表和保存后的视图重载。
 */
@Repository
interface EffectDefinitionRepository : KRepository<EffectDefinition, Long> {
    /** 按条件查询效果定义列表视图。 */
    fun listViews(specification: EffectDefinitionSpecification?): List<EffectDefinitionView> =
        sql
            .createQuery(EffectDefinition::class) {
                specification?.let(::where)
                orderBy(DEFAULT_SORT)
                select(table.fetch(EffectDefinitionView::class))
            }.execute()

    /** 按条件分页查询效果定义视图。 */
    fun pageViews(
        specification: EffectDefinitionSpecification?,
        pageable: Pageable,
    ): Page<EffectDefinitionView> =
        sql
            .createQuery(EffectDefinition::class) {
                specification?.let(::where)
                orderBy(DEFAULT_SORT)
                select(table.fetch(EffectDefinitionView::class))
            }.fetchPage(pageable.pageNumber, pageable.pageSize)

    /** 按 ID 查询单条效果定义视图。 */
    fun loadViewById(id: Long): EffectDefinitionView? =
        sql
            .createQuery(EffectDefinition::class) {
                where(table.id eq id)
                orderBy(DEFAULT_SORT)
                select(table.fetch(EffectDefinitionView::class))
            }.execute()
            .firstOrNull()

    companion object {
        /**
         * 默认排序先按 `kind` 分组，再按 `internalName` 稳定输出，
         * 方便管理端浏览同类 effect。
         */
        private val DEFAULT_SORT: Sort =
            Sort.by(
                Sort.Order.asc("kind"),
                Sort.Order.asc("internalName"),
                Sort.Order.asc("id"),
            )
    }
}