Package io.helidon.security

Class EndpointConfig

java.lang.Object

io.helidon.security.EndpointConfig

All Implemented Interfaces:

AbacSupport

public final class EndpointConfig
extends java.lang.Object
implements AbacSupport

Each endpoint can have security configuration either statically declared (e.g. annotations) or dynamically provided through manual security request. This class covers all kinds of configurations supported:

• Annotations as gathered by the integration component (e.g. from Jersey resource class and method)
• Configuration as read from a configuration resource (e.g. when integrating web server)
• Attributes (key/value) configured by a programmer
• Custom objects configured by a programmer

Each provider defines annotations, configuration keys, attributes and custom objects it supports and expects.

See Also:

SecurityProvider.supportedAnnotations(), SecurityProvider.supportedCustomObjects(), SecurityProvider.supportedConfigKeys(), SecurityProvider.supportedAttributes()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EndpointConfig.AnnotationScope Scope of annotations used in applications that integrate security.
static class	EndpointConfig.Builder A fluent API builder for EndpointConfig.

Nested classes/interfaces inherited from interface io.helidon.security.util.AbacSupport

AbacSupport.BasicAttributes

Method Summary

Modifier and Type	Method and Description
static EndpointConfig.Builder	builder() Creates a fluent API builder to build new instances of this class.
<T extends java.lang.annotation.Annotation> java.util.List<T>	combineAnnotations(java.lang.Class<T> annotationClass, EndpointConfig.AnnotationScope... scopes) Get all annotations of a specific class declared on any level.
static EndpointConfig	create() Create an instance of endpoint config with default values (e.g.
EndpointConfig.Builder	derive() Derive a new endpoint configuration builder based on this instance.
java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.util.List<java.lang.annotation.Annotation>>	getAnnotations(EndpointConfig.AnnotationScope... scopes) All custom annotations for scopes defined in parameters, in the same order.
java.util.Collection<java.lang.String>	getAttributeNames() A collection of all property names in this container.
java.lang.Object	getAttributeRaw(java.lang.String key) Return the actual property value or null if not present.
java.util.Optional<Config>	getConfig(java.lang.String configKey) Get Config instance for a config key.
<U> java.util.Optional<U>	getInstance(java.lang.Class<U> clazz) Get an instance of a custom object configuring this endpoint.
java.util.Collection<java.lang.Class<?>>	getInstanceKeys() Get all classes of custom endpoint configuration object registered.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.helidon.security.util.AbacSupport

getAttribute

Method Detail

builder

public static EndpointConfig.Builder builder()

Creates a fluent API builder to build new instances of this class.

Returns:

a builder instance

create

public static EndpointConfig create()

Create an instance of endpoint config with default values (e.g. all empty).

Returns:

endpoint config instance

getAttributeRaw

public java.lang.Object getAttributeRaw(java.lang.String key)

Description copied from interface: AbacSupport

Return the actual property value or null if not present. This is the only method that needs to be implemented.

Specified by:

getAttributeRaw in interface AbacSupport

Parameters:

key - key (name) of the property

Returns:

value of the property or null

getAttributeNames

public java.util.Collection<java.lang.String> getAttributeNames()

Description copied from interface: AbacSupport

A collection of all property names in this container.

Specified by:

getAttributeNames in interface AbacSupport

Returns:

collection of keys

getInstance

public <U> java.util.Optional<U> getInstance(java.lang.Class<U> clazz)

Get an instance of a custom object configuring this endpoint.

Type Parameters:

U - type of the configuration

Parameters:

clazz - class the instance is bound under (only explicit binding is supported)

Returns:

instance of the custom object if present

getInstanceKeys

public java.util.Collection<java.lang.Class<?>> getInstanceKeys()

Get all classes of custom endpoint configuration object registered.

Returns:

classes that are keys in the custom object store

getConfig

public java.util.Optional<Config> getConfig(java.lang.String configKey)

Get Config instance for a config key.

Parameters:

configKey - key of configuration expected

Returns:

Config instance if present in this endpoint configuration

getAnnotations

public java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.util.List<java.lang.annotation.Annotation>> getAnnotations(EndpointConfig.AnnotationScope... scopes)

All custom annotations for scopes defined in parameters, in the same order.

Parameters:

scopes - scopes the caller is interested in

Returns:

a map of annotation classes to annotation instances

See Also:

SecurityProvider.supportedAnnotations()

combineAnnotations

public <T extends java.lang.annotation.Annotation> java.util.List<T> combineAnnotations(java.lang.Class<T> annotationClass,
                                                                                        EndpointConfig.AnnotationScope... scopes)

Get all annotations of a specific class declared on any level.

Type Parameters:

T - type of annotation wanted

Parameters:

annotationClass - Class of annotation you want

scopes - scopes the caller is interested in

Returns:

list of annotations in order specified by methodFirst parameter

derive

public EndpointConfig.Builder derive()

Derive a new endpoint configuration builder based on this instance.

Returns:

builder to build a modified copy of this endpoint config