Modifier and Type	Class and Description
private class	LoadableURLResource.WrappedInputStream InputStream , that helps managing the load count.

Field Summary

Modifier and Type	Field and Description
private final AtomicInteger	accessCount How many times this resource was accessed.
private final ResourceCache	cache The cache used.
private long	cacheTTLMillis The time to live (TTL) of cache entries in milliseconds, by default 24 h.
private volatile SoftReference<byte[]>	data The current data array.
private final URI	fallbackLocation The fallback location (classpath).
private long	lastLoaded THe timestamp of the last successful load.
private final AtomicInteger	loadCount How many times this resource was successfully loaded.
private final Object	lock Lock for this instance.
private static final Logger	LOG The logger used.
private final Map<String, String>	properties The resource configuration.
private final List<URI>	remoteResources The remote URLs to be looked up (first wins).
private final String	resourceId resource id.
private final LoaderService.UpdatePolicy	updatePolicy The required update policy for this resource.

Access	Constructor and Description
pack-priv	LoadableURLResource(ResourceCache cache, LoadDataInformation loadDataInformation)

Method Summary

Modifier and Type	Method and Description
protected void	clearCache() This method is called when the cached data should be removed, e.g. after an explicit fallback reload, or a clear operation.
public final int	Returns: the number of successful accesses. getAccessCount() Get the number of successful accesses.
public final byte[]	Returns: the data to load. getData() Get the resource data.
public InputStream	Returns: the input stream. getDataStream() Implements org.javamoney.moneta.spi.loader.DataStreamFactory.getDataStream. Get the resource data as input stream.
public final URI	Returns: the fallback location, or null. getFallbackResource() Return the fallback location.
public final long	Returns: the lastLoaded getLastLoaded() Get the timestamp of the last succesful load.
public final int	Returns: the number of successful loads. getLoadCount() Get the number of active loads of this resource (InputStream).
public Map<String, String>	Returns: the configuration properties of this resource, never null. getProperties() Get the configuration properties of this resource.
public final List<URI>	Returns: the remote locations, maybe empty. getRemoteResources() Get the remote locations.
public final String	Returns: the resourceId getResourceId() Get the resourceId.
public LoaderService.UpdatePolicy	Returns: the UpdatePolicy of this resource, never null. getUpdatePolicy() Get the UpdatePolicy of this resource.
public boolean	Returns: true, if load succeeded. load() Loads the resource, first from the remote resources, if that fails from the fallback location.
protected boolean	load(URI the target `URL` itemToLoad, boolean true, for a fallback URL. fallbackLoad) Tries to load the data from the given location.
public boolean	Returns: true, on success. loadFallback() Try to load the resource from the fallback resources.
public boolean	Returns: true, on success. loadRemote() Try to load the resource from the remote locations.
public boolean	Returns: true, if data could be read and applied from the cache sucdcessfully. readCache() This method is called when the data should be loaded from the cache.
public boolean	Returns: true on success. resetToFallback() Explicitly override the resource wih the fallback context and resets the load counter.
protected final void	setData(byte[] bytes)
private boolean	shouldReadDataFromFallback()
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
public void	unload()
protected void	writeCache() This method is called after data could be successfully loaded from a non fallback resource.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

accessCount	back to summary
private final AtomicInteger accessCount How many times this resource was accessed.

cache	back to summary
private final ResourceCache cache The cache used.

cacheTTLMillis	back to summary
private long cacheTTLMillis The time to live (TTL) of cache entries in milliseconds, by default 24 h.

data	back to summary
private volatile SoftReference<byte[]> data The current data array.

fallbackLocation	back to summary
private final URI fallbackLocation The fallback location (classpath).

lastLoaded	back to summary
private long lastLoaded THe timestamp of the last successful load.

loadCount	back to summary
private final AtomicInteger loadCount How many times this resource was successfully loaded.

lock	back to summary
private final Object lock Lock for this instance.

LOG	back to summary
private static final Logger LOG The logger used.

properties	back to summary
private final Map<String, String> properties The resource configuration.

remoteResources	back to summary
private final List<URI> remoteResources The remote URLs to be looked up (first wins).

resourceId	back to summary
private final String resourceId resource id.

updatePolicy	back to summary
private final LoaderService.UpdatePolicy updatePolicy The required update policy for this resource.

Constructor Detail

LoadableURLResource	back to summary
pack-priv LoadableURLResource(ResourceCache cache, LoadDataInformation loadDataInformation)

