TrustedLocator (intarsys runtime library)

java.lang.Object
- de.intarsys.tools.locator.trusted.TrustedLocator

All Implemented Interfaces:

IAdapterSupport, ISynchronizable, ILocator, ITrustedLocator

Direct Known Subclasses:

HashedTrustedLocator, MemoryTrustedLocator
```
public abstract class TrustedLocator
extends Object
implements ILocator, ITrustedLocator, IAdapterSupport
```
A common superclass for implementing ITrustedLocator

Constructor Summary

Constructors
Constructor and Description

TrustedLocator(TrustedLocatorFactory factory, ILocator wrapped)

Constructors
Constructor and Description
`TrustedLocator(TrustedLocatorFactory factory, ILocator wrapped)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`checkpoint()` Make sure current state of the resource is still the same as seen with last "checkpoint".
`void`	`delete()` Delete the artifact referenced by this.
`void`	`ensureEqual(ILocator locator)` Check if `locator` references data that is equal to the one referenced by this.
`boolean`	`equals(Object obj)`
`boolean`	`exists()` Answer `true` if the location designated by this exists.
`<T> T`	`getAdapter(Class<T> clazz)` Return an object of type `clazz` that represents the receiver.
`ILocator`	`getChild(String name)` The locator for the resource `name` within the context of this.
`IOException`	`getException()`
`TrustedLocatorFactory`	`getFactory()`
`String`	`getFullName()` The full physical name of this.
`long`	`getLength()` Returns the length of this data container or -1 if unknown
`String`	`getLocalName()` The local name of the receiver within its parent.
`ILocator`	`getParent()` The `ILocator` that is one hierarchy level up or null.
`Reader`	`getReader()` A `Reader` on the data represented by the receiver.
`Reader`	`getReader(String encoding)` A `Reader` on the data represented by the receiver for the given encoding.
`String`	`getType()` The type of the resource.
`String`	`getTypedName()` The qualified local name of the receiver within its parent that includes the type specification for the destination if appropriate.
`ILocator`	`getWrapped()` The wrapped `ILocator` for this.
`Writer`	`getWriter()` A `Writer` on the location represented by the receiver.
`Writer`	`getWriter(String encoding)` A `Writer` on the location represented by the receiver for the given encoding.
`int`	`hashCode()`
`boolean`	`isDirectory()` Answer `true` if the location designated by this is a directory.
`boolean`	`isOutOfSynch()` `true` if the component is out of synch.
`boolean`	`isReadOnly()` `true` if the specified resource is read only.
`ILocator[]`	`listLocators(ILocatorNameFilter filter)` Return an array of `ILocator` that are children of the receiver that conform to `filter`.
`void`	`rename(String newName)` Rename the complete physical name to `newName`.
`void`	`setReadOnly()` Make the receiver read only.
`void`	`synch()` Perform a synchronization with the components physical resources.
`URL`	`toURL()` The location designated by this as an `URL`.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.intarsys.tools.locator.ILocator
getInputStream, getOutputStream, getRandomAccess

- Constructor Detail
  - TrustedLocator
```
public TrustedLocator(TrustedLocatorFactory factory,
              ILocator wrapped)
```
- Method Detail
  - checkpoint
```
public void checkpoint()
                throws IOException
```
    Description copied from interface: ITrustedLocator
    
    Make sure current state of the resource is still the same as seen with last "checkpoint". If this is called without any prior state information available, an implicit initial "checkpoint" is made. Subsequent access to the resources data will see exactly the state as seen at this moment or FAIL.
    Most likely the ITrustedLocator will take a hash value here which it uses to compare when a physical access is made later. Be sure to understand the documentation on the measures taken by a concrete implementation as this is crucial for security level and performance.
    
    Specified by:
    
    checkpoint in interface ITrustedLocator
    
    Throws:
    
    IOException
  - delete
```
public void delete()
            throws IOException
