public class RestConfig
extends java.lang.Object
implements java.io.Serializable
REST 应用配置类,负责配置的加载及解析。
限定符和类型 | 字段和说明 |
---|---|
static java.lang.String |
defaultConfigFileName
默认的配置的文件名。
|
构造器和说明 |
---|
RestConfig() |
限定符和类型 | 方法和说明 |
---|---|
boolean |
equals(java.lang.Object obj)
验证是否为资源配置对象。
|
java.lang.String |
getAccessControlAllowOrigin()
获取访问控制允许的初始值。
|
java.util.Map<java.lang.String,java.lang.String> |
getComponentResourceMapping()
获取业务组件与 资源配置文件名的映射关系。
|
static RestConfig |
getDefaultConfig()
获取默认的配置。
|
double |
getDefaultHoldTime()
获取临时资源的默认存活时间。
|
java.lang.String |
getDefaultHttpActionHandlerBeanName()
获取默认请求处理器的bean名称。
|
MediaType |
getDefaultMediaType()
获取默认的资源表述类型。
|
java.util.List<java.lang.String> |
getExtensionResourceFinderBeanNames()
获取资源加载器。
|
java.util.List<MediaTypeMappingInfo> |
getRelationInfos()
获取关联信息。
|
java.lang.String |
getResourceFileNames()
获取资源文件的名称。
|
java.util.Map |
getRestConfigMap()
获取保存了应用配置信息的 java.util.Map 对象,其中,键为配置项名称,值为配置项的值。
|
java.lang.String |
getRootPath()
获取 REST 应用的根目录。
|
java.util.List<java.lang.String> |
getSystemDecoderBeanNames()
获取请求参数解析器。
|
java.util.List<java.lang.String> |
getSystemEncoderBeanNames()
获取资源表述生成器。
|
int |
hashCode()
获取对象实例的哈希值
|
boolean |
isDebug()
判断是否以 Debug 模式运行应用。
|
boolean |
isSecurityControlEnable()
判断是否加载安全控制器。
|
static RestConfig |
parse(java.io.File restConfigFile)
从文件系统中的一个文件加载应用配置。
|
static RestConfig |
parse(java.util.Map configMap)
根据一个 Map 对象,得到一个 REST 应用配置。
|
void |
removeCurrentThreadRootPath() |
void |
setAccessControlAllowOrigin(java.lang.String accessControlAllowOrigin)
设置访问控制允许的初始值。
|
void |
setComponentResourceMapping(java.util.Map<java.lang.String,java.lang.String> componentResourceMapping)
设置业务组件与 资源配置文件名的映射关系。
|
void |
setCurrentThreadRootPath(java.lang.String value) |
void |
setDebug(boolean isDebug)
设置是否采用调试模式的标志。
|
void |
setDefaultHoldTime(double defaultHoldTime)
设置临时资源的默认存活时间。
|
void |
setDefaultHttpActionHandlerBeanName(java.lang.String defaultHttpActionHandlerBeanName)
设置默认请求处理器的bean名称。
|
void |
setDefaultMediaType(MediaType defaultMediaType)
设置资源默认的表述类型。
|
void |
setExtensionResourceFinderBeanNames(java.util.List<java.lang.String> extensionResourceFinderBeanNames)
设置资源加载器的名称列表。
|
void |
setRelationInfos(java.util.List<MediaTypeMappingInfo> relationInfos)
设置 URI 后缀跟媒体类型的关联信息。
|
void |
setResourceFileNames(java.lang.String resourceFileNames)
设置资源文件的名称。
|
void |
setRootPath(java.lang.String rootPath)
设置 REST 应用的根目录。
|
void |
setSecurityControlEnable(boolean securityControlEnable)
设置是否加载安全控制器。
|
void |
setSystemDecoderBeanNames(java.util.List<java.lang.String> systemDecoderBeanNames)
设置请求参数解析器。
|
void |
setSystemEncoderBeanNames(java.util.List<java.lang.String> systemEncoderBeanNames)
设置资源表述生成器。
|
public static final java.lang.String defaultConfigFileName
默认的配置的文件名。
如“config/rest/AppContext.xml”。
public java.lang.String getRootPath()
获取 REST 应用的根目录。
例如:REST 应用的根目录为:“/services/rest”,则 REST 应用发布在本机 8090 端口时,根资源的 URI 为:http://localhost:8090/services/rest,相应地,maps 资源的 URI 为:http://localhost:8090/services/rest/maps。
public void setCurrentThreadRootPath(java.lang.String value)
public boolean equals(java.lang.Object obj)
验证是否为资源配置对象。
equals
在类中 java.lang.Object
obj
-public int hashCode()
hashCode
在类中 java.lang.Object
public java.util.Map getRestConfigMap()
获取保存了应用配置信息的 java.util.Map 对象,其中,键为配置项名称,值为配置项的值。
public void setDebug(boolean isDebug)
设置是否采用调试模式的标志。
在调试模式下,服务器响应的所有表述的媒体类型都是 text/plain,以利于调试。
isDebug
- isDebug 为 true 表示设置为调试模式,否则表示设置为非调试模式。public void setSecurityControlEnable(boolean securityControlEnable)
设置是否加载安全控制器。
securityControlEnable
- boolean 值,设为 true 表示加载安全控制器,否则表示不加载。public void setRootPath(java.lang.String rootPath)
设置 REST 应用的根目录。
rootPath
- REST 应用的根路径字符串。public java.util.List<java.lang.String> getExtensionResourceFinderBeanNames()
获取资源加载器。
public void setExtensionResourceFinderBeanNames(java.util.List<java.lang.String> extensionResourceFinderBeanNames)
设置资源加载器的名称列表。
extensionResourceFinderBeanNames
- 资源加载器的名称列表。public java.lang.String getResourceFileNames()
获取资源文件的名称。
public void setResourceFileNames(java.lang.String resourceFileNames)
设置资源文件的名称。
resourceFileNames
- 资源文件的名称。public MediaType getDefaultMediaType()
获取默认的资源表述类型。
当获取一个资源的表述时,没有给定表述类型,则返回默认类型的内容。 当表述类型不支持时,则用默认类型的内容给出错误信息。
public void setDefaultMediaType(MediaType defaultMediaType)
设置资源默认的表述类型。
所有的 URI 的后缀与媒体类型都有关联关系,如 .json 表示媒体类型为 application/json,但如果 URI 没有后缀,则对资源的表述要使用默认的表述类型。
defaultMediaType
- 欲设置的资源表述类型。public void setRelationInfos(java.util.List<MediaTypeMappingInfo> relationInfos)
设置 URI 后缀跟媒体类型的关联信息。
relationInfos
- 关联信息序列。public void setSystemEncoderBeanNames(java.util.List<java.lang.String> systemEncoderBeanNames)
设置资源表述生成器。
systemEncoderBeanNames
- 资源表述生成器的名称序列。public java.util.List<java.lang.String> getSystemEncoderBeanNames()
获取资源表述生成器。
public java.util.List<MediaTypeMappingInfo> getRelationInfos()
获取关联信息。
所有的 URI 的后缀与媒体类型都有关联关系,如 .json 表示媒体类型为 application/json。本函数就是获取所有的关联关系。
public java.util.List<java.lang.String> getSystemDecoderBeanNames()
获取请求参数解析器。
public void setSystemDecoderBeanNames(java.util.List<java.lang.String> systemDecoderBeanNames)
设置请求参数解析器。
systemDecoderBeanNames
- 欲设置的请求参数解析器的 Spring Bean 名称序列。public boolean isDebug()
判断是否以 Debug 模式运行应用。
对于某些媒体类型的响应对象,客户端浏览器是不能解析的,例如 application/json。如果不以 Debug 模式运行,客户端会直接保存成一个文件,而不能在浏览器中直接显示该媒体类型相应对象的内容;如果以 Debug 模式运行,响应对象(设为 JSON 类型的)就可以显示在客户端浏览器上,这时的消息体中的媒体类型就不是原来的 application/json,而被转化成了客户端浏览器可以解析的媒体类型。可以方便调试。
public boolean isSecurityControlEnable()
判断是否加载安全控制器。
public java.util.Map<java.lang.String,java.lang.String> getComponentResourceMapping()
获取业务组件与 资源配置文件名的映射关系。
public void setComponentResourceMapping(java.util.Map<java.lang.String,java.lang.String> componentResourceMapping)
设置业务组件与 资源配置文件名的映射关系。
componentResourceMapping
- 业务组件与 资源配置文件名的映射关系。public java.lang.String getDefaultHttpActionHandlerBeanName()
获取默认请求处理器的bean名称。
public void setDefaultHttpActionHandlerBeanName(java.lang.String defaultHttpActionHandlerBeanName)
设置默认请求处理器的bean名称。
defaultHttpActionHandlerBeanName
- 默认请求处理器的bean名称。public static RestConfig parse(java.io.File restConfigFile)
从文件系统中的一个文件加载应用配置。
要求该文件是一个 springBean 文件,文件中配置了 restConfig Bean 的信息,所有的配置都在该 Bean 中。
restConfigFile
- 存储配置信息的配置文件。public static RestConfig parse(java.util.Map configMap)
根据一个 Map 对象,得到一个 REST 应用配置。
configMap
- 存放了应用配置信息的 java.util.Map 对象。public static RestConfig getDefaultConfig()
获取默认的配置。
public java.lang.String getAccessControlAllowOrigin()
获取访问控制允许的初始值。
public void setAccessControlAllowOrigin(java.lang.String accessControlAllowOrigin)
设置访问控制允许的初始值。
accessControlAllowOrigin
- 访问控制允许的初始值。public double getDefaultHoldTime()
获取临时资源的默认存活时间。
public void setDefaultHoldTime(double defaultHoldTime)
设置临时资源的默认存活时间。
defaultHoldTime
- 临时资源的默认存活时间。public void removeCurrentThreadRootPath()