Class URLResource
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.types.DataType
org.apache.tools.ant.types.Resource
org.apache.tools.ant.types.resources.URLResource
- All Implemented Interfaces:
- Cloneable,- Comparable<Resource>,- Iterable<Resource>,- ResourceCollection,- URLProvider
Exposes a URL as a Resource.
- Since:
- Ant 1.7
- 
Field SummaryFields inherited from class org.apache.tools.ant.types.ResourceMAGIC, UNKNOWN_DATETIME, UNKNOWN_SIZEFields inherited from class org.apache.tools.ant.ProjectComponentdescription, location, project
- 
Constructor SummaryConstructorsConstructorDescriptionDefault constructor.URLResource(File f) Convenience constructor.String constructor for Ant attribute introspection.URLResource(URL u) Convenience constructor.Convenience constructor.
- 
Method SummaryModifier and TypeMethodDescriptionprotected voidconnect()Ensure that we have a connection.protected voidconnect(int logLevel) Ensure that we have a connection.booleanTest whether an Object equals this URLResource.Get an InputStream for the Resource.longTells the modification time in milliseconds since 01.01.1970 .getName()Get the name of this URLResource (its file component minus the leading separator).Get an OutputStream for the Resource.protected URLResourcegetRef()Perform the check for circular references and return the referenced Resource.longgetSize()Get the size of this Resource.getURL()Get the URL used by this URLResource.inthashCode()Get the hash code for this Resource.booleanTells if the resource is a directory.booleanisExists()Find out whether the URL exists .voidsetBaseURL(URL base) Base URL which combined with the relativePath attribute defines the URL.voidSet the URL from a File.voidOverrides the super version.voidRelative path which combined with the baseURL attribute defines the URL.voidSet the URL for this URLResource.toString()Return this URLResource formatted as a String.Methods inherited from class org.apache.tools.ant.types.Resourceas, asOptional, clone, compareTo, getMagicNumber, isFilesystemOnly, iterator, setDirectory, setExists, setLastModified, setName, setSize, size, toLongStringMethods inherited from class org.apache.tools.ant.types.DataTypecheckAttributesAllowed, checkChildrenAllowed, circularReference, dieOnCircularReference, dieOnCircularReference, dieOnCircularReference, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getDataTypeName, getRefid, invokeCircularReferenceCheck, isChecked, isReference, noChildrenAllowed, pushAndInvokeCircularReferenceCheck, setChecked, tooManyAttributesMethods inherited from class org.apache.tools.ant.ProjectComponentgetDescription, getLocation, getProject, log, log, setDescription, setLocation, setProjectMethods inherited from class java.lang.Objectfinalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface java.lang.IterableforEach, spliteratorMethods inherited from interface org.apache.tools.ant.types.ResourceCollectionisEmpty, stream
- 
Constructor Details- 
URLResourcepublic URLResource()Default constructor.
- 
URLResourceConvenience constructor.- Parameters:
- u- the URL to expose.
 
- 
URLResourceConvenience constructor.- Parameters:
- u- holds the URL to expose.
 
- 
URLResourceConvenience constructor.- Parameters:
- f- the File to set as a URL.
 
- 
URLResourceString constructor for Ant attribute introspection.- Parameters:
- u- String representation of this URL.
- See Also:
 
 
- 
- 
Method Details- 
setURLSet the URL for this URLResource.- Parameters:
- u- the URL to expose.
 
- 
setFileSet the URL from a File.- Parameters:
- f- the File to set as a URL.
 
- 
setBaseURLBase URL which combined with the relativePath attribute defines the URL.- Parameters:
- base- URL
- Since:
- Ant 1.8.0
 
- 
setRelativePathRelative path which combined with the baseURL attribute defines the URL.- Parameters:
- r- String
- Since:
- Ant 1.8.0
 
- 
getURLGet the URL used by this URLResource.- Specified by:
- getURLin interface- URLProvider
- Returns:
- a URL object.
 
- 
setRefidOverrides the super version.
- 
getNameGet the name of this URLResource (its file component minus the leading separator).
- 
toStringReturn this URLResource formatted as a String.
- 
isExistspublic boolean isExists()Find out whether the URL exists .
- 
getLastModifiedpublic long getLastModified()Tells the modification time in milliseconds since 01.01.1970 .- Overrides:
- getLastModifiedin class- Resource
- Returns:
- 0 if the resource does not exist to mirror the behavior
 of File.
 
- 
isDirectorypublic boolean isDirectory()Tells if the resource is a directory.- Overrides:
- isDirectoryin class- Resource
- Returns:
- boolean whether the resource is a directory.
 
- 
getSizepublic long getSize()Get the size of this Resource.
- 
equalsTest whether an Object equals this URLResource.
- 
hashCodepublic int hashCode()Get the hash code for this Resource.
- 
getInputStreamGet an InputStream for the Resource.- Overrides:
- getInputStreamin class- Resource
- Returns:
- an InputStream containing this Resource's content.
- Throws:
- IOException- if unable to provide the content of this Resource as a stream.
- UnsupportedOperationException- if InputStreams are not supported for this Resource type.
 
- 
getOutputStreamGet an OutputStream for the Resource.- Overrides:
- getOutputStreamin class- Resource
- Returns:
- an OutputStream to which content can be written.
- Throws:
- IOException- if unable to provide the content of this Resource as a stream.
- UnsupportedOperationException- if OutputStreams are not supported for this Resource type.
- IOException- if the URL cannot be opened.
 
- 
connectEnsure that we have a connection.- Throws:
- IOException- if the connection cannot be established.
 
- 
connectEnsure that we have a connection.- Parameters:
- logLevel- severity to use when logging connection errors. Should be one of the- MSG_constants in- Project.
- Throws:
- IOException- if the connection cannot be established.
- Since:
- Ant 1.8.2
 
- 
getRefDescription copied from class:ResourcePerform the check for circular references and return the referenced Resource.
 
-