Middleware (libnetty-http-server 2.2.9 API)

All Superinterfaces:

java.util.function.BiFunction<HttpRequestContext,MiddlewareChain,java.util.concurrent.CompletionStage<HttpResult>>

All Known Implementing Classes:

AccessLogger, AuthBasic, PathFilterMiddleware, RequestValidator, Router, ServeStatic, SupportJson

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
```
@FunctionalInterface
public interface Middleware
extends java.util.function.BiFunction<HttpRequestContext,MiddlewareChain,java.util.concurrent.CompletionStage<HttpResult>>
```
An interface defines functions which will be applied in HTTP request-response cycle.

Since:

1.1

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method	Description
`java.util.concurrent.CompletionStage<HttpResult>`	`apply(HttpRequestContext ctx, MiddlewareChain next)`	Apply this `Middleware` to the given `HttpRequestContext`.
`default void`	`close()`	Closes this `Middleware` and releases any system resources associated with it.
`default void`	`onServerClosed()`	This method will be invoked by framework when the `HttpServer` which this `Middleware` belongs to is just be closed.

Methods inherited from interface java.util.function.BiFunction
andThen

- Method Detail
  - apply
```
java.util.concurrent.CompletionStage<HttpResult> apply(HttpRequestContext ctx,
                                                       MiddlewareChain next)
```
    Apply this Middleware to the given HttpRequestContext.
    
    Specified by:
    
    apply in interface java.util.function.BiFunction<HttpRequestContext,MiddlewareChain,java.util.concurrent.CompletionStage<HttpResult>>
    
    Parameters:
    
    ctx - the HttpRequestContext object of the current HTTP request
    
    next - the MiddlewareChain for invoking the next Middleware
    
    Returns:
    
    a CompletionStage<HttpResult>
  - onServerClosed
```
default void onServerClosed()
                     throws java.lang.Exception
```
    This method will be invoked by framework when the HttpServer which this Middleware belongs to is just be closed.
    This method is equivalent to close().
    
    Throws:
    
    java.lang.Exception - if any error occurs
  - close
```
default void close()
            throws java.lang.Exception
```
    Closes this Middleware and releases any system resources associated with it.
    Default do nothing.
    
    Throws:
    
    java.lang.Exception - if any error occurs