Class CompositeResolver

java.lang.Object

com.djrapitops.plan.delivery.web.resolver.CompositeResolver

All Implemented Interfaces:

AsyncResolver, Resolver

public final class CompositeResolver
extends Object
implements AsyncResolver

Utility Resolver for organizing resolution in a tree-like structure.

CompositeResolver removes first part of the target with URIPath.omitFirst() before calling the child Resolvers.

Example: resolverService.registerResolver("/test/", compositeResolver); The Resolvers added to CompositeResolver will be given Request with URIPath "/".

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CompositeResolver.Builder	Builder class for CompositeResolver.

Method Summary

Modifier and Type	Method	Description
static CompositeResolver.Builder	builder()	Create a new builder for a .
boolean	canAccess(Request request)	Implement access control if authorization is enabled.
boolean	requiresAuth(Request request)	Used to check if the resolver requires authentication to be used.
CompletableFuture<Optional<Response>>	resolveAsync(Request request)	Implement asynchronous request resolution.

Methods inherited from class Object

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

Methods inherited from interface AsyncResolver

resolve

Methods inherited from interface Resolver

newResponseBuilder, usedWebPermissions

Method Details

builder

public static CompositeResolver.Builder builder()

Create a new builder for a .

Returns:

a builder.

canAccess

public boolean canAccess(Request request)

Description copied from interface: Resolver

Implement access control if authorization is enabled.

Is not called when access control is not active.

Specified by:

canAccess in interface Resolver

Parameters:

request - HTTP request, contains all information necessary to check access.

Returns:

true if allowed or invalid target, false if response should be 403 (forbidden)

See Also:

• for WebUser that has access permissions.

resolveAsync

public CompletableFuture<Optional<Response>> resolveAsync(Request request)

Description copied from interface: AsyncResolver

Implement asynchronous request resolution.

Specified by:

resolveAsync in interface AsyncResolver

Parameters:

request - HTTP request, contains all information necessary to resolve the request.

Returns:

Future of Optional Response or empty if the response should be 404 (not found).

See Also:

• for return value
• for path /example/path etc
• for parameters ?param=value etc

requiresAuth

public boolean requiresAuth(Request request)

Description copied from interface: Resolver

Used to check if the resolver requires authentication to be used.

Specified by:

requiresAuth in interface Resolver

Parameters:

request - Incoming request that you can use to figure out if authentication is required.

Returns:

true if you want 401 to be given when user has not logged in.