org.glassfish.grizzly.samples.http.download

Class ClientDownloadFilter

java.lang.Object

org.glassfish.grizzly.filterchain.BaseFilter

org.glassfish.grizzly.samples.http.download.ClientDownloadFilter

All Implemented Interfaces:

Filter

public class ClientDownloadFilter
extends BaseFilter

HTTP client download filter. This Filter is responsible for asynchronous downloading of a HTTP resource and saving its content in a local file.

Author:

Alexey Stashok

Constructor Summary

Constructors

Constructor and Description
ClientDownloadFilter(URI uri, FutureImpl<String> completeFuture) ClientDownloadFilter constructor

Method Summary

Modifier and Type	Method and Description
NextAction	handleClose(FilterChainContext ctx) The method is called, when the client connection will get closed.
NextAction	handleConnect(FilterChainContext ctx) The method is called, when a client connection gets connected to a web server.
NextAction	handleRead(FilterChainContext ctx) The method is called, when we receive a HttpContent from a server.

Methods inherited from class org.glassfish.grizzly.filterchain.BaseFilter

createContext, exceptionOccurred, handleAccept, handleEvent, handleWrite, onAdded, onFilterChainChanged, onRemoved, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientDownloadFilter

public ClientDownloadFilter(URI uri,
                            FutureImpl<String> completeFuture)

ClientDownloadFilter constructor

Parameters:

uri - URI of a remote resource to download

completeFuture - download completion handler (FutureImpl)

Method Detail

handleConnect

public NextAction handleConnect(FilterChainContext ctx)
                         throws IOException

The method is called, when a client connection gets connected to a web server. When this method gets called by a framework - it means that client connection has been established and we can send HTTP request to the web server.

Specified by:

handleConnect in interface Filter

Overrides:

handleConnect in class BaseFilter

Parameters:

ctx - Client connect processing context

Returns:

NextAction

Throws:

IOException

handleRead

public NextAction handleRead(FilterChainContext ctx)
                      throws IOException

The method is called, when we receive a HttpContent from a server. Once we receive one - we save the content chunk to a local file.

Specified by:

handleRead in interface Filter

Overrides:

handleRead in class BaseFilter

Parameters:

ctx - Request processing context

Returns:

NextAction

Throws:

IOException

handleClose

public NextAction handleClose(FilterChainContext ctx)
                       throws IOException

The method is called, when the client connection will get closed. Intercepting this method let's use release resources, like local FileChannel, if it wasn't released before.

Specified by:

handleClose in interface Filter

Overrides:

handleClose in class BaseFilter

Parameters:

ctx - Request processing context

Returns:

NextAction

Throws:

IOException