Class UrlFileNameParser

java.lang.Object

org.apache.commons.vfs2.provider.AbstractFileNameParser

org.apache.commons.vfs2.provider.url.UrlFileNameParser

All Implemented Interfaces:

FileNameParser

public class UrlFileNameParser
extends AbstractFileNameParser

Implementation for any java.net.url based file system.

Composite of URLFilenameParser and GenericFilenameParser

Constructor Summary

Constructors

Constructor	Description
UrlFileNameParser()	Constructs a new instance.

Method Summary

Modifier and Type	Method	Description
protected int	countSlashes(String fileName)	This method counts the slashes after the scheme.
boolean	encodeCharacter(char ch)	Check if a character needs encoding (%nn).
protected boolean	isUrlBased(FileName base, String fileName)	Guess if the given file name is a URL with host or not.
FileName	parseUri(VfsComponentContext context, FileName base, String uri)	Parse a URI.

Methods inherited from class java.lang.Object

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

Constructor Details

UrlFileNameParser

public UrlFileNameParser()

Constructs a new instance.

Method Details

countSlashes

protected int countSlashes(String fileName)

This method counts the slashes after the scheme.

Parameters:

fileName - The file name.

Returns:

number of slashes

encodeCharacter

public boolean encodeCharacter(char ch)

Description copied from interface: FileNameParser

Check if a character needs encoding (%nn).

Specified by:

encodeCharacter in interface FileNameParser

Overrides:

encodeCharacter in class AbstractFileNameParser

Parameters:

ch - the character

Returns:

true if character should be encoded

isUrlBased

protected boolean isUrlBased(FileName base,
 String fileName)

Guess if the given file name is a URL with host or not.

VFS treats such URLs differently.

A file name is URL-based if the base is a URLFileName or there are only 2 slashes after the scheme. e.g: http://host/path, file:/path/to/file, file:///path/to/file.

Parameters:

base - The file name is relative to this base.

fileName - The file name.

Returns:

true if file name contains two slashes or base was URLFileName.

parseUri

public FileName parseUri(VfsComponentContext context,
 FileName base,
 String uri)
                  throws FileSystemException

Parse a URI.

Parameters:

context - The component context.

base - The base FileName.

uri - The target file name.

Returns:

The FileName.

Throws:

FileSystemException - if an error occurs