org.noear.solon.docs

类 DocDocket

java.lang.Object

org.noear.solon.docs.DocDocket

所有已实现的接口:

java.io.Serializable

直接已知子类:

DocDocketProperties

public class DocDocket
extends java.lang.Object
implements java.io.Serializable

文档摘要

从以下版本开始:

2.2

另请参阅:

序列化表格

构造器概要

构造器

构造器和说明
DocDocket()

方法概要

限定符和类型	方法和说明
java.util.List<ApiResource>	apis() 接口资源
DocDocket	apis(ApiResource apiResource) 配置接口资源
DocDocket	apis(java.lang.String basePackage) 配置接口资源
java.lang.String	basePath() 基础路径
DocDocket	basePath(java.lang.String basePath) 配置基础路径
java.util.Map<java.lang.String,java.lang.String>	basicAuth() 基础鉴权（格式：admin#123456,user#654321,张三#abc）
DocDocket	basicAuth(BasicAuth basicAuth) 配置基础鉴权
DocDocket	basicAuth(java.lang.String username, java.lang.String password) 配置基础鉴权
DocDocket	enable(boolean enable) 配置是否启用
ApiExternalDocs	externalDocs() 外部文档
DocDocket	externalDocs(ApiExternalDocs externalDocs) 配置外部文档
DocDocket	externalDocs(java.lang.String description, java.lang.String url) 配置外部文档
java.util.Set<java.lang.Object>	globalParams() 全局参数
DocDocket	globalParams(java.util.Collection<java.lang.Object> globalParams) 配置全局参数
DocDocket	globalParams(java.lang.Object param) 配置全局参数
java.util.Map<java.lang.Integer,java.lang.String>	globalResponseCodes() 全局响应代码描述（401,403...）
DocDocket	globalResponseCodes(java.util.Map<java.lang.Integer,java.lang.String> globalResponseCodes) 配置全局响应代码描述（401,403...）
boolean	globalResponseInData() 全局响应到data下面
DocDocket	globalResponseInData(boolean globalResponseInData) 配置全局响应到data下面
java.lang.Class<?>	globalResult() 全局结果类
DocDocket	globalResult(java.lang.Class<?> clz) 配置全局结果类
java.lang.String	groupName() 分组名字
DocDocket	groupName(java.lang.String groupName) 配置分组名字
java.lang.String	host() 主机
DocDocket	host(java.lang.String host) 配置主机
ApiInfo	info() 接口信息
DocDocket	info(ApiInfo info) 配置接口信息
boolean	isEnable() 是否启用
java.util.List<ApiScheme>	schemes() 协议架构（http, https）
DocDocket	schemes(java.lang.String... schemes) 配置协议架构（http, https）
java.util.Map<java.lang.String,java.lang.Object>	securityExtensions() 安全扩展
DocDocket	securityExtensions(java.util.Map<java.lang.String,java.lang.Object> securityExtensions) 配置安全扩展
DocDocket	securityExtensions(java.lang.String name, java.lang.Object value) 配置安全扩展
Serializer<java.lang.String>	serializer() 序列化
void	serializer(Serializer<java.lang.String> serializer) 配置序列化
DocUpstream	upstream() 获取上游
DocDocket	upstream(DocUpstream upstream) 配置上游
DocDocket	upstream(java.lang.String target, java.lang.String contextPath, java.lang.String path) 配置上游
java.util.Map<java.lang.String,java.lang.Object>	vendorExtensions() 供应商扩展
DocDocket	vendorExtensions(java.util.List<ApiVendorExtension> extensions) 配置供应商扩展
DocDocket	vendorExtensions(java.util.Map<java.lang.String,java.lang.Object> vendorExtensions) 配置供应商扩展
DocDocket	vendorExtensions(java.lang.String name, java.lang.Object value) 配置供应商扩展
java.lang.String	version() 版本号
DocDocket	version(java.lang.String version) 配置版本号

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

DocDocket

public DocDocket()

方法详细资料

isEnable

public boolean isEnable()