Method Detail

clearCache	back to summary
protected void clearCache() This method is called when the cached data should be removed, e.g. after an explicit fallback reload, or a clear operation.

getAccessCount	back to summary
public final int getAccessCount() Get the number of successful accesses. Returns:int the number of successful accesses.

getAccessCount

back to summary

public final int getAccessCount()

Get the number of successful accesses.

Returns:int: the number of successful accesses.

getData	back to summary
public final byte[] getData() Get the resource data. This will trigger a full load, if the resource is not loaded, e.g. for LAZY resources. Returns:byte[] the data to load.

getData

back to summary

public final byte[] getData()

Get the resource data. This will trigger a full load, if the resource is not loaded, e.g. for LAZY resources.

Returns:byte[]: the data to load.

getDataStream	back to summary
public InputStream getDataStream() Implements org.javamoney.moneta.spi.loader.DataStreamFactory.getDataStream. Get the resource data as input stream. Returns:InputStream the input stream.

getDataStream

back to summary

public InputStream getDataStream()

Implements org.javamoney.moneta.spi.loader.DataStreamFactory.getDataStream.

Get the resource data as input stream.

Returns:InputStream: the input stream.

getFallbackResource	back to summary
public final URI getFallbackResource() Return the fallback location. Returns:URI the fallback location, or null.

getFallbackResource

back to summary

public final URI getFallbackResource()

Return the fallback location.

Returns:URI: the fallback location, or null.

getLastLoaded	back to summary
public final long getLastLoaded() Get the timestamp of the last succesful load. Returns:long the lastLoaded

getLastLoaded

back to summary

public final long getLastLoaded()

Get the timestamp of the last succesful load.

Returns:long: the lastLoaded

getLoadCount	back to summary
public final int getLoadCount() Get the number of active loads of this resource (InputStream). Returns:int the number of successful loads.

getLoadCount

back to summary

public final int getLoadCount()

Get the number of active loads of this resource (InputStream).

Returns:int: the number of successful loads.

getProperties	back to summary
public Map<String, String> getProperties() Get the configuration properties of this resource. Returns:Map<String, String> the configuration properties of this resource, never null.

getProperties

back to summary

public Map<String, String> getProperties()

Get the configuration properties of this resource.

Returns:Map<String, String>: the configuration properties of this resource, never null.

getRemoteResources	back to summary
public final List<URI> getRemoteResources() Get the remote locations. Returns:List<URI> the remote locations, maybe empty.

getRemoteResources

back to summary

public final List<URI> getRemoteResources()

Get the remote locations.

Returns:List<URI>: the remote locations, maybe empty.

getResourceId	back to summary
public final String getResourceId() Get the resourceId. Returns:String the resourceId

getResourceId

back to summary

public final String getResourceId()

Get the resourceId.

Returns:String: the resourceId

getUpdatePolicy	back to summary
public LoaderService.UpdatePolicy getUpdatePolicy() Get the UpdatePolicy of this resource. Returns:LoaderService.UpdatePolicy the UpdatePolicy of this resource, never null.

getUpdatePolicy

back to summary

public LoaderService.UpdatePolicy getUpdatePolicy()

Get the UpdatePolicy of this resource.

Returns:LoaderService.UpdatePolicy: the UpdatePolicy of this resource, never null.

load	back to summary
public boolean load() Loads the resource, first from the remote resources, if that fails from the fallback location. Returns:boolean true, if load succeeded.

load

back to summary

public boolean load()

Loads the resource, first from the remote resources, if that fails from the fallback location.

Returns:boolean: true, if load succeeded.

load back to summary

load	back to summary
protected boolean load(URI itemToLoad, boolean fallbackLoad) Tries to load the data from the given location. The location hereby can be a remote location or a local location. Also it can be an URL pointing to a current dataset, or an url directing to fallback resources, e.g. within the current classpath. Parameters itemToLoad:URI the target `URL` fallbackLoad:boolean true, for a fallback URL.

protected boolean load(URI itemToLoad, boolean fallbackLoad)

Tries to load the data from the given location. The location hereby can be a remote location or a local location. Also it can be an URL pointing to a current dataset, or an url directing to fallback resources, e.g. within the current classpath.

Parameters

itemToLoad:URI: the target URL
fallbackLoad:boolean: true, for a fallback URL.

