cn.ponfee.disjob.supervisor.dao.mapper.SchedInstanceMapper Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of disjob-supervisor Show documentation
Distributed job supervisor module
The newest version!
/*
 * Copyright 2022-2024 Ponfee (http://www.ponfee.cn/)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package cn.ponfee.disjob.supervisor.dao.mapper;

import cn.ponfee.disjob.core.enums.RunState;
import cn.ponfee.disjob.supervisor.application.request.SchedInstancePageRequest;
import cn.ponfee.disjob.supervisor.model.SchedInstance;
import org.apache.ibatis.annotations.Param;

import java.util.Date;
import java.util.List;
import java.util.Map;

import static cn.ponfee.disjob.common.spring.TransactionUtils.isOneAffectedRow;

/**
 * Mybatis mapper of sched_instance database table.
 *
 * @author Ponfee
 */
public interface SchedInstanceMapper {

    int insert(SchedInstance instance);

    /**
     * Gets sched instance by instance_id
     *
     * @param instanceId the instance id
     * @return SchedInstance
     */
    SchedInstance get(long instanceId);

    /**
     * Gets job id by instance_id
     *
     * @param instanceId the instance id
     * @return job id
     */
    Long getJobId(long instanceId);

    Long getWnstanceId(long instanceId);

    List findChildren(@Param("pnstanceId") long pnstanceId, @Param("runType") Integer runType);

    int start(@Param("instanceId") long instanceId, @Param("runStartTime") Date runStartTime);

    int terminate(@Param("instanceId") long instanceId,
                  @Param("toState") int toState,
                  @Param("fromStateList") List fromStateList,
                  @Param("runEndTime") Date runEndTime);

    int updateState(@Param("instanceId") long instanceId, @Param("toState") int toState, @Param("fromState") int fromState);

    int updateRetrying(@Param("instanceId") long instanceId,
                       @Param("retrying") boolean retrying,
                       @Param("toState") int toState,
                       @Param("fromState") int fromState);

    List findExpireState(@Param("runState") int runState,
                                        @Param("expireTime") Date expireTime,
                                        @Param("size") int size);

    SchedInstance getRetrying(long instanceId);

    List findRunRetry(long instanceId);

    List findWorkflowNode(long wnstanceId);

    int updateNextScanTime(@Param("instanceId") long instanceId,
                           @Param("nextScanTime") Date nextScanTime,
                           @Param("version") int version);

    SchedInstance lock(long instanceId);

    /**
     * Delete the sched instance.
     *
     * @param instanceId the instance id
     * @return delete sql affected rows
     */
    int deleteByInstanceId(long instanceId);

    int deleteByWnstanceId(long wnstanceId);

    SchedInstance getByUniqueKey(@Param("jobId") long jobId,
                                 @Param("triggerTime") long triggerTime,
                                 @Param("runType") int runType,
                                 @Param("uniqueFlag") long uniqueFlag);

    // -------------------------------------------------query for page

    long queryPageCount(SchedInstancePageRequest request);

    List queryPageRecords(SchedInstancePageRequest request);

    List queryByPnstanceId(long pnstanceId);

    List> queryChildCount(List pnstanceIds);

    // -------------------------------------------------default methods

    default boolean terminate(long instanceId, RunState toState, List fromStateList, Date runEndTime) {
        return isOneAffectedRow(terminate(instanceId, toState.value(), fromStateList, runEndTime));
    }

    default boolean updateState(long instanceId, RunState toState, RunState fromState) {
        return isOneAffectedRow(updateState(instanceId, toState.value(), fromState.value()));
    }

    default boolean updateRetrying(long instanceId, boolean retrying, RunState toState, RunState fromState) {
        return isOneAffectedRow(updateRetrying(instanceId, retrying, toState.value(), fromState.value()));
    }

}