refactor(gateApi): 优化网格交易服务中的变量作用域

Administrator

2026-06-06 aaa9b2d954e3dc3c1588ecbb749b46b413c5fc5b

 src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionsChannelHandler.java

@@ -4,23 +4,13 @@
import com.alibaba.fastjson.JSONObject;
import com.xcong.excoin.modules.gateApi.GateGridTradeService;
import com.xcong.excoin.modules.gateApi.wsHandler.AbstractPrivateChannelHandler;
import io.gate.gateapi.models.Position;
import lombok.extern.slf4j.Slf4j;

import java.math.BigDecimal;

/**
 * 仓位频道处理器。
 *
 * <h3>数据用途</h3>
 * 监控仓位数量（size）。当 size 从有变为 0 时，表示该方向被止盈条件单平仓，
 * 触发补仓（reopenLongPosition / reopenShortPosition）。
 *
 * <h3>推送字段</h3>
 * contract, mode（dual_long / dual_short）, size（正=持有，0=无仓位）, entry_price
 *
 * <h3>注意</h3>
 * 双向持仓模式下空头 size 为负数，使用 {@code size.abs()} 判断是否有仓位。
 * 累计盈亏不由本频道计算，而是由 {@link PositionClosesChannelHandler} 独立处理。
 * 仓位频道处理器（futures.positions），接收仓位更新推送并回调 {@link GateGridTradeService#onPositionUpdate}。
 *
 * @author Administrator
 */
@@ -29,6 +19,12 @@

    private static final String CHANNEL_NAME = "futures.positions";

    /**
     * @param apiKey           Gate API v4 密钥，用于签名认证
     * @param apiSecret        Gate API v4 签名密钥
     * @param contract         合约名称（如 ETH_USDT）
     * @param gridTradeService 网格交易策略服务实例
     */
    public PositionsChannelHandler(String apiKey, String apiSecret,
                                    String contract,
                                    GateGridTradeService gridTradeService) {
@@ -37,17 +33,30 @@

    @Override
    public boolean handleMessage(JSONObject response) {
        if (!CHANNEL_NAME.equals(response.getString("channel"))) return false;
        if (!CHANNEL_NAME.equals(response.getString("channel"))) {
            return false;
        }
        try {
            JSONArray resultArray = response.getJSONArray("result");
            if (resultArray == null || resultArray.isEmpty()) return true;
            if (resultArray == null || resultArray.isEmpty()) {
                return true;
            }
            for (int i = 0; i < resultArray.size(); i++) {
                JSONObject pos = resultArray.getJSONObject(i);
                if (!getContract().equals(pos.getString("contract"))) continue;
                String mode = pos.getString("mode");
                if (!getContract().equals(pos.getString("contract"))) {
                    continue;
                }
                String modeStr = pos.getString("mode");
                Position.ModeEnum mode = Position.ModeEnum.fromValue(modeStr);
                BigDecimal size = new BigDecimal(pos.getString("size"));
                BigDecimal entryPrice = new BigDecimal(pos.getString("entry_price"));
                log.info("[{}] 持仓更新, 模式:{}, 数量:{}, 入场价:{}", CHANNEL_NAME, mode, size, entryPrice);
                log.info("[{}] 持仓更新, 合约:{}, 模式:{}, 数量:{}, 入场价:{}, 全仓杠杆上限:{}, 历史盈亏:{}, 历史点卡:{}, 最近平仓盈亏:{}, 杠杆:{}, 最大杠杆:{}, 爆仓价:{}, 维持保证金率:{}, 保证金:{}, 已实现盈亏:{}, 点卡已实现盈亏:{}, 风险限额:{}, 时间:{}, 时间ms:{}, 用户:{}, 更新ID:{}",
                        CHANNEL_NAME, pos.getString("contract"), modeStr, size, entryPrice,
                        pos.get("cross_leverage_limit"), pos.get("history_pnl"), pos.get("history_point"),
                        pos.get("last_close_pnl"), pos.get("leverage"), pos.get("leverage_max"),
                        pos.get("liq_price"), pos.get("maintenance_rate"), pos.get("margin"),
                        pos.get("realised_pnl"), pos.get("realised_point"), pos.get("risk_limit"),
                        pos.get("time"), pos.get("time_ms"), pos.get("user"), pos.get("update_id"));
                if (getGridTradeService() != null) {
                    getGridTradeService().onPositionUpdate(getContract(), mode, size, entryPrice);
                }