LocatorByReference (intarsys runtime library)

java.lang.Object
- de.intarsys.tools.locator.LocatorByReference

All Implemented Interfaces:

IAdapterSupport, ISynchronizable, ILocator
```
public class LocatorByReference
extends Object
implements ILocator, IAdapterSupport
```
This ILocator serves as an adapter for an ILocatorSupport instance.

Constructor Summary

Constructors
Constructor and Description

LocatorByReference(ILocatorSupport locatorSupport)

Constructors
Constructor and Description
`LocatorByReference(ILocatorSupport locatorSupport)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`delete()` Delete the artifact referenced by this.
`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.
`String`	`getFullName()` The full physical name of this.
`InputStream`	`getInputStream()` Return an `InputStream` on the data represented by the receiver.
`long`	`getLength()` Returns the length of this data container or -1 if unknown
`String`	`getLocalName()` The local name of the receiver within its parent.
`ILocatorSupport`	`getLocatorSupport()`
`OutputStream`	`getOutputStream()` Return an `OutputStream` on the location represented by the receiver.
`ILocator`	`getParent()` The `ILocator` that is one hierarchy level up or null.
`IRandomAccess`	`getRandomAccess()` The `IRandomAccess` for this.
`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.
`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.
`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
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - LocatorByReference
```
public LocatorByReference(ILocatorSupport locatorSupport)
```
- Method Detail
  - 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
  - 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.
  - 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.
  - getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
    Description copied from interface: ILocator
    
    Return an InputStream on the data represented by the receiver.
    
    Specified by:
    
    getInputStream in interface ILocator
    
    Returns:
    An InputStream on the data represented by the receiver.
    
    Throws:
    
    IOException
  - 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.
  - getLocatorSupport
```
public ILocatorSupport getLocatorSupport()
```
  - getOutputStream
```
public OutputStream getOutputStream()
                             throws IOException
```
    Description copied from interface: ILocator
    
    Return an OutputStream on the location represented by the receiver.
    
    Specified by:
    
    getOutputStream in interface ILocator
    
    Returns:
    An OutputStream on the location represented by the receiver.
    
    Throws:
    
    IOException
  - 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.
  - getRandomAccess
```
public IRandomAccess getRandomAccess()
                              throws IOException
```
    Description copied from interface: ILocator
    
    The IRandomAccess for this.
    
    Specified by:
    
    getRandomAccess in interface ILocator
    
    Returns:
    The IRandomAccess for this.
    
    Throws:
    
    IOException
  - 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.
  - 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
  - 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 LocatorByReference

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LocatorByReference

Method Detail

delete

exists

getAdapter

getChild

getFullName

getInputStream

getLength

getLocalName

getLocatorSupport

getOutputStream

getParent

getRandomAccess

getReader

getReader

getType

getTypedName

getWriter

getWriter

isDirectory

isOutOfSynch

isReadOnly

listLocators

rename

setReadOnly

synch

toURL