Class Filter.Chain

java.lang.Object

com.sun.net.httpserver.Filter.Chain

Enclosing class:: Filter

public static class Filter.Chain extends Object

A chain of filters associated with a HttpServer. Each filter in the chain is given one of these so it can invoke the next filter in the chain.

Since:: 1.6

Constructor Summary

Constructor	Description
`Chain(List<Filter> filters, HttpHandler handler)`	Creates a `Chain` instance with given filters and handler.

Method Summary

Modifier and Type	Method	Description
`void`	`doFilter(HttpExchange exchange)`	Calls the next filter in the chain, or else the users exchange handler, if this is the final filter in the chain.

Methods declared in class Object

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

Constructor Details

Chain

public Chain(List<Filter> filters, HttpHandler handler)

Creates a Chain instance with given filters and handler.

Parameters:: filters - the filters that make up the Chain; handler - the HttpHandler that will be invoked after the final Filter has finished

Method Details

doFilter

public void doFilter(HttpExchange exchange) throws IOException

Calls the next filter in the chain, or else the users exchange handler, if this is the final filter in the chain. The Filter may decide to terminate the chain, by not calling this method. In this case, the filter must send the response to the request, because the application's exchange handler will not be invoked.

Parameters:: exchange - the HttpExchange
Throws:: IOException - if an I/O error occurs; NullPointerException - if exchange is null

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.httpserver/com/sun/net/httpserver/Filter.Chain.html