/*
* @(#)RandomAccess.java 1.5 02/08/21
*
* Copyright (c) 1996-2002 Sun Microsystems, Inc. All rights reserved.
*/
package com.sun.media.datasink;
/**
* This interface can be used to re-arrange media file chunks,
* if necessary. This can be used for example to create a streamable
* file where the media header is located at the beginning of the file.
*
*/
public interface RandomAccess {
/**
* Diable/Enable random access operations
*/
void setEnabled(boolean t);
/**
* The chunk to be written is obtained by seeking
* 'inOffset' bytes and reading 'numBytes' bytes
* Return false if any exception was caught, true otherwise
*
* If offset is -1 and numBytes > 0, then set the file length
* to numBytes; return true on success and false otherwise.
*
* Set both parameters to -1 to signal that there will be no
* more writes.
*/
boolean write(long inOffset, int numBytes);
}