key | target(context) | version | desc |
---|---|---|---|
module | class | v0.7.2+ | group api |
ignore | class/method | v0.7.2+ | ignore API |
json.rule.field.name | field | v0.7.2+ | Set the output field name(while the field name used in JSON is inconsistent with the field name in the class) |
json.rule.field.ignore | field | v0.7.2+ | Ignore fields (the field will be skipped from the serialized output) |
☆json.rule.convert | - | v0.7.2+ | Mark some type conversions to other type processing, usually when spring's custom type converter is used |
json.rule.enum.convert | class | v1.2.0+ | Special conversion for enumeration types |
☆doc.field | field | v0.7.2+ | Additional comments for fields |
doc.method | method | v0.7.2+ | Additional comments for method (API) |
doc.class | class | v1.3.0+ | Additional comments for class |
doc.param | arg | v1.3.0+ | Additional comments for parameter |
param.required | arg | v0.7.3+ | Whether the API parameter is required (NotNull) |
param.ignore | arg | v1.3.0+ | Ignore API parameter |
param.default.value | arg | v1.3.0+ | Default value for API parameter |
method.additional.header | method | v1.3.0+ | API requires additional headers |
{name: "header name",value: "",desc: "",required:false, example:""} | |||
method.additional.param | method | v1.3.0+ | API requires additional parameters |
{name: "param name",value: "defaultValue",desc: "",required:false} | |||
method.additional.response.header | method | v1.3.0+ | API response contains additional headers |
{name: "header name",value: "",desc: "",required:false, example:""} | |||
field.required | field | v0.7.3+ | Whether the field is required (NotNull) |
field.default.value | - | v1.7.1+ | The default value of a field |
mdoc.class.filter | class | v0.9.5+ | Filter classes which can export method documents(rpc) |
mdoc.method.filter | method | v0.9.5+ | Filter methods which can export method documents(rpc) |
class.prefix.path | class | v1.3.0+ | Set base path for APIs in the class |
constant.field.ignore | field | v1.3.8+ | ignore constant field |
☆method.return.main | method | v1.3.8+ | The core body of the return value |
☆method.return | method | v1.6.1+ | The type of return value |
api.name | method | v1.4.1+ | the name of api |
method.default.http.method | method | v1.4.2+ | the default httpmethod of the API |
postman.host | class | v1.5.2+ | Set the host of API (for 'postman' only) |
Simple configurations without context
key | target(context) | version | desc |
---|---|---|---|
dev | v2.2.1+ | bool | Enables development mode, providing more detailed logs. |
max.deep | v2.3.6+ | int | Sets the maximum depth for json parsing, default is 6. |
max.elements | v2.3.6+ | int | Sets the maximum field count for json parsing, default is 256. |
json.cache.disable | v2.1.0+ | bool | Disables json parsing cache. |
http.timeOut | v2.1.0+ | int | Sets the http request timeout (s), prioritized over setting . |
ignore_static_and_final_field | v2.1.0+ | bool | By default, the plugin ignores static final fields. Set to false to change this behavior. |
ignore_irregular_api_method | v2.5.4+ | bool | By default, the plugin ignores API methods with names matching basic Object method names. Set to false to change this behavior. |
doc.source.disable | v2.5.5+ | bool | Set to true to prevent the plugin from reading comments. |
Some callback methods might not have it
, but additional context may be available for use.
key | target(context) | version | desc |
---|---|---|---|
api.class.parse.before | class | None | v2.2.8+ |
api.class.parse.after | class | None | v2.2.8+ |
api.method.parse.before | method | None | v2.2.8+ |
api.method.parse.after | method | None | v2.2.8+ |
api.param.parse.before | param | None | v2.2.8+ |
api.param.parse.after | param | None | v2.2.8+ |
export.after | method | api | v2.0.1+ |
http.call.before | None | request | v1.9.0+ |
http.call.after | None | request, response | v1.9.0+ |
json.class.parse.before | class | None | v2.2.8+ |
json.class.parse.after | class | None | v2.2.8+ |
json.field.parse.before | field | None | v2.2.8+ |
json.field.parse.after | field | None | v2.2.8+ |
# Read tag on comment
/**
* @fake
*/
@ Read annotation
@RequestMapping("path")
public class FakeClass{...}
@RequestMapping(value = "path")
public class FakeClass{...}