Package org.apache.juneau.dto.openapi3

Class ExternalDocumentation

java.lang.Object
org.apache.juneau.dto.openapi3.OpenApiElement
org.apache.juneau.dto.openapi3.ExternalDocumentation
@Bean(properties="description,url,*") public class ExternalDocumentation extends OpenApiElement
Allows referencing an external resource for extended documentation.

  • Constructor Details

  • Method Details

    • copy

      public ExternalDocumentation copy()
      Make a deep copy of this object.
      Returns:
      A deep copy of this object.

    • getDescription

      public String getDescription()
      Bean property getter: description.

      A short description of the target documentation.

      Returns:
      The property value, or null if it is not set.

    • setDescription

      public ExternalDocumentation setDescription(String value)
      Bean property setter: description.

      A short description of the target documentation.

      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getUrl

      public URI getUrl()
      Bean property getter: url.

      The URL for the target documentation.

      Returns:
      The property value, or null if it is not set.

    • setUrl

      public ExternalDocumentation setUrl(URI value)
      Bean property setter: url.

      The URL for the target documentation.

      Parameters:
      value - The new value for this property.
      Property value is required.
      URIs defined by UriResolver can be used for values.
      Returns:
      This object

    • get

      public <T> T get(String property, Class<T> type)
      Description copied from class: OpenApiElement
      Generic property getter.

      Can be used to retrieve non-standard Swagger fields such as "$ref".

      Overrides:
      get in class OpenApiElement
      Type Parameters:
      T - The datatype to cast the value to.
      Parameters:
      property - The property name to retrieve.
      type - The datatype to cast the value to.
      Returns:
      The property value, or null if the property does not exist or is not set.

    • set

      public ExternalDocumentation set(String property, Object value)
      Description copied from class: OpenApiElement
      Generic property setter.

      Can be used to set non-standard Swagger fields such as "$ref".

      Overrides:
      set in class OpenApiElement
      Parameters:
      property - The property name to set.
      value - The new value for the property.
      Returns:
      This object

    • keySet

      public Set<String> keySet()
      Description copied from class: OpenApiElement
      Returns all the keys on this element.
      Overrides:
      keySet in class OpenApiElement
      Returns:
      All the keys on this element.
      Never null.