Hello World

第一次体验SDS

之前说过，SDS是C/S架构，分为两部分，一部分是使用了sds-client.jar的业务系统（即SDS的客户端），另一部分是sds-admin（即SDS的控制台）。sds-client.jar其实也可以脱离sds-admin来单独使用，只需要降级策略在编码阶段就确定好即可。

单独使用sds-client.jar的Hello World

1. 初始化SdsClient对象（作为单例使用）

    // 随便写个地址，因为我们此次的演示不会用到sds-admin
    private static final String SERVER_URL = "http://127.0.0.1:8887";

    // 保证SdsClient对象的单例使用(线程安全)
    private static SdsClient sdsClient = SdsClientFactory.getOrCreateSdsClient("BikeBusinessDepartment", "order", SERVER_URL);

2. 设置一个降级点名称

    // 创建订单的降级点名称
    private static final String CREATE_ORDER_POINT = "createOrderPoint";

3. 通过代码来给该降级点设置降级策略

由于我们先不使用sds-admin来配置策略，所以本地写死策略，这里我们先使用最常见的访问量降级策略。

    static {
        // 不从sds-admin获取策略配置，完全使用本地手动设置
        CycleDataService.setPullPointStrategySwitch(false);
        // 也不向sds-admin上报统计数据
        CycleDataService.setUploadDataSwitch(false);

        /**
         * 由于不在sds-admin中配置降级策略，所以我们要本地设置降级策略
         */
        SdsStrategy createOrderSdsStrategy = new SdsStrategy();
        createOrderSdsStrategy.setPoint(CREATE_ORDER_POINT);

        // 使用访问量降级，这里意味着在10s的滑动窗口中最多只能访问1000次业务方法
        createOrderSdsStrategy.setVisitThreshold(1000L);
        // 如果超过设定的阈值，降级比例是100%
        createOrderSdsStrategy.setDowngradeRate(100);
        SdsStrategyService.getInstance().resetOne(CREATE_ORDER_POINT, createOrderSdsStrategy);
    }

4. 对业务方法进行埋点

这里 createOrder 代表某个业务方法

    /**
     * 经过SDS包装的某个业务方法：创建订单
     *
     * @param userId
     * @param address
     * @return 创建的订单ID
     */
    public static Long createOrder(Long userId, String address) {
        try {

            // 1. 降级判断：如果需要降级，那我们根据业务逻辑来默认返回null（当然也可以选择抛我们自己定义的业务异常）
            if (sdsClient.shouldDowngrade(CREATE_ORDER_POINT)) {
                return null;
            }

            // 2. 这里写正常的业务逻辑：用控制台输出来代表业务逻辑，为简单起见，返回的订单ID随机生成
            System.out.println("您的业务方法已经执行，userId:" + userId + ", address:" + address);
            return ThreadLocalRandom.current().nextLong(0, 10000000);

        } catch (Exception e) {

            // 3. 这里用于统计异常量
            sdsClient.exceptionSign(CREATE_ORDER_POINT, e);
            // 记得捕获完还得抛出去
            throw e;

        } finally {
            // 4. 回收资源，一般在finally代码中调用
            sdsClient.downgradeFinally(CREATE_ORDER_POINT);
        }
    }

参见：https://github.com/didi/sds/blob/master/sds-example/src/main/java/com/didiglobal/sds/example/chapter1/UseOriginApi.java

连接sds-admin来使用的Hello World

我们很少直接使用sds-cliet.jar，因为通常我们需要在sds-admin动态配置降级策略，这才是SDS功能最强大的地方。

1. 初始化SdsClient对象（作为单例使用）

    // 这里配置我们官方的远程演示sds-admin地址
    private static final String SERVER_URL = "https://sds.chpengzh.com/";

    // 保证SdsClient对象的单例使用(线程安全)
    private static SdsClient sdsClient = SdsClientFactory.getOrCreateSdsClient("BikeBusinessDepartment", "order", SERVER_URL);

2. 设置一个降级点名称

    // 创建订单的降级点名称
    private static final String CREATE_ORDER_POINT = "createOrderPoint";

3. 对业务方法进行埋点

这里 createOrder 代表某个业务方法

    /**
     * 经过SDS包装的某个业务方法：创建订单
     *
     * @param userId
     * @param address
     * @return 创建的订单ID
     */
    public static Long createOrder(Long userId, String address) {
        try {

            // 1. 降级判断：如果需要降级，那我们根据业务逻辑来默认返回null（当然也可以选择抛我们自己定义的业务异常）
            if (sdsClient.shouldDowngrade(CREATE_ORDER_POINT)) {
                return null;
            }

            // 2. 这里写正常的业务逻辑：用控制台输出来代表业务逻辑，为简单起见，返回的订单ID随机生成
            System.out.println("您的业务方法已经执行，userId:" + userId + ", address:" + address);
            return ThreadLocalRandom.current().nextLong(0, 10000000);

        } catch (Exception e) {

            // 3. 这里用于统计异常量
            sdsClient.exceptionSign(CREATE_ORDER_POINT, e);
            // 记得捕获完还得抛出去
            throw e;

        } finally {
            // 4. 回收资源，一般在finally代码中调用
            sdsClient.downgradeFinally(CREATE_ORDER_POINT);
        }
    }

参见：https://github.com/didi/sds/blob/master/sds-example/src/main/java/com/didiglobal/sds/example/chapter1/UseOriginApiAndSdsAdmin.java