是否启用

enable

public DocDocket enable(boolean enable)

配置是否启用

version

public java.lang.String version()

版本号

version

public DocDocket version(java.lang.String version)

配置版本号

host

public java.lang.String host()

主机

host

public DocDocket host(java.lang.String host)

配置主机

schemes

public java.util.List<ApiScheme> schemes()

协议架构（http, https）

schemes

public DocDocket schemes(java.lang.String... schemes)

配置协议架构（http, https）

groupName

public java.lang.String groupName()

分组名字

groupName

public DocDocket groupName(java.lang.String groupName)

配置分组名字

basePath

public java.lang.String basePath()

基础路径

basePath

public DocDocket basePath(java.lang.String basePath)

配置基础路径

basicAuth

public java.util.Map<java.lang.String,java.lang.String> basicAuth()

基础鉴权（格式：admin#123456,user#654321,张三#abc）

basicAuth

public DocDocket basicAuth(java.lang.String username,
                           java.lang.String password)

配置基础鉴权

basicAuth

public DocDocket basicAuth(BasicAuth basicAuth)

配置基础鉴权

apis

public java.util.List<ApiResource> apis()

接口资源

apis

public DocDocket apis(java.lang.String basePackage)

配置接口资源

apis

public DocDocket apis(ApiResource apiResource)

配置接口资源

info

public ApiInfo info()

接口信息

info

public DocDocket info(ApiInfo info)

配置接口信息

upstream

public DocUpstream upstream()

获取上游

upstream

public DocDocket upstream(DocUpstream upstream)

配置上游

upstream

public DocDocket upstream(java.lang.String target,
                          java.lang.String contextPath,
                          java.lang.String path)

配置上游

globalResponseInData

public boolean globalResponseInData()

全局响应到data下面

globalResponseInData

public DocDocket globalResponseInData(boolean globalResponseInData)

配置全局响应到data下面

globalResponseCodes

public java.util.Map<java.lang.Integer,java.lang.String> globalResponseCodes()

全局响应代码描述（401,403...）

globalResponseCodes

public DocDocket globalResponseCodes(java.util.Map<java.lang.Integer,java.lang.String> globalResponseCodes)

配置全局响应代码描述（401,403...）

globalResult

public java.lang.Class<?> globalResult()

全局结果类

globalResult

public DocDocket globalResult(java.lang.Class<?> clz)

配置全局结果类

globalParams

public java.util.Set<java.lang.Object> globalParams()

全局参数

globalParams

public DocDocket globalParams(java.util.Collection<java.lang.Object> globalParams)

配置全局参数

globalParams

public DocDocket globalParams(java.lang.Object param)

配置全局参数

externalDocs

public ApiExternalDocs externalDocs()

外部文档

externalDocs

public DocDocket externalDocs(ApiExternalDocs externalDocs)

配置外部文档

externalDocs

public DocDocket externalDocs(java.lang.String description,
                              java.lang.String url)

配置外部文档

vendorExtensions

public java.util.Map<java.lang.String,java.lang.Object> vendorExtensions()

供应商扩展

vendorExtensions

public DocDocket vendorExtensions(java.util.Map<java.lang.String,java.lang.Object> vendorExtensions)

配置供应商扩展

vendorExtensions

public DocDocket vendorExtensions(java.lang.String name,
                                  java.lang.Object value)

配置供应商扩展

vendorExtensions

public DocDocket vendorExtensions(java.util.List<ApiVendorExtension> extensions)

配置供应商扩展

securityExtensions

public java.util.Map<java.lang.String,java.lang.Object> securityExtensions()

安全扩展

securityExtensions

public DocDocket securityExtensions(java.util.Map<java.lang.String,java.lang.Object> securityExtensions)

配置安全扩展

securityExtensions

public DocDocket securityExtensions(java.lang.String name,
                                    java.lang.Object value)

配置安全扩展

serializer

public Serializer<java.lang.String> serializer()

序列化

serializer

public void serializer(Serializer<java.lang.String> serializer)

配置序列化