package cn.iocoder.yudao.module.bpm.framework.flowable.core.util;

import cn.hutool.core.util.StrUtil;

import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;

/**
 * Flowable 流程定义编号工具
 *
 * <p>流程定义编号形如 {@code qingjia:2:553a7ac9-...}，包含冒号。
 * 前端如果对该值做了 URL 编码后再作为查询参数传递（双重编码），
 * Spring 只解码一层，最终拿到的仍是 {@code qingjia%3A2%3A...}，
 * Flowable 按该编号查不到流程定义，直接抛 FlowableObjectNotFoundException 导致 500。
 *
 * <p>这里在入口处做一次幂等的归一化：只在确实残留 % 转义时才解码，
 * 合法的流程定义编号不可能包含 %，因此不会误伤。
 *
 * @author 超级管理员
 */
public class BpmProcessDefinitionIdUtils {

    /** 最多解码层数，防止异常输入无限循环 */
    private static final int MAX_DECODE_TIMES = 5;

    private BpmProcessDefinitionIdUtils() {
    }

    /**
     * 归一化流程定义编号：最多解码一层残留的 URL 转义
     *
     * @param id 流程定义编号
     * @return 归一化后的编号；入参为空时原样返回
     */
    public static String normalize(String id) {
        if (StrUtil.isBlank(id) || id.indexOf('%') < 0) {
            return id;
        }
        // 前端可能编码多次（1~3 层都见过），逐层解码直到不再含 % 转义
        String current = id;
        for (int i = 0; i < MAX_DECODE_TIMES && current.indexOf('%') >= 0; i++) {
            String decoded;
            try {
                decoded = URLDecoder.decode(current, StandardCharsets.UTF_8);
            } catch (Exception ignored) {
                // 解码失败说明不是 URL 转义，保持原值
                break;
            }
            if (decoded.equals(current)) {
                break;
            }
            current = decoded;
        }
        return current;
    }

}