freenet.clients.http

Class LocalFileBrowserToadlet

java.lang.Object

freenet.clients.http.Toadlet

freenet.clients.http.LocalFileBrowserToadlet

Direct Known Subclasses:

LocalDirectoryToadlet, LocalFileFilterToadlet, LocalFileInsertToadlet, LocalFileN2NMToadlet

public abstract class LocalFileBrowserToadlet
extends Toadlet

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	changeDir Part set when a directory is changed.
protected NodeClientCore	core
static java.lang.String	selectDir Part set when a directory is selected.
static java.lang.String	selectFile Part set when a file is selected.

Fields inherited from class freenet.clients.http.Toadlet

HANDLE_METHOD_PREFIX

Constructor Summary

Constructors

Constructor and Description
LocalFileBrowserToadlet(NodeClientCore core, HighLevelSimpleClient highLevelSimpleClient)

Method Summary

Modifier and Type	Method and Description
protected abstract boolean	allowedDir(java.io.File path) Whether the directory is allowed for the purposes of the specific browser.
protected void	createSelectDirectoryButton(HTMLNode node, java.lang.String absolutePath, HTMLNode persistence) Renders directory selection button with selectDir and filenameField() set.
protected void	createSelectFileButton(HTMLNode node, java.lang.String absolutePath, HTMLNode persistence) Renders file selection button with selectFile and filenameField() set.
protected java.lang.String	defaultDownloadDir() Determines the appropriate directory to start out in if browsing for something to download.
protected java.lang.String	defaultUploadDir() Determines the appropriate directory to start out in if browsing for something to upload.
protected java.lang.String	filenameField()
void	handleMethodGET(java.net.URI uri, HTTPRequest request, ToadletContext ctx) Handle a GET request.
void	handleMethodPOST(java.net.URI uri, HTTPRequest request, ToadletContext ctx)
abstract java.lang.String	path()
protected abstract java.util.Hashtable<java.lang.String,java.lang.String>	persistenceFields(java.util.Hashtable<java.lang.String,java.lang.String> set) Performs sanity checks and generates parameter persistence fields.
protected abstract java.lang.String	postTo()
protected abstract java.lang.String	startingDir() Determines the appropriate directory to start out in for the given browser.

Methods inherited from class freenet.clients.http.Toadlet

addHomepageLink, allowPOSTWithoutPassword, findSupportedMethods, getClientImpl, sendErrorPage, sendErrorPage, sendErrorPage, showAsToadlet, showAsToadlet, writeHTMLReply, writeHTMLReply, writeHTMLReply, writeInternalError, writeReply, writeReply, writeReply, writeReply, writeReply, writeReply, writeTemporaryRedirect, writeTextReply, writeTextReply

Methods inherited from class java.lang.Object

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

Field Detail

core

protected final NodeClientCore core

selectDir

public static final java.lang.String selectDir

Part set when a directory is selected.

See Also:

Constant Field Values

selectFile

public static final java.lang.String selectFile

Part set when a file is selected.

See Also:

Constant Field Values

changeDir

public static final java.lang.String changeDir

Part set when a directory is changed.

See Also:

Constant Field Values

Constructor Detail

LocalFileBrowserToadlet

public LocalFileBrowserToadlet(NodeClientCore core,
                               HighLevelSimpleClient highLevelSimpleClient)

Method Detail

path

public abstract java.lang.String path()

Specified by:

path in class Toadlet

postTo

protected abstract java.lang.String postTo()

filenameField

protected java.lang.String filenameField()

Returns:

Part which contains selected directory or file.

allowedDir

protected abstract boolean allowedDir(java.io.File path)

Whether the directory is allowed for the purposes of the specific browser. For example, do the node settings allow downloading to the given directory?

Parameters:

path - The path to check permissions for.

Returns:

Whether browsing that directory is allowed. If it is not, the LocalFileBrowserToadlet will not render a selection button or directory-changing button for it.

persistenceFields

protected abstract java.util.Hashtable<java.lang.String,java.lang.String> persistenceFields(java.util.Hashtable<java.lang.String,java.lang.String> set)

Performs sanity checks and generates parameter persistence fields.

Parameters:

set - page parts/parameters

Returns:

fieldPairs correct fields to persist for this browser type

startingDir

protected abstract java.lang.String startingDir()

Determines the appropriate directory to start out in for the given browser. If a path is not already specified, the browser will attempt to display this directory.

Returns:

path to directory

defaultUploadDir

protected java.lang.String defaultUploadDir()

Determines the appropriate directory to start out in if browsing for something to upload.

Returns:

If all directories or no directories are allowed, returns the user's home directory. Otherwise, returns the first allowed directory.

defaultDownloadDir

protected java.lang.String defaultDownloadDir()

Determines the appropriate directory to start out in if browsing for something to download.

Returns:

If all directories or no directories are allowed, the default downloads directory is returned. Otherwise, returns the first allowed directory.

createSelectDirectoryButton

protected void createSelectDirectoryButton(HTMLNode node,
                                           java.lang.String absolutePath,
                                           HTMLNode persistence)

Renders directory selection button with selectDir and filenameField() set.

Parameters:

node - Node to add the button to.

absolutePath - Path to set the filenameField() field to.

persistence - Additional persistence fields to include.

createSelectFileButton

protected void createSelectFileButton(HTMLNode node,
                                      java.lang.String absolutePath,
                                      HTMLNode persistence)

Renders file selection button with selectFile and filenameField() set.

Parameters:

node - Node to add the button to.

absolutePath - Path to set the filenameField() field to.

persistence - Additional persistence fields to include.

handleMethodGET

public void handleMethodGET(java.net.URI uri,
                            HTTPRequest request,
                            ToadletContext ctx)
                     throws ToadletContextClosedException,
                            java.io.IOException,
                            RedirectException

Description copied from class: Toadlet

Handle a GET request. Other methods are accessed via handleMethodPOST etc, invoked via reflection. But all toadlets are expected to support GET.

Specified by:

handleMethodGET in class Toadlet

Parameters:

uri - is unused,

request - contains parameters.

ctx - allows page rendering and permissions checks.

Throws:

ToadletContextClosedException - Access is denied: uploading might be disabled overall. The user might be denied access to this directory, which could be their home directory.

java.io.IOException - Something file-related went wrong.

RedirectException

See Also:

findSupportedMethods, "java.net.URI", "ToadletContext

handleMethodPOST

public void handleMethodPOST(java.net.URI uri,
                             HTTPRequest request,
                             ToadletContext ctx)
                      throws ToadletContextClosedException,
                             java.io.IOException,
                             RedirectException

Throws:

ToadletContextClosedException

java.io.IOException

RedirectException