net.sf.mmm.util.resource.impl

Class ClasspathFolder

java.lang.Object

net.sf.mmm.util.resource.base.AbstractDataResource

net.sf.mmm.util.resource.base.AbstractBrowsableResource

net.sf.mmm.util.resource.impl.AbstractBrowsableClasspathResource

net.sf.mmm.util.resource.impl.ClasspathFolder

All Implemented Interfaces:

BrowsableResource, DataResource, ResourcePath

class ClasspathFolder
extends AbstractBrowsableClasspathResource

A folder (package) of the classpath.

Since:

7.3.0 (moved from 7.0.0)

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields

Modifier and Type	Field and Description
(package private) List<AbstractBrowsableClasspathResource>	children

Fields inherited from class net.sf.mmm.util.resource.impl.AbstractBrowsableClasspathResource

name

Fields inherited from interface net.sf.mmm.util.resource.api.ResourcePath

HOME_PATH_CHAR, PATH_SEGMENT_CURRENT_DIRECTORY, PATH_SEGMENT_PARENT_DIRECTORY, PATH_SEGMENT_SEPARATOR, PATH_SEGMENT_SEPARATOR_CHAR, UNC_PATH_PREFIX, URL_SCHEME_AUTHORITY_SEPARATOR

Constructor Summary

Constructors

Constructor and Description
ClasspathFolder(ClasspathFolder parent, String name) The constructor.

Method Summary

Modifier and Type	Method and Description
BrowsableResource	cd(String path) Changes the directory from this BrowsableResource to the given path.
(package private) AbstractBrowsableClasspathResource	getChildResource(String childName)
Iterable<? extends AbstractBrowsableClasspathResource>	getChildResources() This method iterates the immediate child-resources contained in this BrowsableResource.
(package private) ClasspathFolder	getOrCreateChildFolder(String childName)
URL	getUrl() This method gets this resource as URL.
protected void	init() Initializes this resource after it has been properly completed.
boolean	isData() This method determines if this resource has potentially data available.
boolean	isFolder() This method determines if this BrowsableResource is a folder that potentially contains other resources.
(package private) AbstractBrowsableClasspathResource	navigate(ResourcePathNode<Void> path, boolean create)
DataResource	navigate(String resourcePath) This method retrieves a DataResource pointing to the given resourcePath based on this resource. E.g.
(package private) DataResource	navigate(String resourcePath, boolean returnNullIfNotExists)

Methods inherited from class net.sf.mmm.util.resource.impl.AbstractBrowsableClasspathResource

getLastModificationDate, getName, getParent, getPath, getPath, getQualifiedName, getRoot, getSchemePrefix, getUri, isAbsolute, isRoot

Methods inherited from class net.sf.mmm.util.resource.base.AbstractBrowsableResource

getChildResources

Methods inherited from class net.sf.mmm.util.resource.base.AbstractDataResource

equals, getSize, hashCode, isAvailable, isModifiedSince, openOutputStream, openStream, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.sf.mmm.util.resource.api.DataResource

getSize, isAvailable, isModifiedSince, openOutputStream, openStream

Field Detail

children

List<AbstractBrowsableClasspathResource> children

Constructor Detail

ClasspathFolder

ClasspathFolder(ClasspathFolder parent,
                String name)

The constructor.

Parameters:

parent - - see AbstractBrowsableClasspathResource.getParent().

name - - see AbstractBrowsableClasspathResource.getName().

Method Detail

init

protected void init()

Initializes this resource after it has been properly completed.

Overrides:

init in class AbstractBrowsableClasspathResource

getChildResource

AbstractBrowsableClasspathResource getChildResource(String childName)

Parameters:

childName - is the name of the requested child resource.

Returns:

the existing child folder or a new one created and added otherwise.

getOrCreateChildFolder

ClasspathFolder getOrCreateChildFolder(String childName)

Parameters:

childName - is the name of the requested child resource.

Returns:

the existing child folder or a new one created and added otherwise.

getChildResources

public Iterable<? extends AbstractBrowsableClasspathResource> getChildResources()

Description copied from interface: BrowsableResource

This method iterates the immediate child-resources contained in this BrowsableResource.
If this is no folder, this method will always return an empty Iterable.

Specified by:

getChildResources in interface BrowsableResource

