Magician-Route

Magician-Route 是 Magician 的官方 web 组件，由 Magician-Web 发展而来的新项目，主要是去掉了里面的反射，牺牲了一点易用性，将侧重点放在了性能上，两者的区别主要在于路由和拦截器的创建方式上。

引入依赖

在Magician项目的基础上 添加这个依赖

<dependency>
    <groupId>com.github.yuyenews</groupId>
    <artifactId>Magician-Route</artifactId>
    <version>1.0.0</version>
</dependency>

创建核心Handler

只允许有一个HttpHandler，这个Handler作为分发器，将请求分发给Route

@HttpHandler(path="/")
public class DemoHandler implements HttpBaseHandler {

    @Override
    public void request(MagicianRequest magicianRequest, MagicianResponse response) {
       try{
            // 主要是这句
            MagicianRoute.request(magicianRequest);
        } catch (Exception e){
        }
    }
}

创建路由

这样的类可以创建多个，根据你的需求 将路由分开创建

每个路由内部，如果没有特别的需要 就不需要加try-catch，框架内部做了处理，一旦发生异常，会将异常信息以json的形式响应给客户端

直接返回需要响应的对象，框架会自动转成json并返回给客户端，你也可以采用如下示例中“Magician的原生响应方式” 将数据返回给客户端，具体可以看Magician文档的《响应参数》

@Route
public class DemoRoute implements MagicianInitRoute {


    @Override
    public void initRoute(MagicianRouteCreate routeCreate) {

        routeCreate.get("/demo/getForm", request -> {
            return "{\"msg\":\"hello login\"}";
        });

        // Magician的原生响应方式
        routeCreate.get("/demo/getForm2", request -> {
            request.getResponse().sendJson("{\"msg\":\"hello login\"}");
            return null;
        });

        routeCreate.post("/demo/json", request -> {

            DemoResponseVo demoResponseVo = new DemoResponseVo();
            demoResponseVo.setName("Beerus");

            return demoResponseVo;
        });
    }

}

将参数转化为实体对象

如果你想让实体类顺利的接收到参数，并且让参数验证生效，那么必须做如下步骤， 这种方式 底层是用的反射，如果你无法接受反射的性能，那么可以不用这种方式，选择权在你自己

只转化

routeCreate.get("/demo/getForm", request -> {

    DemoVO demoVO = ConversionUtil.conversion(request, DemoVO.class);

    return "{\"msg\":\"hello login\"}";
});

转化 + 参数验证

如果验证失败，conversionAndVerification 方法会抛出一个异常，这个异常会自动被响应给客户端，不需要开发者处理

routeCreate.get("/demo/getForm", request -> {

    DemoVO demoVO = ConversionUtil.conversionAndVerification(request, DemoVO.class);

    return "{\"msg\":\"hello login\"}";
});

如果你想获取到验证失败的提示信息 自己处理，可以用这种方式

routeCreate.get("/demo/getForm", request -> {

    try {
        DemoVO demoVO = ConversionUtil.conversionAndVerification(request, DemoVO.class);
    } catch(VerificationException e){
        // 这个就是 验证失败的提示信息
        String msg = e.getMessage();
    }
    
    return "{\"msg\":\"hello login\"}";
});

创建拦截器

跟路由一样，这种类也可以创建多个，根据你的需求 分开创建拦截器

第一个参数为拦截规则，全部拦截 配置 * 即可，否则的话，必须以 / 开头

如果拦截器顺利放行的话，返回 SUCCESS 就好了，如果不给通过，那么直接返回 错误提示信息（返回对象会自定转成 json）

@Interceptor
public class DemoInter implements MagicianInitInterceptor {

    @Override
    public void initInterceptor(MagicianInterceptorCreate interceptorCreate) {

        interceptorCreate.addInterceptor("/demo/*", new MagicianInterceptor() {
            @Override
            public Object before(MagicianRequest magicianRequest) {
                System.out.println("进入了拦截器");
                return SUCCESS;
            }

            @Override
            public Object after(MagicianRequest magicianRequest, Object o) {
                return SUCCESS;
            }
        });

        interceptorCreate.addInterceptor("/*/form", new MagicianInterceptor() {
            @Override
            public Object before(MagicianRequest magicianRequest) {
                System.out.println("进入了拦截器2");
                return SUCCESS;
            }

            @Override
            public Object after(MagicianRequest magicianRequest, Object o) {
                return SUCCESS;
            }
        });
    }

}