摘要：從功能上來說，沒有任何的毛病。解決方案每次接受請求之后，根據(jù)的不同，來執(zhí)行不同的業(yè)務(wù)邏輯。具體實現(xiàn)注解表示是個方法注解。通過的接口可以看到具體的使用方式，類上面使用注解，方法上使用注解，注解中傳入類中定義的名字即可。

在與倉庫系統(tǒng)的對接過程中，我們使用了阿里巴巴的奇門規(guī)范。該規(guī)范中根據(jù)不同的method參數(shù)來確定不同的業(yè)務(wù)，比如：

# 入庫單創(chuàng)建
method=taobao.qimen.entryorder.create
# 庫存查詢
method=taobao.qimen.inventory.query
# 商品同步接口
method=taobao.qimen.singleitem.synchronize

那么我們在解析的時候，常用的方式就是使用switch或者if來處理，以switch為例，實現(xiàn)代碼如下：

switch (method) {
    case "taobao.qimen.entryorder.create":
        return entryorderCreate();
    case ""taobao.qimen.inventory.query:
        return inventoryQuery();
    case "taobao.qimen.singleitem.synchronize":
        return singleitemSyncronize();
    default:
        return "";
}

通過switch，我們根據(jù)不同的method能夠返回不同的執(zhí)行邏輯結(jié)果。從功能上來說，沒有任何的毛病。但是作為一個程序員，如果只是為了完成功能而寫代碼，那這樣的程序員是沒有靈魂的。

在奇門api技術(shù)文檔中，大概有50多個不同的業(yè)務(wù)接口method，這也就意味著我們至少要case 50次以上。你覺得一個switch中case 50次合理嗎？答案當(dāng)然是不合理的。

在這了再分享一句話：

任何一個傻瓜都能寫出計算機能理解的程序，而優(yōu)秀的程序員卻能寫出別人能讀得懂的程序?！?Martin Fowler

每次接受請求之后，根據(jù)method的不同，來執(zhí)行不同的業(yè)務(wù)邏輯。那么我們能不能將請求的method和需要執(zhí)行的業(yè)務(wù)邏輯方法做一個映射，這樣我們根據(jù)method就能直接找到具體的業(yè)務(wù)邏輯處理方法。

那么我們的method怎么和我們的業(yè)務(wù)方法映射綁定呢？解決方法是在每個業(yè)務(wù)方法上面增加一個注解(比如@Name)。那么問題來了，我們什么時候生成這樣的映射關(guān)系呢？
我們可以在容器啟動的時候，就去生成這樣的映射關(guān)系。那么我們怎么知道哪些類包含了具有@Name注解的方法呢？
為了能快速獲取到包含@Name注解方法的類，我們增加一個類注解@MethodHandler，在方法上使用了@Name注解的類上我們加上一個@MethodHandler注解，這樣我們就能快速找到這樣的類。

@Name注解

@Target(ElementType.METHOD)
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface Name {
    String[] value() default {};
}

@Target(ElementType.METHOD)表示@Name是個方法注解。同時里面的value是個數(shù)組，是因為可能存在多個method執(zhí)行相同業(yè)務(wù)邏輯的情況

@MethodHandler注解

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MethodHandler {
}

@Target({ElementType.TYPE})表示@MethodHandler是個類或者接口注解，此注解的作用是讓我們能快速找到包含@Name注解的方法。

MethodMappering

public class MethodMapping {
    //方法注解對應(yīng)的名字
    public String[] names;
    //具體的執(zhí)行方法
    public Method method;
    public MethodMapping(String[] names, Method method) {
        this.names = names;
        this.method = method;
    }
}

這個類主要存儲奇門method和具體執(zhí)行的方法的映射

MethodNames

public class MethodNames {
    public static final String deliveryorder_confirm = "deliveryorder.confirm";
    public static final String taobao_qimen_deliveryorder_confirm = "taobao.qimen.deliveryorder.confirm";
    public static final String deliveryorder_batchconfirm = "deliveryorder.batchconfirm";
    public static final String taobao_qimen_deliveryorder_batchconfirm = "taobao.qimen.deliveryorder.batchconfirm";
    public static final String stockchange_report = "stockchange.report";
    public static final String taobao_qimen_stockchange_report = "taobao.qimen.stockchange.report";
    public static final String stockout_confirm = "stockout.confirm";
    public static final String taobao_qimen_stockout_confirm = "taobao.qimen.stockout.confirm";
    public static final String entryorder_confirm = "entryorder.confirm";
    public static final String taobao_qimen_entryorder_confirm = "taobao.qimen.entryorder.confirm";
    public static final String itemlack_report = "itemlack.report";
    public static final String taobao_qimen_itemlack_report = "taobao.qimen.itemlack.report";
    public static final String orderprocess_report = "orderprocess.report";
    public static final String taobao_qimen_orderprocess_report = "taobao.qimen.orderprocess.report";
    public static final String returnorder_confirm = "returnorder.confirm";
    public static final String taobao_qimen_returnorder_confirm = "taobao.qimen.returnorder.confirm";
    public static final String returnapply_report = "returnapply.report";
    public static final String taobao_qimen_returnapply_report = "taobao.qimen.returnapply.report";
    public static final String qimen_taobao_qianniu_cloudkefu_address_self_modify = "qimen.taobao.qianniu.cloudkefu.address.self.modify";
}

