命令行调用
wrdoclet支持的传入参数主要有:
参数名 | 含义 |
---|---|
-dubboconfigpath <path> | 可选。dubbo服务的配置文件路径,参见“dubbo使用说明”章节 |
-springcontextconfigpath <path> | 可选。spring服务的配置文件路径,参见“Spring MVC使用说明”章节 |
-excludedurlsxpath <path> | 可选。用于识别登录验证URL的xpath,参见“Spring MVC使用说明”章节 |
-branchname <branchname> | branchname和codeurl两则必须有其一。代码分支名称 |
-codeurl <codeurl> | branchname和codeurl两则必须有其一。代码路径URL。当参数未指定branchname时,自动将codeurl的最后一段作为branchname。主要是方便使用SVN的jenkins用户,比如http://127.0.0.1/demobubbo/branches/2016.1.1release/ 使用代码路径url,避免新增branch时需要修改参数。 |
-systemname <systemname> | 必须。系统名称 |
-searchengine <url> | 可选。solr搜索引擎的地址 |
-buildid <buildid> | 可选。标识本次运行的ID,如果未指定或者为"time"时以系统时间作为ID。主要用于和jenkins集成时确保推送到solr的文档是当次运行输出的文档。 |
-showannotationlist <annotationlist> | 可选。指定注解在文档中显示 |
-authkeyword <keyword> | 可选。通过keyword标识接口必须要验证登录通过后方可被调用 |
-noauthkeyword <keyword> | 可选。通过keyword标识接口不需要验证登录通过后方可被调用 |
-cmzfieldexclude <annotation> | 可选。用户自定义的annotation用于序列化时排除序列化指定的字段。 |
-cmzfieldinclude <annotation> | 可选。用户自定义的annotation用于序列化时只序列化指定的字段。 |
以及javadoc和标准doclet原生的参数有:
参数名 | 含义 |
---|---|
-d <directory> | 输出文件的目标目录 |
-charset <charset> | 用于跨平台查看生成的文档的字符集 |
-doclet <class> | 通过替代 doclet 生成输出 |
-docletpath <path> | 指定查找 doclet 类文件的位置 |
-sourcepath <pathlist> | 指定查找源文件的位置 |
-classpath <pathlist> | 指定查找用户类文件的位置 |
-encoding <name> | 源文件编码名称 |
-nodeprecated | 不包含 @deprecated 信息 |
-taglet | 要注册的 Taglet 的全限定名称 |
-tagletpath | Taglet 的路径 |
通过命令行生成接口文档比较麻烦,需要在命令中指定所需的jar包路径,不推荐使用。下面是命令行生成接口文档的例子:
set jarpath=C:\Users\AdamsLee\.m2\repository
javadoc -doclet net.winroad.wrdoclet.HtmlDoclet -docletpath D:\Git\wrdoclet\wrdoclet\target\wrdoclet-1.0.0-SNAPSHOT.jar;%jarpath%\javax\servlet\servlet-api\2.5\servlet-api-2.5.jar;%jarpath%\org\springframework\spring-web\3.2.2.RELEASE\spring-web-3.2.2.RELEASE.jar;%jarpath%\org\springframework\spring-core\3.2.2.RELEASE\spring-core-3.2.2.RELEASE.jar;%jarpath%\org\slf4j\slf4j-api\1.7.5\slf4j-api-1.7.5.jar;%jarpath%\junit\junit\3.8.1\junit-3.8.1.jar;%jarpath%\com\google\code\gson\gson\2.3.1\gson-2.3.1.jar;%jarpath%\commons-io\commons-io\2.4\commons-io-2.4.jar;%jarpath%\commons-lang\commons-lang\2.5\commons-lang-2.5.jar;%jarpath%\org\freemarker\freemarker\2.3.19\freemarker-2.3.19.jar;%jarpath%\ch\qos\logback\logback-classic\1.0.3\logback-classic-1.0.3.jar;%jarpath%\ch\qos\logback\logback-core\1.0.3\logback-core-1.0.3.jar;%jarpath%\org\slf4j\slf4j-api\1.7.5\slf4j-api-1.7.5.jar;%jarpath%\org\slf4j\slf4j-jdk14\1.5.6\slf4j-jdk14-1.5.6.jar;%jarpath%\org\slf4j\slf4j-log4j12\1.7.5\slf4j-log4j12-1.7.5.jar;%jarpath%\javax\servlet\servlet-api\2.5\servlet-api-2.5.jar;%jarpath%\com\yahoo\platform\yui\yuicompressor\2.4.8\yuicompressor-2.4.8.jar;%jarpath%\org\springframework\spring-webmvc\3.2.2.RELEASE\spring-webmvc-3.2.2.RELEASE.jar;%jarpath%\org\springframework\spring-context\4.0.6.RELEASE\spring-context-4.0.6.RELEASE.jar -classpath %jarpath%\javax\servlet\servlet-api\2.5\servlet-api-2.5.jar;%jarpath%\org\springframework\spring-context\4.0.6.RELEASE\spring-context-4.0.6.RELEASE.jar;%jarpath%\javax\servlet\servlet-api\2.5\servlet-api-2.5.jar;%jarpath%\org\springframework\spring-web\3.2.2.RELEASE\spring-web-3.2.2.RELEASE.jar;%jarpath%\org\springframework\spring-core\3.2.2.RELEASE\spring-core-3.2.2.RELEASE.jar -taglet net.winroad.wrdoclet.taglets.WRTagTaglet net.winroad.wrdoclet.taglets.WRMemoTaglet net.winroad.wrdoclet.taglets.WRReturnCodeTaglet -encoding utf-8 -charset utf-8 -sourcepath D:\Git\wrdoclet\wrdoclet-demosite\src\main\java org.springframework.web.bind.annotation net.winroad.Controller -d D:\Git\gendoc -systemname demosite -branchname release