net.sf.mmm.util.resource.base

Class AbstractDataResourceFactory.DataResourceAdapter

java.lang.Object

net.sf.mmm.util.resource.base.AbstractDataResourceProxy

net.sf.mmm.util.resource.base.AbstractDataResourceFactory.DataResourceAdapter

All Implemented Interfaces:

DataResource

Enclosing class:

AbstractDataResourceFactory

protected class AbstractDataResourceFactory.DataResourceAdapter
extends AbstractDataResourceProxy

This is an implementation of the DataResource interface, that adapts another DataResource and enhances the navigate(String)-method to support switching schemes via the DataResourceFactory that created this DataResource.

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields

Modifier and Type	Field and Description
private DataResource	delegate

Constructor Summary

Constructors

Constructor and Description
DataResourceAdapter(DataResource delegate) The constructor.

Method Summary

Modifier and Type	Method and Description
protected DataResource	getDelegate() This method gets the DataResource this proxy delegates to.
DataResource	navigate(String relativePath) This method retrieves a DataResource pointing to the given resourcePath based on this resource. E.g.

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

getLastModificationDate, getName, getPath, getSize, getUri, getUrl, isAvailable, isData, isModifiedSince, openOutputStream, openStream, toString

Methods inherited from class java.lang.Object

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

Field Detail

delegate

private final DataResource delegate

Constructor Detail

DataResourceAdapter

public DataResourceAdapter(DataResource delegate)

The constructor.

Parameters:

delegate - is the DataResource to adapt.

Method Detail

getDelegate

protected DataResource getDelegate()

Description copied from class: AbstractDataResourceProxy

This method gets the DataResource this proxy delegates to.

Specified by:

getDelegate in class AbstractDataResourceProxy

Returns:

the delegate.

navigate

public DataResource navigate(String relativePath)
                      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 AbstractDataResourceProxy

Parameters:

relativePath - 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)