Module io.helidon.openapi
Package io.helidon.openapi

Class OpenApiFeatureConfig.BuilderBase<BUILDER extends OpenApiFeatureConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends OpenApiFeatureConfig>

java.lang.Object
io.helidon.openapi.OpenApiFeatureConfig.BuilderBase<BUILDER,PROTOTYPE>
Type Parameters:
BUILDER - type of the builder extending this abstract builder
PROTOTYPE - type of the prototype interface that would be built by Prototype.Builder.buildPrototype()
All Implemented Interfaces:
Prototype.Builder<BUILDER,PROTOTYPE>, Prototype.ConfiguredBuilder<BUILDER,PROTOTYPE>
Direct Known Subclasses:
OpenApiFeatureConfig.Builder
Enclosing interface:
OpenApiFeatureConfig
public abstract static class OpenApiFeatureConfig.BuilderBase<BUILDER extends OpenApiFeatureConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends OpenApiFeatureConfig> extends Object implements Prototype.ConfiguredBuilder<BUILDER,PROTOTYPE>
Fluent API builder base for OpenApiFeature.

  • Constructor Details

    • BuilderBase

      protected BuilderBase()
      Protected to support extensibility.

  • Method Details

    • from

      public BUILDER from(OpenApiFeatureConfig prototype)
      Update this builder from an existing prototype instance. This method disables automatic service discovery.
      Parameters:
      prototype - existing prototype to update this builder from
      Returns:
      updated builder instance

    • from

      public BUILDER from(OpenApiFeatureConfig.BuilderBase<?,?> builder)
      Update this builder from an existing prototype builder instance.
      Parameters:
      builder - existing builder prototype to update this builder from
      Returns:
      updated builder instance

    • config

      public BUILDER config(Config config)
      Update builder from configuration (node of this type). If a value is present in configuration, it would override currently configured values.
      Specified by:
      config in interface Prototype.ConfiguredBuilder<BUILDER extends OpenApiFeatureConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends OpenApiFeatureConfig>
      Parameters:
      config - configuration instance used to obtain values to update this builder
      Returns:
      updated builder instance

    • weight

      public BUILDER weight(double weight)
      Weight of the OpenAPI feature. This is quite low, to be registered after routing. 90.0.
      Parameters:
      weight - weight of the feature
      Returns:
      updated builder instance
      See Also:

    • isEnabled

      public BUILDER isEnabled(boolean isEnabled)
      Sets whether the feature should be enabled.
      Parameters:
      isEnabled - true if enabled, false otherwise
      Returns:
      updated builder instance
      See Also:

    • webContext

      public BUILDER webContext(String webContext)
      Web context path for the OpenAPI endpoint.
      Parameters:
      webContext - webContext to use
      Returns:
      updated builder instance
      See Also:

    • clearStaticFile

      public BUILDER clearStaticFile()
      Clear existing value of this property.
      Returns:
      updated builder instance
      See Also:

    • staticFile

      public BUILDER staticFile(String staticFile)
      Path of the static OpenAPI document file. Default types are `json`, `yaml`, and `yml`.
      Parameters:
      staticFile - location of the static OpenAPI document file
      Returns:
      updated builder instance
      See Also:

    • clearCors

      public BUILDER clearCors()
      Clear existing value of this property.
      Returns:
      updated builder instance
      See Also:

    • cors

      public BUILDER cors(CrossOriginConfig cors)
      CORS config.
      Parameters:
      cors - CORS config
      Returns:
      updated builder instance
      See Also:

    • cors

      public BUILDER cors(Consumer<CrossOriginConfig.Builder> consumer)
      CORS config.
      Parameters:
      consumer - CORS config
      Returns:
      updated builder instance
      See Also:

    • servicesDiscoverServices

      public BUILDER servicesDiscoverServices(boolean discoverServices)
      OpenAPI services.
      Parameters:
      discoverServices - whether to discover implementations through service loader
      Returns:
      updated builder instance
      See Also:

    • services

      public BUILDER services(List<? extends OpenApiService> services)
      OpenAPI services.
      Parameters:
      services - the OpenAPI services
      Returns:
      updated builder instance
      See Also:

    • addServices

      public BUILDER addServices(List<? extends OpenApiService> services)
      OpenAPI services.
      Parameters:
      services - the OpenAPI services
      Returns:
      updated builder instance
      See Also:

    • addService

      public BUILDER addService(OpenApiService service)
      OpenAPI services.
      Parameters:
      service - the OpenAPI services
      Returns:
      updated builder instance
      See Also:

    • clearManager

      public BUILDER clearManager()
      Clear existing value of this property.
      Returns:
      updated builder instance
      See Also:

    • manager

      public BUILDER manager(OpenApiManager<?> manager)
      OpenAPI manager.
      Parameters:
      manager - the OpenAPI manager
      Returns:
      updated builder instance
      See Also:

    • permitAll

      public BUILDER permitAll(boolean permitAll)
      Whether to allow anybody to access the endpoint.
      Parameters:
      permitAll - whether to permit access to metrics endpoint to anybody, defaults to true
      Returns:
      updated builder instance
      See Also:

    • roles

      public BUILDER roles(List<? extends String> roles)
      Hints for role names the user is expected to be in.
      Parameters:
      roles - list of hints
      Returns:
      updated builder instance
      See Also:

    • addRoles

      public BUILDER addRoles(List<? extends String> roles)
      Hints for role names the user is expected to be in.
      Parameters:
      roles - list of hints
      Returns:
      updated builder instance
      See Also:

    • name

      public BUILDER name(String name)
      Name of this instance.
      Parameters:
      name - instance name, used when discovered from configuration
      Returns:
      updated builder instance
      See Also:

    • sockets

      public BUILDER sockets(Set<? extends String> sockets)
      List of sockets to register this feature on. If empty, it would get registered on all sockets.
      Parameters:
      sockets - socket names to register on, defaults to empty (all available sockets)
      Returns:
      updated builder instance
      See Also:

    • addSockets

      public BUILDER addSockets(Set<? extends String> sockets)
      List of sockets to register this feature on. If empty, it would get registered on all sockets.
      Parameters:
      sockets - socket names to register on, defaults to empty (all available sockets)
      Returns:
      updated builder instance
      See Also:

    • addSocket

      public BUILDER addSocket(String socket)
      List of sockets to register this feature on. If empty, it would get registered on all sockets.
      Parameters:
      socket - socket names to register on, defaults to empty (all available sockets)
      Returns:
      updated builder instance
      See Also:

    • weight

      public double weight()
      Weight of the OpenAPI feature. This is quite low, to be registered after routing. 90.0.
      Returns:
      the weight

    • isEnabled

      public boolean isEnabled()
      Sets whether the feature should be enabled.
      Returns:
      the is enabled

    • webContext

      public String webContext()
      Web context path for the OpenAPI endpoint.
      Returns:
      the web context

    • staticFile

      public Optional<String> staticFile()
      Path of the static OpenAPI document file. Default types are `json`, `yaml`, and `yml`.
      Returns:
      the static file

    • cors

      public Optional<CrossOriginConfig> cors()
      CORS config.
      Returns:
      the cors

    • services

      public List<OpenApiService> services()
      OpenAPI services.
      Returns:
      the services

    • manager

      public Optional<OpenApiManager<?>> manager()
      OpenAPI manager.
      Returns:
      the manager

    • permitAll

      public boolean permitAll()
      Whether to allow anybody to access the endpoint.
      Returns:
      the permit all
      See Also:

    • roles

      public List<String> roles()
      Hints for role names the user is expected to be in.
      Returns:
      the roles

    • name

      public String name()
      Name of this instance.
      Returns:
      the name

    • sockets

      public Set<String> sockets()
      List of sockets to register this feature on. If empty, it would get registered on all sockets.
      Returns:
      the sockets

    • config

      public Optional<Config> config()
      If this instance was configured, this would be the config instance used.
      Returns:
      config node used to configure this builder, or empty if not configured

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • preBuildPrototype

      protected void preBuildPrototype()
      Handles providers and decorators.

    • validatePrototype

      protected void validatePrototype()
      Validates required properties.