Interface PlexusResource
-
- All Known Implementing Classes:
FilePlexusResource
,URLPlexusResource
public interface PlexusResource
A resource is a byte stream, possibly (but not necessarily) with additional attributes likeFile
,URL
, orURI
.- Since:
- 1.0-alpha-5
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.io.File
getFile()
Returns the resource as a file, if possible.java.io.InputStream
getInputStream()
Returns the resource as anInputStream
.java.lang.String
getName()
Returns the resources name, if possible.java.net.URI
getURI()
Returns the resources URI, if possible.java.net.URL
getURL()
Returns the resources URL, if possible.
-
-
-
Method Detail
-
getInputStream
java.io.InputStream getInputStream() throws java.io.IOException
Returns the resource as an
InputStream
. In general, you should not assume, that this method may me called more than once. In typical cases (for example, if the Resource is backed by a file or loaded through the classpath), one may create anInputStream
as often as is necessary. However, you should think of cases like an URL pointing to a servlet, where the resource contents change with every call.If you need a reliable way of reloading the resource more than once, then you should use
ResourceManager.getResourceAsFile(PlexusResource)
.- Returns:
- An
InputStream
with the resources contents, never null. - Throws:
java.io.IOException
-
getFile
java.io.File getFile() throws java.io.IOException
Returns the resource as a file, if possible. A resource doesn't need to be available as a file: If you require a file, use
ResourceManager.getResourceAsFile(PlexusResource)
.- Returns:
- A
File
containing the resources contents, if available, or null. - Throws:
java.io.IOException
-
getURL
java.net.URL getURL() throws java.io.IOException
Returns the resources URL, if possible. A resource doesn't need to have an URL.
- Returns:
- The resources URL, if available, or null.
- Throws:
java.io.IOException
-
getURI
java.net.URI getURI() throws java.io.IOException
Returns the resources URI, if possible. A resource doesn't need to have an URI.
- Returns:
- The resources URI, if available, or null.
- Throws:
java.io.IOException
-
getName
java.lang.String getName()
Returns the resources name, if possible. A resources name is a relatively unspecified thing. For example, if the resource has anURL
, the name might be created by invokingURL.toExternalForm()
. In the case of aFile
, it might beFile.getPath()
.
-
-