实例地域解析与 SagaRegionResolver (Instance Region Resolution & SagaRegionResolver)

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           unix_ts_ms                          |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          unix_ts_ms           |  ver  |      region_code      | <- 12-bit 地域代号 (0..4095)
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|var|                         rand_b                            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                            rand_b                             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

package org.stacksaga.api;

public interface SagaRegionResolver {

    /**
     * 将人类可读的地域名称解析为其对应的 12-bit 整数代码 (0..4095)。
     *
     * @param regionName 地域名称字符串 (例如 "default", "us-east-1")
     * @return 唯一的整型地域代码
     */
    int getRegionCodeByName(String regionName);

    /**
     * 将 12-bit 整型地域代码还原为其规范的地域名称字符串。
     *
     * @param regionCode 12-bit 整型地域代码 (0..4095)
     * @return 规范的地域名称字符串
     */
    String getRegionNameByCode(int regionCode);
}

package com.example.config;

import org.stacksaga.api.SagaRegionResolver;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.Arrays;
import java.util.Map;
import java.util.stream.Collectors;

@Configuration
public class StackSagaRegionConfiguration {

    public enum EnterpriseRegion {
        DEFAULT("default", 0),
        US_EAST_1("us-east-1", 1),
        EU_CENTRAL_1("eu-central-1", 2),
        AP_SOUTHEAST_1("ap-southeast-1", 3);

        private final String regionName;
        private final int code;

        EnterpriseRegion(String regionName, int code) {
            this.regionName = regionName;
            this.code = code;
        }

        public String getRegionName() { return regionName; }
        public int getCode() { return code; }
    }

    @Bean
    public SagaRegionResolver customSagaRegionResolver() {
        return new SagaRegionResolver() {
            private final Map<String, Integer> nameToCode = Arrays.stream(EnterpriseRegion.values())
                    .collect(Collectors.toMap(EnterpriseRegion::getRegionName, EnterpriseRegion::getCode));

            private final Map<Integer, String> codeToName = Arrays.stream(EnterpriseRegion.values())
                    .collect(Collectors.toMap(EnterpriseRegion::getCode, EnterpriseRegion::getRegionName));

            @Override
            public int getRegionCodeByName(String regionName) {
                Integer code = nameToCode.get(regionName);
                if (code == null) {
                    throw new IllegalArgumentException(
                        "无法识别的地域名称: '" + regionName + "'. 支持的合法地域为: " + nameToCode.keySet()
                    );
                }
                return code;
            }

            @Override
            public String getRegionNameByCode(int regionCode) {
                String name = codeToName.get(regionCode);
                if (name == null) {
                    throw new IllegalArgumentException(
                        "无法识别的地域代码: '" + regionCode + "'. 支持的合法代码为: " + codeToName.keySet()
                    );
                }
                return name;
            }
        };
    }
}