Package org.scijava.download

Class MultiWriteHandle

java.lang.Object

org.scijava.AbstractContextual

org.scijava.plugin.AbstractRichPlugin

org.scijava.plugin.AbstractTypedPlugin<D>

org.scijava.plugin.AbstractWrapperPlugin<L>

org.scijava.io.handle.AbstractDataHandle<Location>

org.scijava.download.MultiWriteHandle

All Implemented Interfaces:

Closeable, DataInput, DataOutput, AutoCloseable, Comparable<Prioritized>, Contextual, Identifiable, DataHandle<Location>, Locatable, Logged, HasPluginInfo, RichPlugin, SciJavaPlugin, TypedPlugin<Location>, WrapperPlugin<Location>, Prioritized, Typed<Location>, Versioned

public class MultiWriteHandle
extends AbstractDataHandle<Location>

DataHandle plugin for writing to multiple DataHandles.

Author:

Curtis Rueden

Nested Class Summary

Nested classes/interfaces inherited from interface org.scijava.io.handle.DataHandle

DataHandle.ByteOrder

Field Summary

Fields inherited from interface org.scijava.io.handle.DataHandle

DEFAULT_BLOCK_SIZE, MAX_SEARCH_SIZE

Constructor Summary

Constructors

Constructor	Description
MultiWriteHandle(DataHandle<?>... handles)

Method Summary

Modifier and Type	Method	Description
String	checksum()	Gets a "fast" checksum which succinctly represents the contents of the data stream.
void	close()
boolean	exists()	Tests whether this handle's location actually exists at the source.
Class<Location>	getType()	Gets the type associated with the object.
boolean	isReadable()	Gets whether reading from this handle is supported.
boolean	isWritable()	Gets whether writing to this handle is supported.
Date	lastModified()	Gets the last modified timestamp of the location.
long	length()	Returns the length of the data in bytes.
long	offset()	Returns the current offset in the stream.
int	read(byte[] b, int off, int len)	Reads up to len bytes of data from the stream into an array of bytes.
byte	readByte()
void	seek(long pos)	Sets the stream offset, measured from the beginning of the stream, at which the next read or write occurs.
void	setLength(long length)	Sets the new length of the handle.
void	write(byte[] b, int off, int len)
void	write(int b)

Methods inherited from class org.scijava.io.handle.AbstractDataHandle

conversionBuffer, getEncoding, getOrder, setEncoding, setOrder

Methods inherited from class org.scijava.plugin.AbstractWrapperPlugin

get, set

Methods inherited from class org.scijava.plugin.AbstractTypedPlugin

supports

Methods inherited from class org.scijava.plugin.AbstractRichPlugin

getInfo, getPriority, setInfo, setPriority, toString

Methods inherited from class org.scijava.AbstractContextual

context, getContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.scijava.Contextual

context, getContext, setContext

Methods inherited from interface org.scijava.io.handle.DataHandle

available, ensureReadable, ensureWritable, findString, findString, findString, findString, isBigEndian, isLittleEndian, read, read, readBoolean, readChar, readCString, readDouble, readFloat, readFully, readFully, readInt, readLine, readLong, readShort, readString, readString, readUnsignedByte, readUnsignedShort, readUTF, setLittleEndian, skip, skipBytes, write, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeDouble, writeFloat, writeInt, writeLine, writeLong, writeShort, writeUTF

Methods inherited from interface org.scijava.plugin.HasPluginInfo

getInfo, setInfo

Methods inherited from interface org.scijava.Locatable

getLocation

Methods inherited from interface org.scijava.Prioritized

compareTo, getPriority, setPriority

Methods inherited from interface org.scijava.plugin.RichPlugin

getIdentifier, log

Methods inherited from interface org.scijava.Typed

supports

Methods inherited from interface org.scijava.Versioned

getVersion

Methods inherited from interface org.scijava.plugin.WrapperPlugin

get, set

Constructor Detail

MultiWriteHandle

public MultiWriteHandle(DataHandle<?>... handles)

Method Detail

isReadable

public boolean isReadable()

Description copied from interface: DataHandle

Gets whether reading from this handle is supported.

isWritable

public boolean isWritable()

Description copied from interface: DataHandle

Gets whether writing to this handle is supported.

exists

public boolean exists()
               throws IOException

Description copied from interface: DataHandle

Tests whether this handle's location actually exists at the source.

Returns:

True if the location exists; false if not.

Throws:

IOException - If something goes wrong with the existence check.

lastModified

public Date lastModified()
                  throws IOException

Description copied from interface: DataHandle

Gets the last modified timestamp of the location.

Returns:

The last modified timestamp, or null if the handle does not support this feature or if the location does not exist.

Throws:

IOException - If something goes wrong with the last modified check.

checksum

public String checksum()
                throws IOException

Description copied from interface: DataHandle

Gets a "fast" checksum which succinctly represents the contents of the data stream. The term "fast" here refers to the idea that the checksum be retrievable quickly, without actually performing a thorough computation across the entire data stream. Typically, such a thing is feasible because the checksum was calculated a priori; e.g., artifacts deployed to remote Maven repositories are always deployed with corresponding checksum files.

No guarantee is made about the exact nature of the checksum (e.g., SHA-1 or MD5), only that the value is deterministic for this particular location with its current contents. In other words: if a checksum differs from a previous inquiry, you can be sure the contents have changed; conversely, if the checksum is still the same, the contents are highly likely to be unchanged.

Returns:

The checksum, or null if the handle does not support this feature.

Throws:

IOException - If something goes wrong when accessing the checksum.

offset

public long offset()
            throws IOException

Description copied from interface: DataHandle

Returns the current offset in the stream.

Throws:

IOException

seek

public void seek(long pos)
          throws IOException

Description copied from interface: DataHandle

Sets the stream offset, measured from the beginning of the stream, at which the next read or write occurs.

Throws:

IOException

length

public long length()
            throws IOException

Description copied from interface: DataHandle

Returns the length of the data in bytes.

Returns:

The length, or -1 if the length is unknown.

Throws:

IOException

setLength

public void setLength(long length)
               throws IOException

Description copied from interface: DataHandle

Sets the new length of the handle.

Parameters:

length - New length.

Throws:

IOException - If there is an error changing the handle's length.

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

Description copied from interface: DataHandle

Reads up to len bytes of data from the stream into an array of bytes.

Returns:

the total number of bytes read into the buffer.

Throws:

IOException

getType

public Class<Location> getType()

Description copied from interface: Typed

Gets the type associated with the object.

readByte

public byte readByte()
              throws IOException

Throws:

IOException

write

public void write(int b)
           throws IOException

Throws:

IOException

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Throws:

IOException

close

public void close()
           throws IOException

Throws:

IOException