Package org.apache.tapestry5.internal.services

Class UrlResource

java.lang.Object

org.apache.tapestry5.internal.util.VirtualResource

org.apache.tapestry5.internal.services.UrlResource

All Implemented Interfaces:

Resource

public class UrlResource
extends VirtualResource

Field Summary

Fields

Modifier and Type	Field	Description
static java.net.URL	PLACEHOLDER_URL

Fields inherited from class org.apache.tapestry5.internal.util.VirtualResource

UTF8

Constructor Summary

Constructors

Constructor	Description
UrlResource()
UrlResource(java.net.URL url)

Method Summary

Modifier and Type	Method	Description
boolean	exists()	Returns true if the resource exists; if a stream to the content of the file may be opened.
Resource	forLocale(java.util.Locale locale)	Returns a localized version of the resource.
java.io.InputStream	openStream()	Opens a stream to the content of the resource, or returns null if the resource does not exist.
java.lang.String	toString()
java.net.URL	toURL()	Returns the URL for the resource, or null if it does not exist.

Methods inherited from class org.apache.tapestry5.internal.util.VirtualResource

forFile, getFile, getFolder, getPath, isVirtual, toInputStream, toInputStream, withExtension

Methods inherited from class java.lang.Object

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

Field Detail

PLACEHOLDER_URL

public static final java.net.URL PLACEHOLDER_URL

Constructor Detail

UrlResource

public UrlResource()

UrlResource

public UrlResource(java.net.URL url)

Method Detail

openStream

public java.io.InputStream openStream()
                               throws java.io.IOException

Description copied from interface: Resource

Opens a stream to the content of the resource, or returns null if the resource does not exist. The native input stream supplied by the resource is wrapped in a BufferedInputStream.

Returns:

an open, buffered stream to the content, if available

Throws:

java.io.IOException

toURL

public java.net.URL toURL()

Description copied from interface: Resource

Returns the URL for the resource, or null if it does not exist. This value is lazily computed; starting in 5.3.4, subclasses may cache the result. Starting in 5.4, some "virtual resources" may return null.

Specified by:

toURL in interface Resource

Overrides:

toURL in class VirtualResource

exists

public boolean exists()

Description copied from interface: Resource

Returns true if the resource exists; if a stream to the content of the file may be opened. A resource exists if Resource.toURL() returns a non-null value. Starting in release 5.3.4, the result of this is cached. Starting in 5.4, some "virtual resources", may return true even though Resource.toURL() returns null.

Specified by:

exists in interface Resource

Overrides:

exists in class VirtualResource

Returns:

true if the resource exists, false if it does not

forLocale

public Resource forLocale(java.util.Locale locale)

Description copied from interface: Resource

Returns a localized version of the resource. May return null if no such resource exists. Starting in release 5.3.4, the result of this method is cached internally.

Specified by:

forLocale in interface Resource

Overrides:

forLocale in class VirtualResource

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object