org.apache.poi.hslf.record
Class Record

java.lang.Object
  extended by org.apache.poi.hslf.record.Record
Direct Known Subclasses:
RecordAtom, RecordContainer

public abstract class Record
extends java.lang.Object

This abstract class represents a record in the PowerPoint document. Record classes should extend with RecordContainer or RecordAtom, which extend this in turn.

Author:
Nick Burch

Field Summary
protected  POILogger logger
           
 
Constructor Summary
Record()
           
 
Method Summary
static Record buildRecordAtOffset(byte[] b, int offset)
          Build and return the Record at the given offset.
static Record createRecordForType(long type, byte[] b, int start, int len)
          For a given type (little endian bytes 3 and 4 in record header), byte array, start position and length: will return a Record object that will handle that record Remember that while PPT stores the record lengths as 8 bytes short (not including the size of the header), this code assumes you're passing in corrected lengths
static Record[] findChildRecords(byte[] b, int start, int len)
          Default method for finding child records of a container record
abstract  Record[] getChildRecords()
          Fetch all the child records of this record If this record is an atom, will return null If this record is a non-atom, but has no children, will return an empty array
abstract  long getRecordType()
          Returns the type (held as a little endian in bytes 3 and 4) that this class handles
abstract  boolean isAnAtom()
          Is this record type an Atom record (only has data), or is it a non-Atom record (has other records)?
static void writeLittleEndian(int i, java.io.OutputStream o)
          When writing out, write out a signed int (32bit) in Little Endian format
static void writeLittleEndian(short s, java.io.OutputStream o)
          When writing out, write out a signed short (16bit) in Little Endian format
abstract  void writeOut(java.io.OutputStream o)
          Have the contents printer out into an OutputStream, used when writing a file back out to disk (Normally, atom classes will keep their bytes around, but non atom classes will just request the bytes from their children, then chuck on their header and return)
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

logger

protected POILogger logger
Constructor Detail

Record

public Record()
Method Detail

isAnAtom

public abstract boolean isAnAtom()
Is this record type an Atom record (only has data), or is it a non-Atom record (has other records)?


getRecordType

public abstract long getRecordType()
Returns the type (held as a little endian in bytes 3 and 4) that this class handles


getChildRecords

public abstract Record[] getChildRecords()
Fetch all the child records of this record If this record is an atom, will return null If this record is a non-atom, but has no children, will return an empty array


writeOut

public abstract void writeOut(java.io.OutputStream o)
                       throws java.io.IOException
Have the contents printer out into an OutputStream, used when writing a file back out to disk (Normally, atom classes will keep their bytes around, but non atom classes will just request the bytes from their children, then chuck on their header and return)

Throws:
java.io.IOException

writeLittleEndian

public static void writeLittleEndian(int i,
                                     java.io.OutputStream o)
                              throws java.io.IOException
When writing out, write out a signed int (32bit) in Little Endian format

Throws:
java.io.IOException

writeLittleEndian

public static void writeLittleEndian(short s,
                                     java.io.OutputStream o)
                              throws java.io.IOException
When writing out, write out a signed short (16bit) in Little Endian format

Throws:
java.io.IOException

buildRecordAtOffset

public static Record buildRecordAtOffset(byte[] b,
                                         int offset)
Build and return the Record at the given offset. Note - does less error checking and handling than findChildRecords

Parameters:
b - The byte array to build from
offset - The offset to build at

findChildRecords

public static Record[] findChildRecords(byte[] b,
                                        int start,
                                        int len)
Default method for finding child records of a container record


createRecordForType

public static Record createRecordForType(long type,
                                         byte[] b,
                                         int start,
                                         int len)
For a given type (little endian bytes 3 and 4 in record header), byte array, start position and length: will return a Record object that will handle that record Remember that while PPT stores the record lengths as 8 bytes short (not including the size of the header), this code assumes you're passing in corrected lengths



Copyright 2008 The Apache Software Foundation or its licensors, as applicable.