```
    Description copied from interface: ILocator
    
    Delete the artifact referenced by this.
    
    Specified by:
    
    delete in interface ILocator
    
    Throws:
    
    IOException
  - ensureEqual
```
public void ensureEqual(ILocator locator)
                 throws IOException
```
    Description copied from interface: ITrustedLocator
    
    Check if locator references data that is equal to the one referenced by this.
    
    Specified by:
    
    ensureEqual in interface ITrustedLocator
    
    Parameters:
    locator - The ILocator to the data to be checked against this.
    
    Throws:
    
    IOException
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - exists
```
public boolean exists()
```
    Description copied from interface: ILocator
    
    Answer true if the location designated by this exists.
    
    Specified by:
    
    exists in interface ILocator
    
    Returns:
    Answer true if the location designated by this exists.
  - getAdapter
```
public <T> T getAdapter(Class<T> clazz)
```
    Description copied from interface: IAdapterSupport
    
    Return an object of type clazz that represents the receiver.
    This method should return null if adaption is not possible.
    
    Specified by:
    
    getAdapter in interface IAdapterSupport
    
    Returns:
    Return an object of type clazz that represents the receiver.
  - getChild
```
public ILocator getChild(String name)
```
    Description copied from interface: ILocator
    
    The locator for the resource name within the context of this. This may for example be an ILocator to a file within a directory.
    
    Specified by:
    
    getChild in interface ILocator
    
    Parameters:
    name - The name of the resource to be located.
    
    Returns:
    The ILocator for the resource with the name "name" within the context of this.
  - getException
```
public IOException getException()
```
  - getFactory
```
public TrustedLocatorFactory getFactory()
```
  - getFullName
```
public String getFullName()
```
    Description copied from interface: ILocator
    
    The full physical name of this.
    This method returns a representation that is proprietary to the underlying physical representation, for example a file name, a SQL statement or so on.
    
    Specified by:
    
    getFullName in interface ILocator
    
    Returns:
    The full physical name of the receiver.
  - getLength
```
public long getLength()
               throws IOException
```
    Description copied from interface: ILocator
    
    Returns the length of this data container or -1 if unknown
    
    Specified by:
    
    getLength in interface ILocator
    
    Returns:
    the length of this data container, measured in bytes.
    
    Throws:
    
    IOException - if an I/O error occurs.
  - getLocalName
```
public String getLocalName()
```
    Description copied from interface: ILocator
    
    The local name of the receiver within its parent.
    
    Specified by:
    
    getLocalName in interface ILocator
    
    Returns:
    The local name of the receiver within its parent.
  - getParent
```
public ILocator getParent()
```
    Description copied from interface: ILocator
    
    The ILocator that is one hierarchy level up or null. This may be for example the directory where the currently designated resource is found.
    
    Specified by:
    
    getParent in interface ILocator
    
    Returns:
    The ILocatorthat is one hierarchy level up or null.
  - getReader
```
public Reader getReader()
                 throws IOException
```
    Description copied from interface: ILocator
    
    A Reader on the data represented by the receiver.
    
    Specified by:
    
    getReader in interface ILocator
    
    Returns:
    A Reader on the data represented by the receiver.
    
    Throws:
    
    IOException
  - getReader
```
public Reader getReader(String encoding)
                 throws IOException
```
    Description copied from interface: ILocator
    
    A Reader on the data represented by the receiver for the given encoding.
    
    Specified by:
    
    getReader in interface ILocator
    
    Parameters:
    encoding - The encoding.
    
    Returns:
    A Reader on the data represented by the receiver for the given encoding.
    
    Throws:
    
    IOException
  - getType
```
public String getType()
```
    Description copied from interface: ILocator
    
    The type of the resource. This may be for example a mime type or the file extension of the underlying file.
    
    Specified by:
    
    getType in interface ILocator
    
    Returns:
    The type of the resource
  - getTypedName
```
public String getTypedName()
```
    Description copied from interface: ILocator
    
    The qualified local name of the receiver within its parent that includes the type specification for the destination if appropriate. This is for example a filename with its correct suffix. Some locator may return the same name as "getLocalName".
    
    Specified by:
    
    getTypedName in interface ILocator
    
    Returns:
    The qualified local name of the receiver within its parent that includes the type specification for the destination if appropriate.
  - getWrapped
```
public ILocator getWrapped()
```
    The wrapped ILocator for this. You should not use this one directly for security relevant operations.
    
    Returns:
    The wrapped ILocator for this.
  - getWriter
```
public Writer getWriter()
                 throws IOException
