totalcross.io

Class ResizeRecord

java.lang.Object

totalcross.io.Stream

totalcross.io.ResizeRecord

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class ResizeRecord
extends Stream

This class is used to handle record sizes of a PDBFile. It is used in most cases with a DataStream. For example:

      PDBFile pdb = new PDBFile("Name.Crtr.Type",PDBFile.CREATE);
      ResizeRecord rs = new ResizeRecord(pdb,512);
      DataStream ds = new DataStream(rs);
      rs.startRecord();
      ds.writeStringArray(aStringArray);
      rs.endRecord();
   

PS: if you dont call startRecord, writeBytes will simply call PDBFile.writeBytes and will not resize the record!

Since:

SuperWaba 5.8

Field Summary

Fields inherited from class totalcross.io.Stream

skipBuffer

Constructor Summary

Constructors

Constructor and Description
ResizeRecord(PDBFile cat, int initialSize) Constructs the resize stream.

Method Summary

Modifier and Type	Method and Description
void	close() closes the PDBFile
void	endRecord() Must be called after the record is finished so it can be properly resized.
protected void	finalize()
Stream	getStream() Returns the stream attached to this stream (which is always a PDBFile).
int	readBytes(byte[] buf, int start, int count) Reads bytes from the stream.
boolean	restartRecord(int pos) Restart writing to the given record pos, overwritting the current record.
void	startRecord() Appends a new record to the PDBFile.
void	startRecord(int pos) Inserts the record at the specified index in the PDBFile.
int	writeBytes(byte[] buf, int start, int count) Writes bytes to the stream.

Methods inherited from class totalcross.io.Stream

asInputStream, asOutputStream, asStream, asStream, skipBytes, wrapInputStream, wrapInputStreamToStream, write, writeBytes, writeBytes, writeBytes

Methods inherited from class java.lang.Object

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

Constructor Detail

ResizeRecord

public ResizeRecord(PDBFile cat,
                    int initialSize)

Constructs the resize stream.

Parameters:

cat - The PDBFile associated

initialSize - The initial size of the record. CANNOT BE 0!

Method Detail

startRecord

public void startRecord(int pos)
                 throws IOException

Inserts the record at the specified index in the PDBFile.

Parameters:

pos - The position where to insert the record. If greater or equal to the record count, the record is appended.

Throws:

IOException

Since:

SuperWaba 1.21. *

See Also:

startRecord(), restartRecord(int), endRecord()

startRecord

public void startRecord()
                 throws IOException

Appends a new record to the PDBFile.

Throws:

IOException

See Also:

restartRecord(int), startRecord(int), endRecord()

restartRecord

public boolean restartRecord(int pos)
                      throws IOException

Restart writing to the given record pos, overwritting the current record.

Parameters:

pos - The position to overwrite. If pos is lower than 0 or greater than the number of records of the PDBFile, the record is appended.

Throws:

IOException

See Also:

startRecord(), startRecord(int), endRecord()

endRecord

public void endRecord()
               throws IOException

Must be called after the record is finished so it can be properly resized.

Throws:

IOException

See Also:

startRecord(), restartRecord(int), startRecord(int)

readBytes

public int readBytes(byte[] buf,
                     int start,
                     int count)
              throws IOException

Description copied from class: Stream

Reads bytes from the stream. Returns the number of bytes actually read or -1 if the end of the stream was reached. (if applicable to the stream)

Specified by:

readBytes in class Stream

Parameters:

buf - the byte array to read data into

start - the start position in the array

count - the number of bytes to read

Throws:

IOException

writeBytes

public int writeBytes(byte[] buf,
                      int start,
                      int count)
               throws IOException

Description copied from class: Stream

Writes bytes to the stream. Returns the number of bytes actually written or throws an IOException if an error prevented the write operation from occurring.

Specified by:

writeBytes in class Stream

Parameters:

buf - the byte array to write data from

start - the start position in the byte array

count - the number of bytes to write

Returns:

the number of bytes actually written

Throws:

IOException

close

public void close()
           throws IOException

closes the PDBFile

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

IOException

getStream

public Stream getStream()

Returns the stream attached to this stream (which is always a PDBFile).

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object