Specified by:

getChildResources in class AbstractBrowsableClasspathResource

Returns:

an Iterable of the child-resources.

isFolder

public boolean isFolder()

Description copied from interface: BrowsableResource

This method determines if this BrowsableResource is a folder that potentially contains other resources. Otherwise if this is no folder, BrowsableResource.getChildResources() will be empty (return an empty Iterable). However BrowsableResource.getChildResources() can also be empty, if this is a folder.
In order to determine if this BrowsableResource is containing data, please use DataResource.isAvailable(). Please note that BrowsableResource.isFolder() and DataResource.isAvailable() can both return true or both return false.

Returns:

true if this is a folder, false otherwise.

isData

public boolean isData()

Description copied from interface: DataResource

This method determines if this resource has potentially data available. Unlike DataResource.isAvailable() this method will not invoke expensive operations like connecting to remote URLs. If this method will return false, then DataResource.isAvailable() would also have returned false. However in case of true only DataResource.isAvailable() can guarantee if a resource really exists and contains data. E.g. if the resource points to a File then this method can check if it is a data-file. So in case it points to a directory or does not exist at all in the filesystem, this method will return false. Please also note that this may invoke expensive operations if the according directory path points to something like a network share. You should also be aware that the state of DataResource.isData() and DataResource.isAvailable() can change at any time so you never have a full guarantee if some data exists or NOT. However in most cases it is very improbable that this status changes when you read the resource immediately after the check.

Returns:

true if this resource points to potential data, false otherwise.

getUrl

public URL getUrl()
           throws ResourceNotAvailableException

Description copied from interface: DataResource

This method gets this resource as URL.

Returns:

the URL that represents this resource.

Throws:

ResourceNotAvailableException - if an URL can NOT be created because the represented resource does not exist.

navigate

AbstractBrowsableClasspathResource navigate(ResourcePathNode<Void> path,
                                            boolean create)

Parameters:

path - the ResourcePathNode.

create - - true if non existing ressources should be created as fake resources, false oterhwise.

Returns:

the AbstractBrowsableClasspathResource. May be null if the given path does not exist and create is false.

See Also:

navigate(String)

navigate

public DataResource navigate(String resourcePath)
                      throws ResourceUriUndefinedException

Description copied from interface: DataResource

This method retrieves a DataResource pointing to the given resourcePath based on this resource.
E.g. if this resource points to the file "/etc/init.d/rc" and resourcePath would be "../apt/sources.list" the resulting resource would point to "/etc/apt/sources.list".
ATTENTION:
As you can see by the example above this method always navigates relative to the parent folder of this resource. This will also be the case if this resource itself is a folder. Due to this generic API this is the only consistent way as there are implementations that can not easily know if they represent a folder or a file or maybe even both at the same time. However, please be aware of this and do not get confused as you might expect this to be a cd command if invoked on a folder what is not exactly not the case (instead it is a cd on the parent folder). On a BrowsableResource you can use BrowsableResource.cd(String) instead to avoid confusion.

Specified by:

navigate in interface DataResource

Overrides:

navigate in class AbstractBrowsableClasspathResource

Parameters:

resourcePath - the absolute or relative path pointing to a new resource. If it is a relative path, it is interpreted relative to the parent URI (directory) of this resource.

Returns:

the resource pointing to the given path (relative to this resource).

Throws:

ResourceUriUndefinedException - if the given resourcePath leads to an undefined or illegal URI.

See Also:

BrowsableResource.cd(String)

cd

public BrowsableResource cd(String path)

Description copied from interface: BrowsableResource

Changes the directory from this BrowsableResource to the given path.

Parameters:

path - the absolute or relative path pointing to a new resource. If it is a relative path, it is interpreted relative to the current URI (directory) if this is a folder and relative to the parent URI otherwise.

Returns:

the resource pointing to the given path (relative to this resource).

See Also:

DataResource.navigate(String)

navigate

DataResource navigate(String resourcePath,
                      boolean returnNullIfNotExists)

Parameters:

resourcePath - the path to navigate to.

returnNullIfNotExists - - if true then null is returned for non-existent resources, otherwise a ClasspathResource is created and returned.

Returns:

the requested DataResource.

See Also:

#navigate(ResourcePathNode)