com.yunpian.sdk.api.YunpianApiResult Maven / Gradle / Ivy

Go to download
/**
 * 
 */
package com.yunpian.sdk.api;

import java.lang.reflect.Type;
import java.util.Collections;
import java.util.List;
import java.util.Map;

import com.yunpian.sdk.constant.Code;
import com.yunpian.sdk.constant.YunpianConstant;
import com.yunpian.sdk.model.Result;
import com.yunpian.sdk.util.JsonUtil;

/**
 * YunpianApi 结果处理
 * 
 * @author dzh
 * @date Nov 25, 2016 2:48:27 PM
 * @since 1.2.0
 */
public interface YunpianApiResult {

    /**
     * 获取最终的结果
     * 
     * @param rsp
     *            响应结果
     * @param h
     *            结果处理器
     * @param r
     *            返回结果，若r=null则自动创建
     * @return
     */
     Result result(String rsp, ResultHandler h, Result r);

    /**
     * 
     * @author dzh
     * @date Nov 25, 2016 5:36:59 PM
     * @since 1.2.0
     * @param 
     *            HttpResponse的转换类型
     * @param 
     *            {@code Result}的data类型
     */
    public static interface ResultHandler {

        /**
         * 将响应输入流转换成R类型
         * 
         * @param rsp
         *            响应输入流
         * @return
         */
        R response(String rsp) throws Exception;

        /**
         * 根据rsp获取响应码
         * 
         * @param rsp
         * @return
         */
        Integer code(R rsp);

        /**
         * 处理成功响应
         * 
         * @param code
         *            0
         * @param rsp
         * @param r
         * @return
         */
        Result succ(Integer code, R rsp, Result r);

        /**
         * 处理失败响应
         * 
         * @param code
         * @param rsp
         * @param r
         * @return r
         */
        Result fail(Integer code, R rsp, Result r);

        /**
         * 处理异常
         * 
         * @param e
         * @param r
         * @return
         */
        Result catchExceptoin(Throwable e, Result r);
    }

    public static abstract class AbstractResultHandler implements ResultHandler {
        @Override
        public Result catchExceptoin(Throwable e, Result r) {
            if (r == null) {
                r = new Result<>();
            }
            return r.setCode(Code.UNKNOWN_EXCEPTION).setMsg(Code.getErrorMsg(Code.UNKNOWN_EXCEPTION)).setThrowable(e);
        }
    }

    /**
     * 处理返回json对象(非数组)
     * 
     * @author dzh
     * @date Nov 25, 2016 8:31:07 PM
     * @since 1.2.0
     */
    public static abstract class MapResultHandler extends AbstractResultHandler, T>
            implements YunpianConstant {

        @Override
        public Map response(String rsp) throws Exception {
            if (rsp == null)
                return Collections.emptyMap();
            return JsonUtil.fromJsonToMap(rsp);
        }

        @Override
        public Result succ(Integer code, Map rsp, Result r) {
            if (r == null) {
                r = new Result<>();
            }
            r.setCode(code).setMsg(rsp.containsKey(MSG) ? rsp.get(MSG) : Code.getErrorMsg(code));
            T data = data(rsp);
            return r.setData(data);
        }

        /**
         * 成功时返回对象
         * 
         * @param rsp
         * @return 对象数据
         */
        public abstract T data(Map rsp);

        /**
         * 错误流程 v1和v2返回格式一致
         */
        @Override
        public Result fail(Integer code, Map rsp, Result r) {
            if (r == null) {
                r = new Result<>();
            }
            return r.setCode(code).setMsg(rsp.containsKey(MSG) ? rsp.get(MSG) : Code.getErrorMsg(code))
                    .setDetail(rsp.get(DETAIL));
        }

    }

    /**
     * 处理返回json数组的情况,在传回非json时，用map方式解析到rspMap。设计不好，最好统一用map格式
     * 
     * @author dzh
     * @date Nov 25, 2016 6:05:18 PM
     * @since 1.2.0
     */
    public static abstract class ListResultHandler extends AbstractResultHandler, T>
            implements YunpianConstant {

        /**
         * list解析错误时，按map方式解析
         */
        protected Map rspMap;

        @Override
        public List response(String rsp) throws Exception {
            if (rsp == null)
                return Collections.emptyList();
            if (rsp.startsWith("["))
                return JsonUtil.fromJson(rsp, rspType());
            else {
                rspMap = JsonUtil.fromJsonToMap(rsp);
                return Collections.emptyList();
            }
        }

        abstract Type rspType();

        @Override
        public Result succ(Integer code, List rsp, Result r) {
            if (r == null) {
                r = new Result<>();
            }
            r.setCode(code).setMsg(Code.getErrorMsg(code));
            T data = data(rsp);
            return r.setData(data);
        }

        /**
         * 成功时返回对象
         * 
         * @param rsp
         * @return 对象数据
         */
        public abstract T data(List rsp);

        /**
         * 错误流程 v1和v2返回格式一致
         */
        @Override
        public Result fail(Integer code, List rsp, Result r) {
            if (r == null) {
                r = new Result<>();
            }
            Map map = rspMap == null ? Collections.emptyMap() : rspMap;
            return r.setCode(code).setMsg(map.containsKey(MSG) ? map.get(MSG) : Code.getErrorMsg(code))
                    .setDetail(map.get(DETAIL));
        }

        @Override
        public Result catchExceptoin(Throwable e, Result r) {
            if (r == null) {
                r = new Result<>();
            }
            return r.setCode(Code.UNKNOWN_EXCEPTION).setMsg(Code.getErrorMsg(Code.UNKNOWN_EXCEPTION)).setThrowable(e);
        }

    }

    public static abstract class SimpleListResultHandler extends ListResultHandler>
            implements YunpianConstant {
    }
}