```
    Description copied from interface: ILocator
    
    A Writer on the location represented by the receiver.
    
    Specified by:
    
    getWriter in interface ILocator
    
    Returns:
    A Writer on the location represented by the receiver.
    
    Throws:
    
    IOException
  - getWriter
```
public Writer getWriter(String encoding)
                 throws IOException
```
    Description copied from interface: ILocator
    
    A Writer on the location represented by the receiver for the given encoding.
    
    Specified by:
    
    getWriter in interface ILocator
    
    Parameters:
    encoding - The encoding.
    
    Returns:
    A Writer on the location represented by the receiver for the given encoding.
    
    Throws:
    
    IOException
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - isDirectory
```
public boolean isDirectory()
```
    Description copied from interface: ILocator
    
    Answer true if the location designated by this is a directory. A directory location serves as a container for other resources, you can never getInputStream on this.
    
    Specified by:
    
    isDirectory in interface ILocator
    
    Returns:
    Answer true if the location designated by this is a directory.
  - isOutOfSynch
```
public boolean isOutOfSynch()
```
    Description copied from interface: ISynchronizable
    
    true if the component is out of synch.
    
    Specified by:
    
    isOutOfSynch in interface ISynchronizable
    
    Returns:
    true if the component is out of synch.
  - isReadOnly
```
public boolean isReadOnly()
```
    Description copied from interface: ILocator
    
    true if the specified resource is read only.
    
    Specified by:
    
    isReadOnly in interface ILocator
    
    Returns:
    true if the specified resource is read only.
  - listLocators
```
public ILocator[] listLocators(ILocatorNameFilter filter)
                        throws IOException
```
    Description copied from interface: ILocator
    
    Return an array of ILocator that are children of the receiver that conform to filter. This method never returns null.
    
    Specified by:
    
    listLocators in interface ILocator
    
    Parameters:
    filter - The filter used to examine the child resources.
    
    Returns:
    An array of ILocator objects that conform to the filter argument.
    
    Throws:
    
    IOException
  - rename
```
public void rename(String newName)
            throws IOException
```
    Description copied from interface: ILocator
    
    Rename the complete physical name to newName.
    
    Specified by:
    
    rename in interface ILocator
    
    Parameters:
    newName - The new name of the ILocator. The new name is expected to contain both local and type part of the name.
    
    Throws:
    
    IOException
  - setReadOnly
```
public void setReadOnly()
```
    Description copied from interface: ILocator
    
    Make the receiver read only. This is a one way switch only.
    
    Specified by:
    
    setReadOnly in interface ILocator
  - synch
```
public void synch()
```
    Description copied from interface: ISynchronizable
    
    Perform a synchronization with the components physical resources.
    In case of a scheduled synchronization this may be called by an external daemon.
    
    Specified by:
    
    synch in interface ISynchronizable
  - toURL
```
public URL toURL()
```
    Description copied from interface: ILocator
    
    The location designated by this as an URL.
    
    Specified by:
    
    toURL in interface ILocator
    
    Returns:
    The location designated by this as an URL.

Class TrustedLocator

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface de.intarsys.tools.locator.ILocator

Constructor Detail

TrustedLocator

Method Detail

checkpoint

delete

ensureEqual

equals

exists

getAdapter

getChild

getException

getFactory

getFullName

getLength

getLocalName

getParent

getReader

getReader

getType

getTypedName

getWrapped

getWriter

getWriter

hashCode

isDirectory

isOutOfSynch

isReadOnly

listLocators

rename

setReadOnly

synch

toURL