Annotation Interface ApiParams


@Retention(RUNTIME) @Documented @Target(TYPE) public @interface ApiParams
Used to annotate a nested configuration parameter type (such as a nested Configuration object) which can then be used on a API based component, endpoint. This is only applicable for API based components where configurations are separated by API names and methods (grouping).
  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    The API methods that the API provides of this configuration class.
  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    Returns the method alias(s) of this api method.
    The API name (grouping) of this configuration class.
    boolean
    Whether this API can only be used as a consumer.
    Returns a description of the API.
    boolean
    Whether this API can only be used as a producer.
  • Element Details

    • apiMethods

      ApiMethod[] apiMethods
      The API methods that the API provides of this configuration class.
    • apiName

      String apiName
      The API name (grouping) of this configuration class.
      Default:
      ""
    • description

      String description
      Returns a description of the API.

      This is used for documentation and tooling only.

      Default:
      ""
    • producerOnly

      boolean producerOnly
      Whether this API can only be used as a producer.

      By default its assumed the API can be used as both consumer and producer.

      Default:
      false
    • consumerOnly

      boolean consumerOnly
      Whether this API can only be used as a consumer.

      By default its assumed the API can be used as both consumer and producer.

      Default:
      false
    • aliases

      String[] aliases
      Returns the method alias(s) of this api method. The syntax for an alias is pattern=name where pattern is a regular expression.

      This is used for documentation and tooling only.

      Default:
      {""}