Module org.eclipse.microprofile.openapi
Package org.eclipse.microprofile.openapi.models

Interface Extensible<T extends Extensible<T>>

All Known Subinterfaces:
APIResponse, APIResponses, Callback, Components, Contact, Encoding, Example, ExternalDocumentation, Header, Info, License, Link, MediaType, OAuthFlow, OAuthFlows, OpenAPI, Operation, Parameter, PathItem, Paths, RequestBody, Schema, SecurityScheme, Server, ServerVariable, Tag, XML
public interface Extensible<T extends Extensible<T>>
The base interface for OpenAPI model objects that can contain extensions. Extensions contain data not required by the specification and may or may not be supported by the tools you use.

The extensions property names are always prefixed by "x-".

  • Method Summary

    Modifier and Type
    Method
    Description
    T
    addExtension(String name, Object value)
    Adds the given object to this Extensible's map of extensions, with the given name as its key.
    default T
    extensions(Map<String,Object> extensions)
    Sets this Extensible's extensions property to the given map of extensions.
    default Object
    getExtension(String name)
    Returns the extension object with the given name from this Extensible's map of extensions.
    Map<String,Object>
    getExtensions()
    Returns the extensions property from an Extensible instance.
    default boolean
    hasExtension(String name)
    Checks whether an extension with the given name is present in this Extensible's map of extensions.
    void
    removeExtension(String name)
    Removes the given object to this Extensible's map of extensions, with the given name as its key.
    void
    setExtensions(Map<String,Object> extensions)
    Sets this Extensible's extensions property to the given map of extensions.

  • Method Details

    • getExtensions

      Map<String,Object> getExtensions()
      Returns the extensions property from an Extensible instance.
      Returns:
      a map containing keys which start with "x-" and values which provide additional information

    • extensions

      default T extensions(Map<String,Object> extensions)
      Sets this Extensible's extensions property to the given map of extensions.
      Parameters:
      extensions - map containing keys which start with "x-" and values which provide additional information
      Returns:
      the current instance

    • addExtension

      T addExtension(String name, Object value)
      Adds the given object to this Extensible's map of extensions, with the given name as its key.
      Parameters:
      name - the key used to access the extension object. Always prefixed by "x-".
      value - data not required by the specification. null values will be rejected (implementation will throw an exception) or ignored.
      Returns:
      the current instance

    • removeExtension

      void removeExtension(String name)
      Removes the given object to this Extensible's map of extensions, with the given name as its key.
      Parameters:
      name - the key used to access the extension object. Always prefixed by "x-".

    • setExtensions

      void setExtensions(Map<String,Object> extensions)
      Sets this Extensible's extensions property to the given map of extensions.
      Parameters:
      extensions - map containing keys which start with "x-" and values which provide additional information

    • hasExtension

      default boolean hasExtension(String name)
      Checks whether an extension with the given name is present in this Extensible's map of extensions.
      Parameters:
      name - the key used to access the extension object. Always prefixed by "x-".
      Returns:
      true if an extension with the given name is present, otherwise false

    • getExtension

      default Object getExtension(String name)
      Returns the extension object with the given name from this Extensible's map of extensions.
      Parameters:
      name - the key used to access the extension object. Always prefixed by "x-".
      Returns:
      the corresponding extension object, or null if no extension with the given name is present