loadFallback	back to summary
public boolean loadFallback() Try to load the resource from the fallback resources. This will override any remote data already loaded, and also will clear the cached data. Returns:boolean true, on success.

loadFallback

back to summary

public boolean loadFallback()

Try to load the resource from the fallback resources. This will override any remote data already loaded, and also will clear the cached data.

Returns:boolean: true, on success.

loadRemote	back to summary
public boolean loadRemote() Try to load the resource from the remote locations. Returns:boolean true, on success.

loadRemote

back to summary

public boolean loadRemote()

Try to load the resource from the remote locations.

Returns:boolean: true, on success.

readCache	back to summary
public boolean readCache() This method is called when the data should be loaded from the cache. This method abstracts the effective caching mechanism implemented. By default it tries to read a file from the current user's home directory. If the data could be read, #setData(byte[]) should be called to apply the data read. Returns:boolean true, if data could be read and applied from the cache sucdcessfully.

readCache

back to summary

public boolean readCache()

This method is called when the data should be loaded from the cache. This method abstracts the effective caching mechanism implemented. By default it tries to read a file from the current user's home directory. If the data could be read, #setData(byte[]) should be called to apply the data read.

Returns:boolean: true, if data could be read and applied from the cache sucdcessfully.

resetToFallback	back to summary
public boolean resetToFallback() Explicitly override the resource wih the fallback context and resets the load counter. Returns:boolean true on success.

resetToFallback

back to summary

public boolean resetToFallback()

Explicitly override the resource wih the fallback context and resets the load counter.

Returns:boolean: true on success.

setData	back to summary
protected final void setData(byte[] bytes)

shouldReadDataFromFallback	back to summary
private boolean shouldReadDataFromFallback()

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned. Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Annotations

@Override

unload	back to summary
public void unload()

writeCache	back to summary
protected void writeCache() throws IOException This method is called after data could be successfully loaded from a non fallback resource. This method by default writes an file containing the data into the user's local home directory, so subsequent or later calls, even after a VM restart, should be able to recover this information.

org.javamoney.moneta.spi.loader.urlconnection back to summary

private final Class LoadableURLResource.WrappedInputStream

Class Inheritance

extends InputStream

java.lang.Object
java.io.InputStream
org.javamoney.moneta.spi.loader.urlconnection.LoadableURLResource.WrappedInputStream

InputStream , that helps managing the load count.

Author: Anatole

Field Summary

Modifier and Type	Field and Description
private final InputStream	wrapped

Constructor Summary

Access	Constructor and Description
pack-priv	WrappedInputStream(InputStream wrapped)

Method Summary

Modifier and Type	Method and Description
public void	close() Overrides java.io.InputStream.close. Implements java.io.Closeable.close. Closes this input stream and releases any system resources associated with the stream.
public int	read() Implements abstract java.io.InputStream.read. Reads the next byte of data from the input stream.

Inherited from java.io.InputStream:: available mark markSupported nullInputStream read read readAllBytes readNBytes readNBytes reset skip skipNBytes transferTo

Field Detail

wrapped	back to summary
private final InputStream wrapped

Constructor Detail

WrappedInputStream	back to summary
pack-priv WrappedInputStream(InputStream wrapped)

Method Detail

close	back to summary
public void close() throws IOException Overrides java.io.InputStream.close. Implements java.io.Closeable.close. Doc from java.io.InputStream.close. Closes this input stream and releases any system resources associated with the stream. Annotations @Override Exceptions IOException: if an I/O error occurs.

back to summary

public void close() throws IOException

Overrides java.io.InputStream.close.

Implements java.io.Closeable.close.

Doc from java.io.InputStream.close.

Closes this input stream and releases any system resources associated with the stream.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs.

read back to summary

read	back to summary
public int read() throws IOException Implements abstract java.io.InputStream.read. Doc from java.io.InputStream.read. Reads the next byte of data from the input stream. The value byte is returned as an `int` in the range `0` to `255`. If no byte is available because the end of the stream has been reached, the value `-1` is returned. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown. Annotations @Override Exceptions IOException: if an I/O error occurs.

public int read() throws IOException

Implements abstract java.io.InputStream.read.

Doc from java.io.InputStream.read.

Reads the next byte of data from the input stream. The value byte is returned as an int in the range 0 to 255. If no byte is available because the end of the stream has been reached, the value -1 is returned. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs.

pack-priv Class LoadableURLResource

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class LoadableURLResource.WrappedInputStream

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail