Interface Handler.Collection

All Superinterfaces:

Destroyable, Handler, Handler.Container, Invocable, LifeCycle, Request.Handler

All Known Implementing Classes:

ContextHandlerCollection, Handler.Sequence

Enclosing interface:

Handler

public static interface Handler.Collection
extends Handler.Container

A Handler.Container that can contain multiple other Handlers.

See Also:

• for an implementation of Collection.
• Handler.Singleton

Nested Class Summary

Nested classes/interfaces inherited from interface Handler

Handler.Abstract, Handler.AbstractContainer, Handler.Collection, Handler.Container, Handler.Sequence, Handler.Singleton, Handler.Wrapper

Nested classes/interfaces inherited from interface Invocable

Invocable.Callable, Invocable.InvocationType, Invocable.ReadyTask, Invocable.Task

Nested classes/interfaces inherited from interface LifeCycle

LifeCycle.Listener

Nested classes/interfaces inherited from interface Request.Handler

Request.Handler.AbortException

Field Summary

Fields inherited from interface Invocable

__nonBlocking, NOOP

Method Summary

Modifier and Type	Method	Description
default void	addHandler(Supplier<Handler> supplier)	Adds the Handler supplied by the given Supplier to this collection of Handlers.
default void	addHandler(Handler handler)	Adds the given Handler to this collection of Handlers.
default boolean	removeHandler(Handler handler)	Removes the given Handler from this collection of Handlers.
default boolean	replaceHandler(Handler oldHandler, Handler newHandler)	Replace the given Handler to this collection of Handlers.
void	setHandlers(List<Handler> handlers)	Sets the given Handlers as children of this collection of Handlers.
default void	setHandlers(Handler... handlers)	Similar to setHandlers(List).

Methods inherited from interface Destroyable

destroy

Methods inherited from interface Handler

getServer, setServer

Methods inherited from interface Handler.Container

getContainer, getDescendant, getDescendants, getDescendants, getHandlers

Methods inherited from interface LifeCycle

addEventListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeEventListener, start, stop

Methods inherited from interface Request.Handler

getInvocationType, handle

Method Details

addHandler

default void addHandler(Handler handler)

Adds the given Handler to this collection of Handlers.

Parameters:

handler - the Handler to add

replaceHandler

default boolean replaceHandler(Handler oldHandler,
 Handler newHandler)

Replace the given Handler to this collection of Handlers.

Parameters:

oldHandler - the Handler to replace

newHandler - the Handler to add

Returns:

true iff the oldHandler is replaced with the newHandler.

removeHandler

default boolean removeHandler(Handler handler)

Removes the given Handler from this collection of Handlers.

Parameters:

handler - the Handler to remove

Returns:

whether the Handler was removed

addHandler

default void addHandler(Supplier<Handler> supplier)

Adds the Handler supplied by the given Supplier to this collection of Handlers.

Parameters:

supplier - the Handler supplier

setHandlers

void setHandlers(List<Handler> handlers)

Sets the given Handlers as children of this collection of Handlers.

The list is copied and any subsequent modification to the list does not have any effect on this Handler.

Any existing children Handler is removed.

Parameters:

handlers - the Handler to set as children

setHandlers

default void setHandlers(Handler... handlers)

Similar to setHandlers(List).

Parameters:

handlers - the Handler to set as children