org.palladiosimulator.simulizar.reconfiguration.qvto.util

Class TransformationCache

java.lang.Object

org.palladiosimulator.simulizar.reconfiguration.qvto.util.TransformationCache

public class TransformationCache
extends Object

This cache implementation is used to store QVTo transformations (in terms of TransformationData objects) that can be executed by QVTo executors during reconfigurations. To store a transformation in the cache, its corresponding URI is used as tag.

Author:

Florian Rosenthal

Constructor Summary

Constructors

Constructor and Description
TransformationCache(URI... initialTransformations) Initializes a new instance of the TransformationCache class.

Method Summary

Modifier and Type	Method and Description
void	clear() Clears the cache, that is, all content is discarded.
boolean	contains(URI transformationUri) Gets whether the QVTo transformation which the given URI points to, is currently in the cache.
Optional<TransformationData>	get(URI transformationUri) Attempts to retrieve the QVTo transformation that is associated with the given URI from the cache.
Iterable<TransformationData>	getAll() Gets all the transformations, in terms of the respective TransformationData currently stored in this cache.
void	remove(URI... transformationUris) Removes the QVTo transformations specified by the given URIs from this cache, if present.
TransformationCache	snapshot() Creates a snapshot of the current state of the cache. More precisely, this method creates an instance that contains the same transformations as this one.
void	store(URI... transformationUris) Stores the QVTo transformations specified by the given URIs in the cache.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TransformationCache

@SafeVarargs
public TransformationCache(URI... initialTransformations)

Initializes a new instance of the TransformationCache class.

Parameters:

initialTransformations - A set of transformation URIs that shall be stored in the cache, might be empty.

Method Detail

snapshot

public TransformationCache snapshot()

Creates a snapshot of the current state of the cache.
More precisely, this method creates an instance that contains the same transformations as this one.

Returns:

A TransformationCache which is a snapshot of the current state of this instance.

store

@SafeVarargs
public final void store(URI... transformationUris)

Stores the QVTo transformations specified by the given URIs in the cache.

Parameters:

transformationUris - A set of URIs that point to QVTo transformations.

Throws:

NullPointerException - In case transformationUris == null.

IllegalArgumentException - In case any of the transformations is already present in the cache.

remove

@SafeVarargs
public final void remove(URI... transformationUris)

Removes the QVTo transformations specified by the given URIs from this cache, if present.

Parameters:

transformationUris - A set of URIs that point to QVTo transformations.

Throws:

NullPointerException - In case any of the given uris is null.

get

public Optional<TransformationData> get(URI transformationUri)

Attempts to retrieve the QVTo transformation that is associated with the given URI from the cache.

Parameters:

transformationUri - A URI that points to a QVTo transformation.

Returns:

An Optional containing the TransformationData of the transformation, which is empty if the transformation is not present in cache.

Throws:

NullPointerException - In case the given URI is null.

See Also:

contains(URI)

contains

public boolean contains(URI transformationUri)

Gets whether the QVTo transformation which the given URI points to, is currently in the cache.

Parameters:

transformationUri - A URI that points to a QVTo transformation.

Returns:

true, iff the transformation is stored, false otherwise

Throws:

NullPointerException - In case the given URI is null.

getAll

public Iterable<TransformationData> getAll()

Gets all the transformations, in terms of the respective TransformationData currently stored in this cache.

Returns:

An Iterable of all the stored transformations.

clear

public void clear()

Clears the cache, that is, all content is discarded.