org.jboss.forge.addon.resource

Interface Resource<T>

All Superinterfaces:

Faceted<ResourceFacet>

All Known Subinterfaces:

DirectoryResource, EnumConstantResource, FileResource<T>, GitIgnoreResource, JavaFieldResource, JavaMethodResource, JavaResource, JsonResource, MavenDependencyResource, MavenModelResource, MavenProfileResource, MavenRepositoryResource, URLResource, WriteableResource<T,R>, XMLResource

All Known Implementing Classes:

AbstractFileResource, AbstractResource, VirtualResource

public interface Resource<T>
extends Faceted<ResourceFacet>

A Resource is an abstraction on top of usable items within a Furnace project. For instance, files, source code, etc. Like a simplified virtual file system, a Resource is represented hierarchically with a parent and children. This allows Addon instances to, for example, directly access to project elements within a consistent API from files to class members.

However, resource instances should be treated as representative query result objects. A modification to an instance variable in a resource will not be persisted. Rather than thinking of the resource object as meta-data (which it is not), it is better conceptualized as a wrapper or "view" of an underlying resource such as a File. For this reason, custom resource types should never implement any sort of static cache and should preferably lazily initialize their data.

Author:

Mike Brock, Lincoln Baxter, III, Ken Finnigan

Method Summary

Methods

Modifier and Type	Method and Description
Resource<T>	createFrom(T file) Create a new resource instance for the target resource reference of the type that this current resource is.
boolean	delete() Delete this Resource, return true if successful, false if not.
boolean	delete(boolean recursive) Delete this resource, return true if successful, false if not.
boolean	exists() Return true if this Resource exists, return false if not.
Resource<?>	getChild(String name) Get a child of this resource.
String	getContents() Get the entire contents of this Resource, returned as a String using UTF-8 encoding.
String	getContents(Charset charset) Get the entire contents of this Resource, returned as a String using the specified encoding.
String	getFullyQualifiedName() Return the fully qualified name of the resource (if applicable).
String	getName() Return the common name of the Resource.
Resource<?>	getParent() Get the parent of the current resource.
ResourceFactory	getResourceFactory() Return the ResourceFactory with which this Resource was created.
InputStream	getResourceInputStream() Get the InputStream represented by this Resource.
T	getUnderlyingResourceObject() Get the underlying object represented by this Resource.
List<Resource<?>>	listResources() Return a list of child resources of the current resource.
List<Resource<?>>	listResources(ResourceFilter filter) Return a list of child resources of the current resource matching the given ResourceFilter.
<R extends Resource<?>> R	reify(Class<R> type) Ask this Resource if it is actually a resource of the given type; if it is, return a new reference to the resource as the given type, otherwise return null.
List<Resource<?>>	resolveChildren(String path) Resolve children resources from this Resource given a specific path.

Methods inherited from interface org.jboss.forge.addon.facets.Faceted

getFacet, getFacets, getFacets, hasAllFacets, hasAllFacets, hasFacet, supports

Method Detail

delete

boolean delete()
               throws UnsupportedOperationException

Delete this Resource, return true if successful, false if not.

Throws:

UnsupportedOperationException - if deleting is not supported by the underlying implementation.

delete

boolean delete(boolean recursive)
               throws UnsupportedOperationException

Delete this resource, return true if successful, false if not.

Parameters:

recursive - if false and this resource both supports recursive deletion and contains children, deletion will not occur; otherwise, if true, deletion will propagate to all child resources. Implementations may choose simply to delegate to delete()

Throws:

UnsupportedOperationException - if deleting is not supported by the underlying implementation.

getName

String getName()

Return the common name of the Resource. If it's a file, for instance, just the file name.

Returns:

The name of the Resource.

getFullyQualifiedName

String getFullyQualifiedName()

Return the fully qualified name of the resource (if applicable). In the case of a File resource, this would normally be the full path name.

Returns:

The fully qualified name.

getParent

Resource<?> getParent()

Get the parent of the current resource. Returns null if the current resource is the filesystem root.

Returns:

An instance of the Resource parent.

createFrom

Resource<T> createFrom(T file)

Create a new resource instance for the target resource reference of the type that this current resource is.

Parameters:

file - The target reference to create the resource instance from.

Returns:

A new Resource instance.

listResources

List<Resource<?>> listResources()

Return a list of child resources of the current resource. (Never null.)

listResources

List<Resource<?>> listResources(ResourceFilter filter)

Return a list of child resources of the current resource matching the given ResourceFilter.

getUnderlyingResourceObject

T getUnderlyingResourceObject()

Get the underlying object represented by this Resource.

getResourceInputStream

InputStream getResourceInputStream()

Get the InputStream represented by this Resource.

getContents

String getContents()

Get the entire contents of this Resource, returned as a String using UTF-8 encoding.

getContents

String getContents(Charset charset)

Get the entire contents of this Resource, returned as a String using the specified encoding.

getChild

Resource<?> getChild(String name)

Get a child of this resource. Returns null if no child by the given name can be found.

exists

boolean exists()

Return true if this Resource exists, return false if not.

reify

<R extends Resource<?>> R reify(Class<R> type)

Ask this Resource if it is actually a resource of the given type; if it is, return a new reference to the resource as the given type, otherwise return null.

getResourceFactory

ResourceFactory getResourceFactory()

Return the ResourceFactory with which this Resource was created. If no factory was used, return null.

resolveChildren

List<Resource<?>> resolveChildren(String path)

Resolve children resources from this Resource given a specific path.

See Also:

ResourcePathResolver, ResourcePathResolver.resolve()