Hello World

wrdoclet主要通过注释来生成文档。这里通过一个简单的例子来看一下效果。

/**
 * 获取用户列表
 * @param name 用户名称
 * @tag 用户管理, 用户展示
 * 
 * @author Adams
 * @version 0.0.1
 * @memo init create
 * 
 * @author Bob
 * @version 0.0.2
 * @memo fix bug
 * 
 * @return 用户列表
 */
@WebResult(name = "getUserResult")
public List<User> getUserList(@XmlElement(required=false) @WebParam(name = "name") String name);

helloword

这里需要注意的是代码的注释方式是

/** 
 * ...
 */

不能使用

/*
 * ...
 */

或者

// ...

否者javadoc无法获取注释内容。

下面就是不符合规范的例子

// 悲催,这种注释doclet不认
// 添加课程
// @tag Clazz, School, OPS
// @author Adams
// @version 0.0.1
// @memo init create
// @author Bob
// @version 0.0.2
// @memo fix bug
@RequestMapping(value = "/class/add", method = RequestMethod.POST)
public @ResponseBody
Clazz addClass(@RequestBody Clazz clazz, HttpServletRequest httpRequest,
        HttpServletResponse httpResponse) {
    return clazz;
}

results matching ""

    No results matching ""