MethodNames類主要記錄了奇門中所有的method（此處只展示部分）

注解解析和檢查類DetectMethodAnnotation

@Component
public class DetectMethodAnnotation extends AbstractReturner implements ApplicationContextAware, InitializingBean {

    private ApplicationContext applicationContext;

    //存儲類-方法
    private HashMap> classMethodMap = new HashMap<>();

    /**
     * 初始化容器后解析所有包含MethodHandler注解的類中包含Name注解的方法
     *
     * @throws Exception
     */
    @Override
    public void afterPropertiesSet() throws Exception {
        //獲取包含注解MethodHandler的類
        Map methodHandlerMap = applicationContext.getBeansWithAnnotation(MethodHandler.class);
        methodHandlerMap.forEach((k, v) -> {
            Class clazz = v.getClass();
            Method[] methods = clazz.getDeclaredMethods();//獲取所有的方法
            List methodMappings = new ArrayList<>();
            for (Method method : methods) {
                //只解析@Name注解的，并且返回值為Returner的方法，方便對結(jié)果進行解析
                if (method.isAnnotationPresent(Name.class) && (method.getReturnType() == Returner.class)) {
                    Name nameAnnotation = method.getAnnotation(Name.class);
                    methodMappings.add(new MethodMapping(nameAnnotation.value(), method));
                }
            }
            if (!methodMappings.isEmpty()) {
                classMethodMap.put(clazz.getName(), methodMappings);
            }
        });
    }

    /**
     * 執(zhí)行
     *
     * @param name
     * @return
     */
    public  Returner execute(String name, Object... parameters) throws Exception {
        if (!classMethodMap.containsKey(this.getClass().getName())) {
            return fail("類[" + this.getClass().getName() + "]未使用注解@MethodHandler注冊或未發(fā)現(xiàn)任何使用@Name注解的非繼承方法");
        }

        List methodMappings = classMethodMap.get(this.getClass().getName());
        for (MethodMapping methodMapping : methodMappings) {
            String[] names = methodMapping.names;
            if (Arrays.asList(names).contains(name)) {
                return (Returner) methodMapping.method.invoke(this, parameters);
            }
        }
        return fail("未發(fā)現(xiàn)使用注解 @Name("" + name + "") 為的方法");
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }
}

DetectMethodAnnotation的作用如下：

實現(xiàn)ApplicationContextAware接口，這樣能獲取到上下文對象ApplicationContext

實現(xiàn)InitializingBean接口的afterPropertiesSet()方法，此方法在容器啟動之后只執(zhí)行一次，在此方法中可以解析所有的@Name注解

解析的數(shù)據(jù)存放在classMethodMap中，classMethodMap的數(shù)據(jù)結(jié)構(gòu)Hash<類名,List>

提供一個方法execute，外部只需要傳遞method和業(yè)務(wù)邏輯方法的參數(shù)即可。

QimenController

@Controller
@MethodHandler
public class QimenController extends DetectMethodAnnotation {
    @Name({MethodNames.deliveryorder_confirm, MethodNames.taobao_qimen_deliveryorder_confirm})
    public Returner deliveryorderConfirm(String deliveryOrderCode) {
        logger.info("execute deliveryorderConfirm method with value " + deliveryOrderCode);
        return success("");
    }

    @Name(MethodNames.stockchange_report)
    public Returner stockchangeReport() {
        return success("");
    }
}

通過QimenController的接口可以看到具體的使用方式，類上面使用@MethodHandler注解，方法上使用@Name注解，@Name注解中傳入MethodNames類中定義的名字即可。

測試

public class Run {
    public static final Logger logger = LoggerFactory.getLogger(Run.class);
    public static void main(String[] args) throws Exception {
        AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(Run.class);
        QimenController qimenController = applicationContext.getBean(QimenController.class);
        Returner execute = qimenController.execute(MethodNames.deliveryorder_confirm, "T123456789");
        logger.info("deliveryorder_confirm:{}", execute);
        logger.info("stockchange_report:{}", qimenController.execute(MethodNames.stockchange_report));
        applicationContext.close();
    }
}

執(zhí)行結(jié)果如下

[main] INFO  solution.swithCase.QimenController - [18] - execute deliveryorderConfirm method with value T123456789
[main] INFO  solution.swithCase.Run - [29] - deliveryorder_confirm:Returner(code=0, desc=null, body=)
[main] INFO  solution.swithCase.Run - [30] - stockchange_report:Returner(code=0, desc=null, body=)

Returner對象

@Data
public class Returner implements Serializable {
    private String code;
    private String desc;
    private T body;
}

此對象主要為了統(tǒng)一返回值，方便解析

首先要先明白解決方案思路才能理解代碼，其實就是把類-method-業(yè)務(wù)邏輯做一個映射，這樣就能直接通過接口中傳遞的method來找到具體的業(yè)務(wù)邏輯代碼。如果有不明白的地方可以在下面留言。