Package org.apache.juneau.bean.openapi3

Class ExternalDocumentation

java.lang.Object
org.apache.juneau.bean.openapi3.OpenApiElement
org.apache.juneau.bean.openapi3.ExternalDocumentation
public class ExternalDocumentation extends OpenApiElement
Allows referencing an external resource for extended documentation.

The External Documentation Object allows referencing an external resource for extended documentation. This can be used to provide additional documentation that is not part of the main OpenAPI specification, such as detailed guides, tutorials, or API documentation hosted elsewhere.

OpenAPI Specification:

The External Documentation Object is composed of the following fields:

  • description (string) - A short description of the target documentation (CommonMark syntax may be used)
  • url (string, REQUIRED) - The URL for the target documentation
Example:

// Create external documentation reference ExternalDocumentation docs = new ExternalDocumentation() .setDescription("Find more info here") .setUrl("https://example.com");

See Also:

  • Constructor Details

  • Method Details

    • copy

      public ExternalDocumentation copy()
      Make a deep copy of this object.
      Returns:
      A deep copy of 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.

    • 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.

    • 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.

    • 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.

    • 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. Must not be null.
      value - The new value for the property.
      Returns:
      This object

    • 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

    • 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.
      Can be null to unset the property.
      Returns:
      This object

    • strict

      public ExternalDocumentation strict()
      Description copied from class: OpenApiElement
      Sets strict mode on this bean.
      Overrides:
      strict in class OpenApiElement
      Returns:
      This object

    • strict

      public ExternalDocumentation strict(Object value)
      Description copied from class: OpenApiElement
      Sets strict mode on this bean.
      Overrides:
      strict in class OpenApiElement
      Parameters:
      value - The new value for this property.
      Non-boolean values will be converted to boolean using Boolean.valueOf(value.toString()).
      Can be null (interpreted as false).
      Returns:
      This object