001/**
002 * Copyright (c) 2025-2026, Michael Yang 杨福海 (fuhai999@gmail.com).
003 * <p>
004 * Licensed under the GNU Lesser General Public License (LGPL) ,Version 3.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 * <p>
008 * http://www.gnu.org/licenses/lgpl-3.0.txt
009 * <p>
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 */
016package dev.tinyflow.core.chain.repository;
017
018import dev.tinyflow.core.chain.ChainState;
019
020import java.util.EnumSet;
021import java.util.concurrent.TimeUnit;
022
023public interface ChainStateRepository {
024
025    ChainState load(String instanceId);
026
027    boolean tryUpdate(ChainState newState, EnumSet<ChainStateField> fields);
028
029    /**
030     * 获取指定 instanceId 的分布式锁
031     *
032     * @param instanceId 链实例 ID
033     * @param timeout    获取锁的超时时间
034     * @param unit       时间单位
035     * @return ChainLock 句柄，调用方必须负责 close()
036     * @throws IllegalArgumentException if instanceId is blank
037     */
038    default ChainLock getLock(String instanceId, long timeout, TimeUnit unit) {
039        return new LocalChainLock(instanceId, timeout, unit);
040    }
041}