Javadoc updates: Removed some autogenerated comments and

added my own ones.


git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@352819 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Rainer Klute 2002-07-30 14:56:02 +00:00
parent 6304b81aa3
commit fe2a12a53b
2 changed files with 362 additions and 448 deletions

View File

@ -56,292 +56,301 @@ package org.apache.poi.hpsf;
import java.io.*;
import java.util.*;
import org.apache.poi.util.LittleEndian;
import org.apache.poi.hpsf.wellknown.*;
import org.apache.poi.poifs.filesystem.*;
import org.apache.poi.util.LittleEndian;
/**
* <p>
* <p>Represents a property set in the Horrible Property Set Format
* (HPSF). These are usually metadata of a Microsoft Office
* document.</p>
*
* Represents a property set in the Horrible Property Set Format (HPSF). These
* are usually metadata of a Microsoft Office document.</p> <p>
* <p>An application that wants to access these metadata should create
* an instance of this class or one of its subclasses by calling the
* factory method {@link PropertySetFactory#create} and then retrieve
* the information its needs by calling appropriate methods.</p>
*
* An application that wants to access these metadata should create an instance
* of this class or one of its subclasses by calling the factory method {@link
* PropertySetFactory#create} and then retrieve the information its needs by
* calling appropriate methods.</p> <p>
* <p>{@link PropertySetFactory#create} does its work by calling one
* of the constructors {@link PropertySet#PropertySet(InputStream)} or
* {@link PropertySet#PropertySet(byte[])}. If the constructor's
* argument is not in the Horrible Property Set Format, i.e. not a
* property set stream, or if any other error occurs, an appropriate
* exception is thrown.</p>
*
* {@link PropertySetFactory#create} does its work by calling one of the
* constructors {@link PropertySet#PropertySet(InputStream)} or {@link
* PropertySet#PropertySet(byte[])}. If the constructor's argument is not in
* the Horrible Property Set Format, i.e. not a property set stream, or if any
* other error occurs, an appropriate exception is thrown.</p> <p>
* <p>A {@link PropertySet} has a list of {@link Section}s, and each
* {@link Section} has a {@link Property} array. Use {@link
* #getSections} to retrieve the {@link Section}s, then call {@link
* Section#getProperties} for each {@link Section} to get hold of the
* {@link Property} arrays.</p> Since the vast majority of {@link
* PropertySet}s contains only a single {@link Section}, the
* convenience method {@link #getProperties} returns the properties of
* a {@link PropertySet}'s {@link Section} (throwing a {@link
* NoSingleSectionException} if the {@link PropertySet} contains more
* (or less) than exactly one {@link Section}).</p>
*
* A {@link PropertySet} has a list of {@link Section}s, and each {@link
* Section} has a {@link Property} array. Use {@link #getSections} to retrieve
* the {@link Section}s, then call {@link Section#getProperties} for each
* {@link Section} to get hold of the {@link Property} arrays.</p> Since the
* vast majority of {@link PropertySet}s contains only a single {@link
* Section}, the convenience method {@link #getProperties} returns the
* properties of a {@link PropertySet}'s {@link Section} (throwing a {@link
* NoSingleSectionException} if the {@link PropertySet} contains more (or less)
* than exactly one {@link Section}).
*
*@author Rainer Klute (klute@rainer-klute.de)
*@author Drew Varner (Drew.Varner hanginIn sc.edu)
*@created May 10, 2002
*@version $Id$
*@since 2002-02-09
* @author Rainer Klute (klute@rainer-klute.de)
* @author Drew Varner (Drew.Varner hanginIn sc.edu)
* @version $Id$
* @since 2002-02-09
*/
public class PropertySet {
final static byte[] BYTE_ORDER_ASSERTION =
new byte[]{(byte) 0xFE, (byte) 0xFF};
final static byte[] FORMAT_ASSERTION =
new byte[]{(byte) 0x00, (byte) 0x00};
private int byteOrder;
// Must equal BYTE_ORDER_ASSERTION
public class PropertySet
{
/**
* <p>
*
* Returns the property set stream's low-level "byte order" field. It is
* always <tt>0xFFFE</tt> .</p>
*
*@return The byteOrder value
* <p>The "byteOrder" field must equal this value.</p>
*/
public int getByteOrder() {
final static byte[] BYTE_ORDER_ASSERTION =
new byte[]{(byte) 0xFE, (byte) 0xFF};
/**
* <p>The "format" field must equal this value.</p>
*/
final static byte[] FORMAT_ASSERTION =
new byte[]{(byte) 0x00, (byte) 0x00};
/**
* <p>Specifies this {@link PropertySet}'s byte order. See the
* HPFS documentation for details!</p>
*/
private int byteOrder;
/**
* <p>Returns the property set stream's low-level "byte order"
* field. It is always <tt>0xFFFE</tt> .</p>
*
* @return The property set stream's low-level "byte order" field.
*/
public int getByteOrder()
{
return byteOrder;
}
/**
* <p>Specifies this {@link PropertySet}'s format. See the HPFS
* documentation for details!</p>
*/
private int format;
// Must equal FORMAT_ASSERTION
/**
* <p>
* <p>Returns the property set stream's low-level "format"
* field. It is always <tt>0x0000</tt> .</p>
*
* Returns the property set stream's low-level "format" field. It is always
* <tt>0x0000</tt> .</p>
*
*@return The format value
* @return The property set stream's low-level "format" field.
*/
public int getFormat() {
public int getFormat()
{
return format;
}
/**
* <p>Specifies the version of the operating system that created
* this {@link PropertySet}. See the HPFS documentation for
* details!</p>
*/
private long osVersion;
/**
* <p>
* <p>Returns the property set stream's low-level "OS version"
* field.</p>
*
* Returns the property set stream's low-level "OS version" field.</p>
*
*@return The oSVersion value
* @return The property set stream's low-level "OS version" field.
*/
public long getOSVersion() {
public long getOSVersion()
{
return osVersion;
}
/**
* <p>Specifies this {@link PropertySet}'s "classID" field. See
* the HPFS documentation for details!</p>
*/
private ClassID classID;
/**
* <p>
* <p>Returns the property set stream's low-level "class ID"
* field.</p>
*
* Returns the property set stream's low-level "class ID" field.</p>
*
*@return The classID value
* @return The property set stream's low-level "class ID" field.
*/
public ClassID getClassID() {
public ClassID getClassID()
{
return classID;
}
/**
* <p>The number of sections in this {@link PropertySet}.</p>
*/
private long sectionCount;
/**
* <p>
* <p>Returns the number of {@link Section}s in the property
* set.</p>
*
* Returns the number of {@link Section}s in the property set.</p>
*
*@return The sectionCount value
* @return The number of {@link Section}s in the property set.
*/
public long getSectionCount() {
public long getSectionCount()
{
return sectionCount;
}
/**
* <p>The sections in this {@link PropertySet}.</p>
*/
private List sections;
/**
* <p>
* <p>Returns the {@link Section}s in the property set.</p>
*
* Returns the {@link Section}s in the property set.</p>
*
*@return The sections value
* @return The {@link Section}s in the property set.
*/
public List getSections() {
public List getSections()
{
return sections;
}
/**
* <p>
* <p>Creates an empty (uninitialized) {@link PropertySet}.</p>
*
* Creates an empty (uninitialized) {@link PropertySet}.</p> <p>
*
* <strong>Please note:</strong> For the time being this constructor is
* protected since it is used for internal purposes only, but expect it to
* become public once the property set writing functionality is
* implemented.</p>
* <p><strong>Please note:</strong> For the time being this
* constructor is protected since it is used for internal purposes
* only, but expect it to become public once the property set's
* writing functionality is implemented.</p>
*/
protected PropertySet() { }
protected PropertySet()
{}
/**
* <p>
* <p>Creates a {@link PropertySet} instance from an {@link
* InputStream} in the Horrible Property Set Format.</p>
*
* Creates a {@link PropertySet} instance from an {@link InputStream} in
* the Horrible Property Set Format.</p> <p>
* <p>The constructor reads the first few bytes from the stream
* and determines whether it is really a property set stream. If
* it is, it parses the rest of the stream. If it is not, it
* resets the stream to its beginning in order to let other
* components mess around with the data and throws an
* exception.</p>
*
* The constructor reads the first few bytes from the stream and determines
* whether it is really a property set stream. If it is, it parses the rest
* of the stream. If it is not, it resets the stream to its beginning in
* order to let other components mess around with the data and throws an
* exception.</p>
*
*@param stream Description of the Parameter
*@exception NoPropertySetStreamException Description of the Exception
*@exception MarkUnsupportedException Description of the Exception
*@exception IOException Description of the Exception
*@throws NoPropertySetStreamException if the stream is not a property
* set stream.
*@throws MarkUnsupportedException if the stream does not support
* the {@link InputStream#markSupported} method.
*@throws IOException if the {@link InputStream}
* cannot not be accessed as needed.
* @param stream Holds the data making out the property set
* stream.
* @throws MarkUnsupportedException if the stream does not support
* the {@link InputStream#markSupported} method.
* @throws IOException if the {@link InputStream} cannot not be
* accessed as needed.
*/
public PropertySet(final InputStream stream)
throws NoPropertySetStreamException, MarkUnsupportedException,
IOException {
if (isPropertySetStream(stream)) {
throws NoPropertySetStreamException, MarkUnsupportedException,
IOException
{
if (isPropertySetStream(stream))
{
final int avail = stream.available();
final byte[] buffer = new byte[avail];
stream.read(buffer, 0, buffer.length);
init(buffer, 0, buffer.length);
} else {
throw new NoPropertySetStreamException();
}
else
throw new NoPropertySetStreamException();
}
/**
* <p>
* <p>Creates a {@link PropertySet} instance from a byte array
* that represents a stream in the Horrible Property Set
* Format.</p>
*
* Creates a {@link PropertySet} instance from a byte array that represents
* a stream in the Horrible Property Set Format.</p>
*
*@param stream The byte array holding the
* stream data.
*@param offset The offset in <var>stream</var>
* where the stream data begin. If the stream data begin with the first
* byte in the array, the <var>offset</var> is 0.
*@param length The length of the stream data.
*@exception NoPropertySetStreamException Description of the Exception
*@throws NoPropertySetStreamException if the byte array is not a
* property set stream.
* @param stream The byte array holding the stream data.
* @param offset The offset in <var>stream</var> where the stream
* data begin. If the stream data begin with the first byte in the
* array, the <var>offset</var> is 0.
* @param length The length of the stream data.
* @throws NoPropertySetStreamException if the byte array is not a
* property set stream.
*/
public PropertySet(final byte[] stream, final int offset, final int length)
throws NoPropertySetStreamException {
if (isPropertySetStream(stream, offset, length)) {
throws NoPropertySetStreamException
{
if (isPropertySetStream(stream, offset, length))
init(stream, offset, length);
} else {
else
throw new NoPropertySetStreamException();
}
}
/**
* <p>
* <p>Creates a {@link PropertySet} instance from a byte array
* that represents a stream in the Horrible Property Set
* Format.</p>
*
* Creates a {@link PropertySet} instance from a byte array that represents
* a stream in the Horrible Property Set Format.</p>
*
*@param stream The byte array holding the
* stream data. The complete byte array contents is the stream data.
*@exception NoPropertySetStreamException Description of the Exception
*@throws NoPropertySetStreamException if the byte array is not a
* property set stream.
* @param stream The byte array holding the stream data. The
* complete byte array contents is the stream data.
* @throws NoPropertySetStreamException if the byte array is not a
* property set stream.
*/
public PropertySet(final byte[] stream)
throws NoPropertySetStreamException {
public PropertySet(final byte[] stream) throws NoPropertySetStreamException
{
this(stream, 0, stream.length);
}
/**
* <p>
* <p>Checks whether an {@link InputStream} is in the Horrible
* Property Set Format.</p>
*
* Checks whether an {@link InputStream} is in the Horrible Property Set
* Format.</p>
*
*@param stream The {@link InputStream} to check. In
* order to perform the check, the method reads the first bytes from
* the stream. After reading, the stream is reset to the position it
* had before reading. The {@link InputStream} must support the {@link
* InputStream#mark} method.
*@return <code>true</code> if the stream is a
* property set stream, else <code>false</code>.
*@exception IOException Description of the Exception
*@throws MarkUnsupportedException if the {@link InputStream} does not
* support the {@link InputStream#mark} method.
* @param stream The {@link InputStream} to check. In order to
* perform the check, the method reads the first bytes from the
* stream. After reading, the stream is reset to the position it
* had before reading. The {@link InputStream} must support the
* {@link InputStream#mark} method.
* @return <code>true</code> if the stream is a property set
* stream, else <code>false</code>.
* @throws MarkUnsupportedException if the {@link InputStream}
* does not support the {@link InputStream#mark} method.
*/
public static boolean isPropertySetStream(final InputStream stream)
throws MarkUnsupportedException, IOException {
throws MarkUnsupportedException, IOException
{
/*
* Read at most this many bytes.
* Read at most this many bytes.
*/
final int BUFFER_SIZE = 50;
/*
* Mark the current position in the stream so that we can
* reset to this position if the stream does not contain a
* property set.
* Mark the current position in the stream so that we can
* reset to this position if the stream does not contain a
* property set.
*/
if (!stream.markSupported()) {
if (!stream.markSupported())
throw new MarkUnsupportedException(stream.getClass().getName());
}
stream.mark(BUFFER_SIZE);
stream.mark(BUFFER_SIZE);
/*
* Read a couple of bytes from the stream.
* Read a couple of bytes from the stream.
*/
final byte[] buffer = new byte[BUFFER_SIZE];
final int bytes =
stream.read(buffer, 0,
Math.min(buffer.length, stream.available()));
stream.read(buffer, 0,
Math.min(buffer.length, stream.available()));
final boolean isPropertySetStream =
isPropertySetStream(buffer, 0, bytes);
isPropertySetStream(buffer, 0, bytes);
stream.reset();
return isPropertySetStream;
}
@ -349,66 +358,63 @@ public class PropertySet {
/**
* <p>
* <p>Checks whether a byte array is in the Horrible Property Set
* Format.</p>
*
* Checks whether a byte array is in the Horrible Property Set Format.</p>
*
*@param src The byte array to check.
*@param offset The offset in the byte array.
*@param length The significant number of bytes in the byte array. Only
* this number of bytes will be checked.
*@return <code>true</code> if the byte array is a property set
* stream, <code>false</code> if not.
* @param src The byte array to check.
* @param offset The offset in the byte array.
* @param length The significant number of bytes in the byte
* array. Only this number of bytes will be checked.
* @return <code>true</code> if the byte array is a property set
* stream, <code>false</code> if not.
*/
public static boolean isPropertySetStream(final byte[] src, int offset,
final int length) {
final int length)
{
/*
* Read the header fields of the stream. They must always be
* there.
* Read the header fields of the stream. They must always be
* there.
*/
final int byteOrder = LittleEndian.getUShort(src, offset);
offset += LittleEndian.SHORT_SIZE;
byte[] temp = new byte[LittleEndian.SHORT_SIZE];
LittleEndian.putShort(temp,(short)byteOrder);
if (!Util.equal(temp, BYTE_ORDER_ASSERTION)) {
if (!Util.equal(temp, BYTE_ORDER_ASSERTION))
return false;
}
final int format = LittleEndian.getUShort(src, offset);
final int format = LittleEndian.getUShort(src, offset);
offset += LittleEndian.SHORT_SIZE;
temp = new byte[LittleEndian.SHORT_SIZE];
LittleEndian.putShort(temp,(short)format);
if (!Util.equal(temp, FORMAT_ASSERTION)) {
if (!Util.equal(temp, FORMAT_ASSERTION))
return false;
}
final long osVersion = LittleEndian.getUInt(src, offset);
final long osVersion = LittleEndian.getUInt(src, offset);
offset += LittleEndian.INT_SIZE;
final ClassID classID = new ClassID(src, offset);
offset += ClassID.LENGTH;
final long sectionCount = LittleEndian.getUInt(src, offset);
offset += LittleEndian.INT_SIZE;
if (sectionCount < 1) {
if (sectionCount < 1)
return false;
}
return true;
return true;
}
/**
* <p>
* <p>Initializes this {@link PropertySet} instance from a byte
* array. The method assumes that it has been checked already that
* the byte array indeed represents a property set stream. It does
* no more checks on its own.</p>
*
* Initializes this {@link PropertySet} instance from a byte array. The
* method assumes that it has been checked already that the byte array
* indeed represents a property set stream. It does no more checks on its
* own.</p>
*
*@param src Description of the Parameter
*@param offset Description of the Parameter
*@param length Description of the Parameter
* @param src Byte array containing the property set stream
* @param offset The property set stream starts at this offset
* from the beginning of <var>src</src>
* @param length Length of the property set stream.
*/
private void init(final byte[] src, int offset, final int length) {
private void init(final byte[] src, int offset, final int length)
{
/*
* Read the stream's header fields.
* Read the stream's header fields.
*/
byteOrder = LittleEndian.getUShort(src, offset);
offset += LittleEndian.SHORT_SIZE;
@ -422,25 +428,26 @@ public class PropertySet {
offset += LittleEndian.INT_SIZE;
/*
* Read the sections, which are following the header. They
* start with an array of section descriptions. Each one
* consists of a format ID telling what the section contains
* and an offset telling how many bytes from the start of the
* stream the section begins.
* Read the sections, which are following the header. They
* start with an array of section descriptions. Each one
* consists of a format ID telling what the section contains
* and an offset telling how many bytes from the start of the
* stream the section begins.
*/
/*
* Most property sets have only one section. The Document
* Summary Information stream has 2. Everything else is a rare
* exception and is no longer fostered by Microsoft.
* Most property sets have only one section. The Document
* Summary Information stream has 2. Everything else is a rare
* exception and is no longer fostered by Microsoft.
*/
sections = new ArrayList(2);
/*
* Loop over the section descriptor array. Each descriptor
* consists of a ClassID and a DWord, and we have to increment
* "offset" accordingly.
* Loop over the section descriptor array. Each descriptor
* consists of a ClassID and a DWord, and we have to increment
* "offset" accordingly.
*/
for (int i = 0; i < sectionCount; i++) {
for (int i = 0; i < sectionCount; i++)
{
final Section s = new Section(src, offset);
offset += ClassID.LENGTH + LittleEndian.INT_SIZE;
sections.add(s);
@ -450,156 +457,152 @@ public class PropertySet {
/**
* <p>
* <p>Checks whether this {@link PropertySet} represents a Summary
* Information.</p>
*
* Checks whether this {@link PropertySet} represents a Summary
* Information.</p>
*
*@return The summaryInformation value
* @return <code>true</code> if this {@link PropertySet}
* represents a Summary Information, else <code>false</code>.
*/
public boolean isSummaryInformation() {
public boolean isSummaryInformation()
{
return Util.equal(((Section) sections.get(0)).getFormatID().getBytes(),
SectionIDMap.SUMMARY_INFORMATION_ID);
SectionIDMap.SUMMARY_INFORMATION_ID);
}
/**
* <p>
* <p>Checks whether this {@link PropertySet} is a Document
* Summary Information.</p>
*
* Checks whether this {@link PropertySet} is a Document Summary
* Information.</p>
*
*@return The documentSummaryInformation value
* @return <code>true</code> if this {@link PropertySet}
* represents a Document Summary Information, else <code>false</code>.
*/
public boolean isDocumentSummaryInformation() {
public boolean isDocumentSummaryInformation()
{
return Util.equal(((Section) sections.get(0)).getFormatID().getBytes(),
SectionIDMap.DOCUMENT_SUMMARY_INFORMATION_ID);
SectionIDMap.DOCUMENT_SUMMARY_INFORMATION_ID);
}
/**
* <p>
* <p>Convenience method returning the {@link Property} array
* contained in this property set. It is a shortcut for getting
* the {@link PropertySet}'s {@link Section}s list and then
* getting the {@link Property} array from the first {@link
* Section}. However, it can only be used if the {@link
* PropertySet} contains exactly one {@link Section}, so check
* {@link #getSectionCount} first!</p>
*
* Convenience method returning the {@link Property} array contained in
* this property set. It is a shortcut for getting the {@link
* PropertySet}'s {@link Section}s list and then getting the {@link
* Property} array from the first {@link Section}. However, it can only be
* used if the {@link PropertySet} contains exactly one {@link Section}, so
* check {@link #getSectionCount} first!</p>
*
*@return The properties of the only {@link
* Section} of this {@link PropertySet}.
*@throws NoSingleSectionException if the {@link PropertySet} has more or
* less than one {@link Section}.
* @return The properties of the only {@link Section} of this
* {@link PropertySet}.
* @throws NoSingleSectionException if the {@link PropertySet} has
* more or less than one {@link Section}.
*/
public Property[] getProperties()
throws NoSingleSectionException {
throws NoSingleSectionException
{
return getSingleSection().getProperties();
}
/**
* <p>
* <p>Convenience method returning the value of the property with
* the specified ID. If the property is not available,
* <code>null</code> is returned and a subsequent call to {@link
* #wasNull} will return <code>true</code> .</p>
*
* Convenience method returning the value of the property with the
* specified ID. If the property is not available, <code>null</code> is
* returned and a subsequent call to {@link #wasNull} will return <code>true</code>
* .</p>
*
*@param id Description of the Parameter
*@return The property value
*@throws NoSingleSectionException if the {@link PropertySet} has more or
* less than one {@link Section}.
* @param id The property ID
* @return The property value
* @throws NoSingleSectionException if the {@link PropertySet} has
* more or less than one {@link Section}.
*/
protected Object getProperty(final int id)
throws NoSingleSectionException {
protected Object getProperty(final int id) throws NoSingleSectionException
{
return getSingleSection().getProperty(id);
}
/**
* <p>
* <p>Convenience method returning the value of a boolean property
* with the specified ID. If the property is not available,
* <code>false</code> is returned. A subsequent call to {@link
* #wasNull} will return <code>true</code> to let the caller
* distinguish that case from a real property value of
* <code>false</code>.</p>
*
* Convenience method returning the value of a boolean property with the
* specified ID. If the property is not available, <code>false</code> is
* returned. A subsequent call to {@link #wasNull} will return <code>true</code>
* to let the caller distinguish that case from a real property value of
* <code>false</code>.</p>
*
*@param id Description of the Parameter
*@return The propertyBooleanValue value
*@throws NoSingleSectionException if the {@link PropertySet} has more or
* less than one {@link Section}.
* @param id The property ID
* @return The property value
* @throws NoSingleSectionException if the {@link PropertySet} has
* more or less than one {@link Section}.
*/
protected boolean getPropertyBooleanValue(final int id)
throws NoSingleSectionException {
throws NoSingleSectionException
{
return getSingleSection().getPropertyBooleanValue(id);
}
/**
* <p>
* <p>Convenience method returning the value of the numeric
* property with the specified ID. If the property is not
* available, 0 is returned. A subsequent call to {@link #wasNull}
* will return <code>true</code> to let the caller distinguish
* that case from a real property value of 0.</p>
*
* Convenience method returning the value of the numeric property with the
* specified ID. If the property is not available, 0 is returned. A
* subsequent call to {@link #wasNull} will return <code>true</code> to let
* the caller distinguish that case from a real property value of 0.</p>
*
*@param id Description of the Parameter
*@return The propertyIntValue value
*@throws NoSingleSectionException if the {@link PropertySet} has more or
* less than one {@link Section}.
* @param id The property ID
* @return The propertyIntValue value
* @throws NoSingleSectionException if the {@link PropertySet} has
* more or less than one {@link Section}.
*/
protected int getPropertyIntValue(final int id)
throws NoSingleSectionException {
throws NoSingleSectionException
{
return getSingleSection().getPropertyIntValue(id);
}
/**
* <p>
* <p>Checks whether the property which the last call to {@link
* #getPropertyIntValue} or {@link #getProperty} tried to access
* was available or not. This information might be important for
* callers of {@link #getPropertyIntValue} since the latter
* returns 0 if the property does not exist. Using {@link
* #wasNull}, the caller can distiguish this case from a
* property's real value of 0.</p>
*
* Checks whether the property which the last call to {@link
* #getPropertyIntValue} or {@link #getProperty} tried to access was
* available or not. This information might be important for callers of
* {@link #getPropertyIntValue} since the latter returns 0 if the property
* does not exist. Using {@link #wasNull}, the caller can distiguish this
* case from a property's real value of 0.</p>
*
*@return <code>true</code> if the last call to
* {@link #getPropertyIntValue} or {@link #getProperty} tried to access
* a property that was not available, else <code>false</code>.
*@throws NoSingleSectionException if the {@link PropertySet} has more
* than one {@link Section}.
* @return <code>true</code> if the last call to {@link
* #getPropertyIntValue} or {@link #getProperty} tried to access a
* property that was not available, else <code>false</code>.
* @throws NoSingleSectionException if the {@link PropertySet} has
* more than one {@link Section}.
*/
public boolean wasNull() throws NoSingleSectionException {
public boolean wasNull() throws NoSingleSectionException
{
return getSingleSection().wasNull();
}
/**
* <p>
* <p>If the {@link PropertySet} has only a single section this
* method returns it.</p>
*
* If the {@link PropertySet} has only a single section this method returns
* it.</p>
*
*@return The singleSection value
*@throws NoSingleSectionException if the {@link PropertySet} has more or
* less than exactly one {@link Section}.
*@return The singleSection value
*@throws NoSingleSectionException if the {@link PropertySet} has
*more or less than exactly one {@link Section}.
*/
public Section getSingleSection() {
if (sectionCount != 1) {
throw new NoSingleSectionException
("Property set contains " + sectionCount + " sections.");
}
return ((Section) sections.get(0));
public Section getSingleSection()
{
if (sectionCount != 1)
throw new NoSingleSectionException
("Property set contains " + sectionCount + " sections.");
return ((Section) sections.get(0));
}
}

View File

@ -57,222 +57,133 @@ package org.apache.poi.hpsf.wellknown;
import java.util.*;
/**
* <p>
* <p>This is a dictionary which maps property ID values to property
* ID strings.</p>
*
* This is a dictionary mapping property IDs to property ID strings.</p> <p>
* <p>The methods {@link #getSummaryInformationProperties} and {@link
* #getDocumentSummaryInformationProperties} return singleton {@link
* PropertyIDMap}s. An application that wants to extend these maps
* should treat them as unmodifiable, copy them and modifiy the
* copies.</p>
*
* The methods {@link #getSummaryInformationProperties} and {@link
* #getDocumentSummaryInformationProperties} return singleton {@link
* PropertyIDMap}s. An application that wants to extend these maps should treat
* them as unmodifiable, copy them and modifiy the copies.</p> <p>
* <p><strong>FIXME:</strong> Make the singletons
* unmodifiable. However, since this requires to use a {@link HashMap}
* delegate instead of extending {@link HashMap} and thus requires a
* lot of stupid typing. I won't do that for the time being.</p>
*
* <strong>FIXME:</strong> Make the singletons unmodifiable. However, since
* this requires use a {@link HashMap} delegate instead of extending {@link
* HashMap} and would require a lot of stupid typing, I won't do it for the
* time being.</p>
*
*@author Rainer Klute (klute@rainer-klute.de)
*@created May 10, 2002
*@version $Id$
*@since 2002-02-09
* @author Rainer Klute (klute@rainer-klute.de)
* @version $Id$
* @since 2002-02-09
*/
public class PropertyIDMap extends HashMap {
public class PropertyIDMap extends HashMap
{
/*
* The following definitions are for the Summary Information.
*/
/**
* Description of the Field
* The following definitions are for the Summary Information.
*/
public final static int PID_TITLE = 2;
/**
* Description of the Field
*/
public final static int PID_SUBJECT = 3;
/**
* Description of the Field
*/
public final static int PID_AUTHOR = 4;
/**
* Description of the Field
*/
public final static int PID_KEYWORDS = 5;
/**
* Description of the Field
*/
public final static int PID_COMMENTS = 6;
/**
* Description of the Field
*/
public final static int PID_TEMPLATE = 7;
/**
* Description of the Field
*/
public final static int PID_LASTAUTHOR = 8;
/**
* Description of the Field
*/
public final static int PID_REVNUMBER = 9;
/**
* Description of the Field
*/
public final static int PID_EDITTIME = 10;
/**
* Description of the Field
*/
public final static int PID_LASTPRINTED = 11;
/**
* Description of the Field
*/
public final static int PID_CREATE_DTM = 12;
/**
* Description of the Field
*/
public final static int PID_LASTSAVE_DTM = 13;
/**
* Description of the Field
*/
public final static int PID_PAGECOUNT = 14;
/**
* Description of the Field
*/
public final static int PID_WORDCOUNT = 15;
/**
* Description of the Field
*/
public final static int PID_CHARCOUNT = 16;
/**
* Description of the Field
*/
public final static int PID_THUMBNAIL = 17;
/**
* Description of the Field
*/
public final static int PID_APPNAME = 18;
/**
* Description of the Field
*/
public final static int PID_SECURITY = 19;
/*
* The following definitions are for the Document Summary Information.
*/
/**
* Description of the Field
* The following definitions are for the Document Summary Information.
*/
public final static int PID_CATEGORY = 2;
/**
* Description of the Field
*/
public final static int PID_PRESFORMAT = 3;
/**
* Description of the Field
*/
public final static int PID_BYTECOUNT = 4;
/**
* Description of the Field
*/
public final static int PID_LINECOUNT = 5;
/**
* Description of the Field
*/
public final static int PID_PARCOUNT = 6;
/**
* Description of the Field
*/
public final static int PID_SLIDECOUNT = 7;
/**
* Description of the Field
*/
public final static int PID_NOTECOUNT = 8;
/**
* Description of the Field
*/
public final static int PID_HIDDENCOUNT = 9;
/**
* Description of the Field
*/
public final static int PID_MMCLIPCOUNT = 10;
/**
* Description of the Field
*/
public final static int PID_SCALE = 11;
/**
* Description of the Field
*/
public final static int PID_HEADINGPAIR = 12;
/**
* Description of the Field
*/
public final static int PID_DOCPARTS = 13;
/**
* Description of the Field
*/
public final static int PID_MANAGER = 14;
/**
* Description of the Field
*/
public final static int PID_COMPANY = 15;
/**
* Description of the Field
*/
public final static int PID_LINKSDIRTY = 16;
/**
* <p>Contains the summary information property ID values and
* associated strings. See the overall HPSF documentation for
* details!</p>
*/
private static PropertyIDMap summaryInformationProperties;
/**
* <p>Contains the summary information property ID values and
* associated strings. See the overall HPSF documentation for
* details!</p>
*/
private static PropertyIDMap documentSummaryInformationProperties;
/**
* Constructor for the PropertyIDMap object
*
*@param initialCapacity Description of the Parameter
*@param loadFactor Description of the Parameter
* <p>Creates a {@link PropertyIDMap}.</p>
*/
public PropertyIDMap(int initialCapacity, float loadFactor) {
public PropertyIDMap(int initialCapacity, float loadFactor)
{
super(initialCapacity, loadFactor);
}
/**
* <p>
* <p>Puts a ID string for an ID into the {@link
* PropertyIDMap}.</p>
*
* Puts a ID string for an ID into the {@link PropertyIDMap}.</p>
*
*@param id The ID.
*@param idString The ID string.
*@return Description of the Return Value
* @param id The ID.
* @param idString The ID string.
* @return As specified by the {@link Map} interface, this method
* returns the previous value associated with the specified
* <var>id</var>, or <code>null</code> if there was no mapping for
* key.
*/
public Object put(int id, String idString) {
public Object put(int id, String idString)
{
return put(new Integer(id), idString);
}
/**
* <p>
* <p>Gets the ID string for an ID from the {@link
* PropertyIDMap}.</p>
*
* Gets the ID string for an ID from the {@link PropertyIDMap}.</p>
*
*@param id The ID.
*@return Description of the Return Value
* @param id The ID.
* @return The ID string associated with <var>id</var>.
*/
public Object get(int id) {
public Object get(int id)
{
return get(new Integer(id));
}
/**
* <p>
*
* Returns the Summary Information properties singleton.</p>
*
*@return The summaryInformationProperties value
* <p>Returns the Summary Information properties singleton.</p>
*/
public static PropertyIDMap getSummaryInformationProperties() {
if (summaryInformationProperties == null) {
public static PropertyIDMap getSummaryInformationProperties()
{
if (summaryInformationProperties == null)
{
PropertyIDMap m = new PropertyIDMap(17, (float) 1.0);
m.put(PID_TITLE, "PID_TITLE");
m.put(PID_SUBJECT, "PID_SUBJECT");
@ -300,14 +211,15 @@ public class PropertyIDMap extends HashMap {
/**
* <p>
* <p>Returns the Document Summary Information properties
* singleton.</p>
*
* Returns the Summary Information properties singleton.</p>
*
*@return The documentSummaryInformationProperties value
* @return The Document Summary Information properties singleton.
*/
public static PropertyIDMap getDocumentSummaryInformationProperties() {
if (documentSummaryInformationProperties == null) {
public static PropertyIDMap getDocumentSummaryInformationProperties()
{
if (documentSummaryInformationProperties == null)
{
PropertyIDMap m = new PropertyIDMap(17, (float) 1.0);
m.put(PID_CATEGORY, "PID_CATEGORY");
m.put(PID_PRESFORMAT, "PID_PRESFORMAT");
@ -332,11 +244,10 @@ public class PropertyIDMap extends HashMap {
/**
* Description of the Method
*
*@param args Description of the Parameter
* <p>For the most basic testing.</p>
*/
public static void main(String args[]) {
public static void main(String args[])
{
PropertyIDMap s1 = getSummaryInformationProperties();
PropertyIDMap s2 = getDocumentSummaryInformationProperties();
System.out.println("s1: " + s1);