Magician-Route 发布啦

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

Magician-Web 依然会继续维护，如果大家对反射的性能不是特别抗拒，而且更喜欢Magician-Web的风格，大可放心使用。

创建路由

由注解的形式改成了 传参的形式，每一次的请求都不再需要通过反射来执行了路由了，性能得到了有效提升

• 这样的类可以创建多个，根据你的需求 将路由分开创建
• 每个路由内部，如果没有特别的需要 就不需要加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; } }); } }

可以访问官网了解更多：https://magician-io.com