info.magnolia.resourceloader

Class ResourceStub

java.lang.Object

info.magnolia.resourceloader.ResourceStub

All Implemented Interfaces:

Resource

Deprecated.

since 5.4.6 - new ResourceOrigin.registerResourceChangeHandler(ResourceChangeHandler) allows for registering more sophisticated resource change handlers rendering this class obsolete.

@Deprecated
public class ResourceStub
extends Object
implements Resource

Resource placeholder. Typical purpose of an instance of this class is e.g. to represent a resource which does not already exist (e.g. after deletion) letting ResourceVisitors to handle such a case accordingly.

NOTE: this class doesn't not support any Resource operation and will throw an UnsupportedOperationException on any attempt to use its API except for Resource.getPath().

Method Summary

Modifier and Type	Method and Description
long	getLastModified() Deprecated. Returns the last modification date of this resource as the number of milliseconds since January 1, 1970, 00:00:00 GMT.
String	getName() Deprecated.
ResourceOrigin	getOrigin() Deprecated.
Resource	getParent() Deprecated.
String	getPath() Deprecated. Returns the "absolute" path to this resource.
boolean	isDirectory() Deprecated.
boolean	isEditable() Deprecated. Determines whether this resource can be edited in its underlying origin.
boolean	isFile() Deprecated.
List<Resource>	listChildren() Deprecated.
Reader	openReader() Deprecated. Opens a Reader for this resource; if the associated ResourceOrigin can guess it, this will have been opened with the corrected encoding.
InputStream	openStream() Deprecated. Opens an InputStream for this resource.
static ResourceStub	withPath(String path) Deprecated.

Methods inherited from class java.lang.Object

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

Methods inherited from interface info.magnolia.resourceloader.Resource

findResource, findResource, findResources, streamChildren

Method Detail

withPath

public static ResourceStub withPath(String path)

Deprecated.

getPath

public String getPath()

Deprecated.

Description copied from interface: Resource

Returns the "absolute" path to this resource. Depending on the implementation, it might in effect be relative to some other root path, but the user of this package should consider them absolute.

Specified by:

getPath in interface Resource

getOrigin

public ResourceOrigin getOrigin()

Deprecated.

Specified by:

getOrigin in interface Resource

isFile

public boolean isFile()

Deprecated.

Specified by:

isFile in interface Resource

isDirectory

public boolean isDirectory()

Deprecated.

Specified by:

isDirectory in interface Resource

isEditable

public boolean isEditable()

Deprecated.

Description copied from interface: Resource

Determines whether this resource can be edited in its underlying origin.

Specified by:

isEditable in interface Resource

getName

public String getName()

Deprecated.

Specified by:

getName in interface Resource

getLastModified

public long getLastModified()

Deprecated.

Description copied from interface: Resource

Returns the last modification date of this resource as the number of milliseconds since January 1, 1970, 00:00:00 GMT.

Specified by:

getLastModified in interface Resource

See Also:

Date.getTime()

getParent

public Resource getParent()

Deprecated.

Specified by:

getParent in interface Resource

listChildren

public List<Resource> listChildren()

Deprecated.

Specified by:

listChildren in interface Resource

openStream

public InputStream openStream()
                       throws IOException

Deprecated.

Description copied from interface: Resource

Opens an InputStream for this resource. Client code is expected to close the stream.

Specified by:

openStream in interface Resource

Throws:

IOException

See Also:

Resource.openReader()

openReader

public Reader openReader()
                  throws IOException

Deprecated.

Description copied from interface: Resource

Opens a Reader for this resource; if the associated ResourceOrigin can guess it, this will have been opened with the corrected encoding. Client code is expected to close the reader.

Specified by:

openReader in interface Resource

Throws:

IOException

See Also:

Resource.openStream()