org.apache.poi.hpsf
Class PropertySetFactory

java.lang.Object
  org.apache.poi.hpsf.PropertySetFactory

public class PropertySetFactory
extends java.lang.Object

Factory class to create instances of SummaryInformation, DocumentSummaryInformation and PropertySet.

PropertySetFactory

public PropertySetFactory()

create

public static PropertySet create(DirectoryEntry dir,
                                 java.lang.String name)
                          throws java.io.FileNotFoundException,
                                 NoPropertySetStreamException,
                                 java.io.IOException,
                                 java.io.UnsupportedEncodingException

Creates the most specific PropertySet from an entry in the specified POIFS Directory. This is preferrably a DocumentSummaryInformation or a SummaryInformation. If the specified entry does not contain a property set stream, an exception is thrown. If no entry is found with the given name, an exception is thrown.

Parameters:

dir - The directory to find the PropertySet in

name - The name of the entry containing the PropertySet

Returns:

The created PropertySet.

Throws:

java.io.FileNotFoundException - if there is no entry with that name

NoPropertySetStreamException - if the stream does not contain a property set.

java.io.IOException - if some I/O problem occurs.

java.io.UnsupportedEncodingException - if the specified codepage is not supported.

create

public static PropertySet create(java.io.InputStream stream)
                          throws NoPropertySetStreamException,
                                 MarkUnsupportedException,
                                 java.io.UnsupportedEncodingException,
                                 java.io.IOException

Creates the most specific PropertySet from an InputStream. This is preferrably a DocumentSummaryInformation or a SummaryInformation. If the specified InputStream does not contain a property set stream, an exception is thrown and the InputStream is repositioned at its beginning.

Parameters:

stream - Contains the property set stream's data.

Returns:

The created PropertySet.

Throws:

NoPropertySetStreamException - if the stream does not contain a property set.

MarkUnsupportedException - if the stream does not support the mark operation.

java.io.IOException - if some I/O problem occurs.

java.io.UnsupportedEncodingException - if the specified codepage is not supported.

newSummaryInformation

public static SummaryInformation newSummaryInformation()

Creates a new summary information.

Returns:

the new summary information.

newDocumentSummaryInformation

public static DocumentSummaryInformation newDocumentSummaryInformation()

Creates a new document summary information.

Returns:

the new document summary information.