Writing support added to summary information and document summary information =============================================================================
I just checked in a major enhancement to POI's HPSF component. The
latter allows to read and write a document's properties, e.g. author,
title etc.
While it has been possible before to write properties, the programming
was rather complicated. The recent enhancement make things easy: The
classes SummaryInformation and DocumentSummaryInformation have been
amended by set and remove methods. For example, a document's author
cannot only be retrieved using the SummaryInformation.getAuthor(). Now
it is possible to change the author by
SummaryInformation.setAuthor(String). And you can remove the author by
SummaryInformation.removeAuthor().
Of course the documentation has been updated, too. However, the
documentation changes have not yet made it to the POI website. Andy or
Glen, could you please regenerate it? Thanks!
You can find a more detailed list of these and some other changes below.
And last not least I'd say thanks to the sponsor who funded this
development!
Best regards
Rainer Klute
Rainer Klute IT-Consulting GmbH
Dipl.-Inform.
Rainer Klute E-Mail: [EMAIL PROTECTED]
Körner Grund 24 Telefon: +49 172 2324824
D-44143 Dortmund Telefax: +49 231 5349423
Public key fingerprint: E4E4386515EE0BED5C162FBB5343461584B5A42E
List of HPSF changes:
---------------------
* Writing support added to the SummaryInformation and
DocumentSummaryInformation classes. These classes now have
methods for setting and removing properties. Coherent extensions
are:
* Documentation section about writing standard properties
added to the HPSF HOW-TO.
* Example application added showing how to modify the
document summary information.
* Testcases added for testing modifying summary
information and document summary information.
* PropertySetFactory extended to create SummaryInformation
and DocumentSummaryInformation instances.
* Added MutablePropertySet.write(DirectoryEntry, String) to ease
writing a property set to a POI filesystem document.
* Improved codepage handling.
* Bug fixed: Integral values were read and written as unsigned
instead of signed.
* Reworked the mapping between variant types and Java types:
Variant.VT_I4 is mapped to Integer now and Variant.VT_I8 to
Long. This might cause incompatibilities if you are doing
low-level HPSF programming.
* Changed SectionIDMap.DOCUMENT_SUMMARY_INFORMATION_ID from a
byte[] to a byte[][] in order to contain the format ID of the
first and the second section. This is an incompatible change!
* Added PropertySet.getFirstSection(). This method is similar to
getSingleSection() won't choke if the property set has more than
one section.
* Support for low-level reading and writing of Variant.VT_I8 type
properties added.
* Unnecessary casts removed.
* Poibrowser's display format changed slightly.
signature.asc
Description: This is a digitally signed message part
