org.nutz.mvc.annotation

注释类型 At

@Retention(value=RUNTIME)
 @Target(value={TYPE,METHOD})
 @Documented
public @interface At

声明了一组URL。

这个注解可以声明在模块上，也可以声明在每个模块的入口函数里。

如果声明在模块上：

• 如果没有设值，那么默认的，就采用模块类名小写作为路径
• 如果声明了多个值，那么一个模块就可能会有多个前缀

比如下面的例子表示， 整个 Abc 模块各个入口函数的地址以 以 /abc 开头:

 @At
 public class Abc {}
 

又比如这个例子表示，整个模块各个入口函数的地址以 /uuu 或 /ddd 开头

 @At({"/uuu", "/ddd"})
 public class Abc {}
 

如果声明在入口函数上

• 如果没有设值，那么默认的，就采用函数名小写作为路径
• 如果声明了多个值，那么一个入口函数就可能会有多个地址，并且这个地址会和模块的地址做“笛卡尔积”
  就是说，如果模块有两个地址，一个入口函数有两个地址，那么这个入口函数实际上有 2 x 2 = 4 个地址

比如下面的例子，入口函数地址为 ：/abc/hello

 @At
 public class Abc {
     @At
     public String hello() {
         return "Hello";
     }
 }
 

而这个例子，入口函数可以支持4个地址：

• /uuu/say
• /uuu/hello
• /ddd/say
• /ddd/hello

 @At("/uuu", "/ddd")
 public class Abc{
     @At("/say","/hello")
     public String hello() {
         return "Hello";
     }
 }
 

作者:

zozoh(zozohtnt@gmail.com)

可选元素概要

可选元素

限定符和类型	可选元素和说明
String	key 如果为这个映射声明一个 key，那么，可以通过 key 来访问这个 @At 的一个值 默认的，你不需要关心这个属性
String[]	methods 需要映射的HTTP方法,例如POST GET 等等
boolean	top 升级为顶层路径映射,不受类的@At及主模块@At的配置所影响, 默认为false
String[]	value 需要映射的路径,可以多个

元素详细资料

key

public abstract String key

如果为这个映射声明一个 key，那么，可以通过 key 来访问这个 @At 的一个值

默认的，你不需要关心这个属性

默认值:

""

value

public abstract String[] value

需要映射的路径,可以多个

默认值:

{}

methods

public abstract String[] methods

需要映射的HTTP方法,例如POST GET 等等

默认值:

{}

top

public abstract boolean top

升级为顶层路径映射,不受类的@At及主模块@At的配置所影响, 默认为false

返回:

是否为顶层路径映射

默认值:

false