org.quattor.pan.dml.data
Class ProtectedHashResource

java.lang.Object
  org.quattor.pan.dml.data.Element
      org.quattor.pan.dml.data.PersistentElement
          org.quattor.pan.dml.data.Resource
              org.quattor.pan.dml.data.HashResource
                  org.quattor.pan.dml.data.ProtectedHashResource

All Implemented Interfaces:

java.lang.Iterable<Resource.Entry>, Operation

public class ProtectedHashResource
extends HashResource

Nested Class Summary

Nested classes/interfaces inherited from class org.quattor.pan.dml.data.Resource

Resource.Entry, Resource.Iterator

Constructor Summary

ProtectedHashResource(HashResource baseHash)

Method Summary

void	checkRange(Range range) Determine if the element satisfies the given range constraint.
Element	duplicate() This method does a "clone" of the given Element.
boolean	equals(java.lang.Object o) Require that all Elements implement an equals method.
Element	get(Term key) Retrieve the Element associated with the given Term (either an index or string key).
protected java.util.Map<java.lang.String,Element>	getBackingMap() Override this method to return the map from the base hash.
int	hashCode() Require that all Elements implement the hashCode method.
boolean	isProtected() This method indicates if the given Element is protected.
Resource.Iterator	iterator() Get an iterator which allows to run over the resources in the Resource.
java.util.Set<Term>	keySet()
java.lang.String	locateUndefinedElement() Determine if the element contains any undefined (transient) elements.
Element	protect() Return a protected version of this Element.
Element	put(Term key, Element newValue) Define the mapping between the given Term and given Element.
void	rput(Term[] terms, int index, Element value) Add the given child to this resource, creating intermediate resources as necessary.
int	size() Get the number of elements in this Resource.
java.lang.String	toString() Require that all Elements implement a reasonable toString method.
Element	writableCopy() This method returns a writable copy of this Element.

Methods inherited from class org.quattor.pan.dml.data.HashResource

checkValidReplacement, getTypeAsString

Methods inherited from class org.quattor.pan.dml.data.Resource

rget, rgetList

Methods inherited from class org.quattor.pan.dml.data.Element

checkInvalidSelfContext, checkRestrictedContext, defined, execute, exists, isBoolean, isDouble, isList, isLong, isNlist, isPersistent, isProperty, isResource, isString, isTransient

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ProtectedHashResource

public ProtectedHashResource(HashResource baseHash)

Method Detail

duplicate

public Element duplicate()

Description copied from class: Element

This method does a "clone" of the given Element. Immutable Elements may return a reference to the same object. Mutable Elements (i.e. Resources) must provide an actual deep-copy of the Element. This method simply returns a reference to the same object and is suitable only for immutable subclasses. Mutable subclasses (i.e. Resources) must override this method to provide an appropriate deep copy. This is not actually named "clone" because it violates the conditions of that method for creating a duplicate of the instance in all cases.

Overrides:

duplicate in class HashResource

Returns:

deep-copy of Element for mutable elements, self-reference for immutable objects

get

public Element get(Term key)
            throws InvalidTermException

Description copied from class: Resource

Retrieve the Element associated with the given Term (either an index or string key).

Overrides:

get in class HashResource

Parameters:

key - Term which acts as the key for the desired Element

Returns:

Element associated with the given Term

Throws:

InvalidTermException - thrown if the term is not of the appropriate type for the resource; the message should contain the string representation of the term

put

public Element put(Term key,
                   Element newValue)
            throws InvalidTermException

Description copied from class: Resource

Define the mapping between the given Term and given Element. The method returns the previous value or null if there was none.

Overrides:

put in class HashResource

Parameters:

key - Term which acts as the key for the desired Element

newValue - Element to associate with the given Term

Returns:

previous value if it existed, null otherwise

Throws:

InvalidTermException - thrown if the term is not of the appropriate type for the resource; the message should contain the string representation of the term

size

public int size()

Description copied from class: Resource

Get the number of elements in this Resource.

Overrides:

size in class HashResource

Returns:

number of elements in this Resource

keySet

public java.util.Set<Term> keySet()

Overrides:

keySet in class HashResource

locateUndefinedElement

public java.lang.String locateUndefinedElement()

Description copied from class: Element

Determine if the element contains any undefined (transient) elements. The call will return null if no undefined elements are found; it will return a string indicating the relative path if an undefined element is found. Subclasses MUST override this method appropriately. This default method will work only for elements which are not containers and not a transient element.

Overrides:

locateUndefinedElement in class HashResource

Returns:

String representation of the path of the undefined element, null otherwise

checkRange

public void checkRange(Range range)
                throws ValidationException

Description copied from class: Element

Determine if the element satisfies the given range constraint. This is used in the validation of the element. By default, this method with throw a ValidationException indicating that range checking of this element is not appropriate.

Overrides:

checkRange in class HashResource

Parameters:

range - Range to check Element against

Throws:

ValidationException - if the element cannot be compared to a range or if the element doesn't meet the range requirement

protect

public Element protect()

Description copied from class: Element

Return a protected version of this Element. The default implementation just returns to "this". Only unprotected resources will have to override this implementation.

Overrides:

protect in class HashResource

Returns:

protected version of the resource

hashCode

public int hashCode()

Description copied from class: Element

Require that all Elements implement the hashCode method.

Overrides:

hashCode in class HashResource

equals

public boolean equals(java.lang.Object o)

Description copied from class: Element

Require that all Elements implement an equals method.

Overrides:

equals in class HashResource

getBackingMap

protected java.util.Map<java.lang.String,Element> getBackingMap()

Override this method to return the map from the base hash. This allows use of the superclass' equals method.

Overrides:

getBackingMap in class HashResource

Returns:

backing map for hash resource

toString

public java.lang.String toString()

Description copied from class: Element

Require that all Elements implement a reasonable toString method.

Overrides:

toString in class HashResource

iterator

public Resource.Iterator iterator()

Description copied from class: Resource

Get an iterator which allows to run over the resources in the Resource. Note that concurrent modification of the Resource is not permitted while actively using the iterator. The effects of doing so are undefined.

Specified by:

iterator in interface java.lang.Iterable<Resource.Entry>

Overrides:

iterator in class HashResource

Returns:

Iterator which will allow access to the key, value pairs of the Resource

isProtected

public boolean isProtected()

Description copied from class: Element

This method indicates if the given Element is protected. A protected element may not be written to and concerns just resources. The default implementation just returns false. This should be sufficient except for protected resources.

Overrides:

isProtected in class Element

rput

public void rput(Term[] terms,
                 int index,
                 Element value)
          throws InvalidTermException

Description copied from class: Element

Add the given child to this resource, creating intermediate resources as necessary. If this Element is not a resource, then this will throw an InvalidTermException. The default implementation of this method throws such an exception. This resource must be a writable resource, otherwise an exception will be thrown.

Overrides:

rput in class Resource

Throws:

InvalidTermException - thrown if an trying to dereference a list with a key or a hash with an index

writableCopy

public Element writableCopy()

Description copied from class: Element

This method returns a writable copy of this Element. The default implementation just returns a reference to the same Element. This is the correct behavior for any object that returns false for the isProtected method. Objects that return true for isProtected, must override this method.

Overrides:

writableCopy in class Element

Returns:

returns a writable copy of this element; if the current element is not protected, then a reference to this object is returned