Package org.iplass.mtp.webapi.definition
Class WebApiDefinition
java.lang.Object
org.iplass.mtp.webapi.definition.WebApiDefinition
- All Implemented Interfaces:
Serializable,Definition
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionString[]long概要を取得します。表示名を取得します。getName()名前を取得します。String[]OpenAPI定義を取得します。OpenAPIのファイルタイプを取得します。OpenAPIのバージョンを取得します。WebApiレスポンスの結果の属性を取得します。String[]REST JSON として受付可能な Content-Type を取得します。String[]REST XML として受付可能な Content-Type を取得します。String[]Deprecated.getState()スタブコンテンツを取得します。スタブデフォルトコンテンツを取得します。booleanbooleanXMLHttpRequestがセットされていることを確認するかを取得します。booleanbooleanDeprecated.isPrivileged()を使用してください。booleanbooleanbooleanスタブレスポンスを返却するかを取得します。booleanbooleanvoidsetAccepts(RequestType[] accepts) voidsetAccessControlAllowCredentials(boolean accessControlAllowCredentials) voidsetAccessControlAllowOrigin(String accessControlAllowOrigin) voidsetAllowRequestContentTypes(String[] allowRequestContentTypes) 許可するリクエストボディのContentTypeを指定。未指定の場合はすべて許可。
accepts指定より、allowRequestContentTypesの指定による制限が優先されます。
例えば、 accepts指定によりJSON形式の処理が有効化されている場合において、 allowRequestContentTypesに"application/json"が含まれない場合は、 JSON形式によるリクエストは処理されません。voidsetCacheControlMaxAge(long cacheControlMaxAge) cacheControlMaxAge=CacheControlType.CACHEを指定した場合の WebAPIキャッシュのmax-age(秒)を指定。 デフォルト値は-1でこの場合はmax-ageは未指定となる。
注意:max-age未指定の場合、FF、Chromeでは実際はキャッシュが利用されないvoidsetCacheControlType(CacheControlType cacheControlType) WebAPIキャッシュ指定(Cache-Controlヘッダの制御)。 未指定の場合はキャッシュをしない。 ブラウザ種別によらず、キャッシュを有効化するためには、合わせてCacheControlMaxAgeの設定も必要。voidsetCheckXRequestedWithHeader(boolean isCheckXRequestedWithHeader) XMLHttpRequestチェック可否を設定します。voidsetCommandConfig(CommandConfig commandConfig) voidsetDescription(String description) 概要を設定します。voidsetDisplayName(String displayName) 表示名を設定します。voidsetMaxFileSize(Long maxFileSize) multipart/form-data時のアップロードファイルの最大サイズ。-1の場合は無制限。 1つのファイルに対する最大サイズなので、複数のファイルの合計サイズを制限したい場合は、 maxRequestBodySizeを設定します。voidsetMaxRequestBodySize(Long maxRequestBodySize) リクエストボディの最大サイズ。-1の場合は無制限。voidsetMethods(MethodType[] methods) void名前を設定します。voidsetNeedTrustedAuthenticate(boolean needTrustedAuthenticate) voidsetOauthScopes(String[] oauthScopes) voidsetOpenApi(String openApi) OpenAPI定義を設定します。voidsetOpenApiFileType(String openApiFileType) OpenAPIのファイルタイプを設定します。voidsetOpenApiVersion(String openApiVersion) OpenAPIのバージョンを設定します。voidsetPrivilaged(boolean isPrivileged) Deprecated.setPrivileged(boolean)を使用してください。voidsetPrivileged(boolean isPrivileged) voidsetPublicWebApi(boolean isPublicWebApi) このWebApiの呼び出しをセキュリティ設定によらず呼び出し可能にする場合は、trueを設定します。 isPrivilegedとの違いは、Entityの操作などにおいては、セキュリティ制約を受けます。 デフォルトはfalseです。voidsetResponseResults(WebApiResultAttribute[] responseResults) WebApiレスポンスの結果の属性を設定します。voidsetResponseType(String responseType) voidsetRestJsonAcceptableContentTypes(String[] acceptableContentTypes) REST JSON として受付可能な Content-Type を設定します。voidsetRestJsonParameterName(String restJsonParameterName) voidsetRestJsonParameterType(String restJsonParameterType) voidsetRestXmlAcceptableContentTypes(String[] acceptableContentTypes) REST XML として受付可能な Content-Type を設定します。voidsetRestXmlParameterName(String restXmlParameterName) voidsetRestXmlParameterType(String restXmlParameterType) voidsetResults(String[] results) Deprecated.setResponseResults(WebApiResultAttribute[])を使用してください。本メソッドは大きなバージョンアップで削除する予定です。voidsetReturnStubResponse(boolean returnStubResponse) スタブレスポンスを返却するかを設定します。voidWebApiをStatelessとして呼び出すか否かを設定します。 デフォルトは、StateType.STATEFULです。voidsetStubContents(WebApiStubContent[] stubContents) スタブコンテンツを設定します。voidsetStubDefaultContent(String stubDefaultConetnt) スタブデフォルトコンテンツを設定します。voidsetSupportBearerToken(boolean supportBearerToken) voidsetSynchronizeOnSession(boolean synchronizeOnSession) voidsetTokenCheck(WebApiTokenCheck tokenCheck) voidsetWebApiParamMap(WebApiParamMapDefinition[] webApiParamMap)
-
Constructor Details
-
WebApiDefinition
public WebApiDefinition()
-
-
Method Details
-
getMaxFileSize
-
setMaxFileSize
multipart/form-data時のアップロードファイルの最大サイズ。-1の場合は無制限。 1つのファイルに対する最大サイズなので、複数のファイルの合計サイズを制限したい場合は、 maxRequestBodySizeを設定します。- Parameters:
maxFileSize-
-
getMaxRequestBodySize
-
setMaxRequestBodySize
リクエストボディの最大サイズ。-1の場合は無制限。- Parameters:
maxRequestBodySize-
-
getAllowRequestContentTypes
-
setAllowRequestContentTypes
許可するリクエストボディのContentTypeを指定。未指定の場合はすべて許可。
accepts指定より、allowRequestContentTypesの指定による制限が優先されます。
例えば、 accepts指定によりJSON形式の処理が有効化されている場合において、 allowRequestContentTypesに"application/json"が含まれない場合は、 JSON形式によるリクエストは処理されません。- Parameters:
allowRequestContentTypes-
-
getOauthScopes
-
setOauthScopes
-
isSupportBearerToken
public boolean isSupportBearerToken() -
setSupportBearerToken
public void setSupportBearerToken(boolean supportBearerToken) -
getState
-
setState
WebApiをStatelessとして呼び出すか否かを設定します。 デフォルトは、StateType.STATEFULです。- Parameters:
state-
-
isNeedTrustedAuthenticate
public boolean isNeedTrustedAuthenticate() -
setNeedTrustedAuthenticate
public void setNeedTrustedAuthenticate(boolean needTrustedAuthenticate) -
getAccessControlAllowOrigin
-
setAccessControlAllowOrigin
-
isAccessControlAllowCredentials
public boolean isAccessControlAllowCredentials() -
setAccessControlAllowCredentials
public void setAccessControlAllowCredentials(boolean accessControlAllowCredentials) -
getResponseType
-
setResponseType
-
isSynchronizeOnSession
public boolean isSynchronizeOnSession() -
setSynchronizeOnSession
public void setSynchronizeOnSession(boolean synchronizeOnSession) -
getTokenCheck
-
setTokenCheck
-
getRestJsonParameterType
-
setRestJsonParameterType
-
getRestJsonParameterName
-
setRestJsonParameterName
-
getRestJsonAcceptableContentTypes
REST JSON として受付可能な Content-Type を取得します。- Returns:
- Content-Type 配列
-
setRestJsonAcceptableContentTypes
REST JSON として受付可能な Content-Type を設定します。- Parameters:
acceptableContentTypes- Content-Type 配列
-
getRestXmlParameterName
-
setRestXmlParameterName
-
getRestXmlParameterType
-
setRestXmlParameterType
-
getRestXmlAcceptableContentTypes
REST XML として受付可能な Content-Type を取得します。- Returns:
- Content-Type 配列
-
setRestXmlAcceptableContentTypes
REST XML として受付可能な Content-Type を設定します。- Parameters:
acceptableContentTypes- Content-Type 配列
-
getAccepts
-
setAccepts
-
getMethods
-
setMethods
-
getName
Description copied from interface:Definition名前を取得します。- Specified by:
getNamein interfaceDefinition- Returns:
- name
-
setName
Description copied from interface:Definition名前を設定します。- Specified by:
setNamein interfaceDefinition- Parameters:
name- セットする name
-
getDisplayName
Description copied from interface:Definition表示名を取得します。- Specified by:
getDisplayNamein interfaceDefinition- Returns:
- displayName
-
setDisplayName
Description copied from interface:Definition表示名を設定します。- Specified by:
setDisplayNamein interfaceDefinition- Parameters:
displayName- セットする displayName
-
getDescription
Description copied from interface:Definition概要を取得します。- Specified by:
getDescriptionin interfaceDefinition- Returns:
- description
-
setDescription
Description copied from interface:Definition概要を設定します。- Specified by:
setDescriptionin interfaceDefinition- Parameters:
description- セットする description
-
getCacheControlType
- Returns:
- cacheControlType
- See Also:
-
setCacheControlType
WebAPIキャッシュ指定(Cache-Controlヘッダの制御)。 未指定の場合はキャッシュをしない。 ブラウザ種別によらず、キャッシュを有効化するためには、合わせてCacheControlMaxAgeの設定も必要。- Parameters:
cacheControlType-- See Also:
-
getCacheControlMaxAge
public long getCacheControlMaxAge()- Returns:
- See Also:
-
setCacheControlMaxAge
public void setCacheControlMaxAge(long cacheControlMaxAge) cacheControlMaxAge=CacheControlType.CACHEを指定した場合の WebAPIキャッシュのmax-age(秒)を指定。 デフォルト値は-1でこの場合はmax-ageは未指定となる。
注意:max-age未指定の場合、FF、Chromeでは実際はキャッシュが利用されない- Parameters:
cacheControlMaxAge-
-
getCommandConfig
- Returns:
- commandConfig
-
setCommandConfig
- Parameters:
commandConfig- セットする commandConfig
-
getWebApiParamMap
- Returns:
- paramMap
-
setWebApiParamMap
- Parameters:
webApiParamMap- セットする webApiParamMap
-
getResults
Deprecated.getResponseResults()を使用してください。本メソッドは大きなバージョンアップで削除する予定です。- Returns:
- result
-
setResults
Deprecated.setResponseResults(WebApiResultAttribute[])を使用してください。本メソッドは大きなバージョンアップで削除する予定です。- Parameters:
result- セットする result
-
getResponseResults
WebApiレスポンスの結果の属性を取得します。- Returns:
- WebApiレスポンスの結果の属性
-
setResponseResults
WebApiレスポンスの結果の属性を設定します。- Parameters:
responseResults- WebApiレスポンスの結果の属性
-
isPublicWebApi
public boolean isPublicWebApi() -
setPublicWebApi
public void setPublicWebApi(boolean isPublicWebApi) このWebApiの呼び出しをセキュリティ設定によらず呼び出し可能にする場合は、trueを設定します。 isPrivilegedとの違いは、Entityの操作などにおいては、セキュリティ制約を受けます。 デフォルトはfalseです。- Parameters:
isPublicWebApi-
-
isPrivilaged
Deprecated.isPrivileged()を使用してください。- Returns:
-
setPrivilaged
Deprecated.setPrivileged(boolean)を使用してください。- Parameters:
isPrivileged-
-
isPrivileged
public boolean isPrivileged()- Returns:
-
setPrivileged
public void setPrivileged(boolean isPrivileged) - Parameters:
isPrivileged-
-
isCheckXRequestedWithHeader
public boolean isCheckXRequestedWithHeader()XMLHttpRequestがセットされていることを確認するかを取得します。- Returns:
- XMLHttpRequestチェック可否
-
setCheckXRequestedWithHeader
public void setCheckXRequestedWithHeader(boolean isCheckXRequestedWithHeader) XMLHttpRequestチェック可否を設定します。- Parameters:
isCheckXRequestedWithHeader-
-
isReturnStubResponse
public boolean isReturnStubResponse()スタブレスポンスを返却するかを取得します。- Returns:
- スタブレスポンスを返却する場合は true を返却
-
setReturnStubResponse
public void setReturnStubResponse(boolean returnStubResponse) スタブレスポンスを返却するかを設定します。- Parameters:
returnStubResponse- スタブレスポンスを返却する場合は true を設定
-
getStubDefaultContent
スタブデフォルトコンテンツを取得します。getStubContents()に対応するコンテンツが設定されていない場合のデフォルト返却値です。- Returns:
- スタブデフォルトコンテンツ
-
setStubDefaultContent
スタブデフォルトコンテンツを設定します。getStubContents()に対応するコンテンツが設定されていない場合のデフォルト返却値です。- Parameters:
stubDefaultConetnt- スタブデフォルトコンテンツ
-
getStubContents
スタブコンテンツを取得します。- Returns:
- スタブコンテンツ配列
-
setStubContents
スタブコンテンツを設定します。- Parameters:
stubContents- スタブコンテンツ配列
-
getOpenApiVersion
OpenAPIのバージョンを取得します。- Returns:
- OpenAPIのバージョン
-
setOpenApiVersion
OpenAPIのバージョンを設定します。3.0, 3.1 などマイナーバージョンまで記載します。 OpenAPI バージョンに記載できる内容は
OpenApiVersionを参照してください。- Parameters:
openApiVersion- OpenAPIのバージョン
-
getOpenApiFileType
OpenAPIのファイルタイプを取得します。- Returns:
- OpenAPIのファイルタイプ
-
setOpenApiFileType
OpenAPIのファイルタイプを設定します。OpenAPI のフォーマットは、JSON または YAML です。 設定できる内容は、
OpenApiFileTypeを参照してください。- Parameters:
openApiFileType- OpenAPIのファイルタイプ
-
getOpenApi
OpenAPI定義を取得します。- Returns:
- OpenAPI定義
-
setOpenApi
OpenAPI定義を設定します。- Parameters:
openApi- OpenAPI定義
-
getResponseResults()を使用してください。本メソッドは大きなバージョンアップで削除する予定です。