2004-04-09 09:05:39 -04:00
|
|
|
/* ====================================================================
|
2006-12-22 14:18:16 -05:00
|
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
|
|
this work for additional information regarding copyright ownership.
|
|
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
|
|
(the "License"); you may not use this file except in compliance with
|
|
|
|
the License. You may obtain a copy of the License at
|
2004-04-09 09:05:39 -04:00
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
limitations under the License.
|
|
|
|
==================================================================== */
|
2009-06-01 17:07:20 -04:00
|
|
|
|
2002-02-13 23:00:59 -05:00
|
|
|
package org.apache.poi.hpsf;
|
|
|
|
|
2006-03-03 11:57:55 -05:00
|
|
|
import java.io.IOException;
|
|
|
|
import java.io.InputStream;
|
|
|
|
import java.io.OutputStream;
|
2015-09-01 17:46:30 -04:00
|
|
|
import java.nio.charset.Charset;
|
2003-08-02 15:02:28 -04:00
|
|
|
import java.util.List;
|
2002-02-13 23:00:59 -05:00
|
|
|
|
2008-08-12 14:44:50 -04:00
|
|
|
import org.apache.poi.hpsf.wellknown.PropertyIDMap;
|
2006-03-03 11:57:55 -05:00
|
|
|
import org.apache.poi.poifs.filesystem.DirectoryEntry;
|
2013-07-03 07:24:01 -04:00
|
|
|
import org.apache.poi.util.LittleEndian;
|
2006-03-03 11:57:55 -05:00
|
|
|
|
2002-02-13 23:00:59 -05:00
|
|
|
/**
|
2003-02-01 08:28:28 -05:00
|
|
|
* <p>Abstract superclass for the convenience classes {@link
|
|
|
|
* SummaryInformation} and {@link DocumentSummaryInformation}.</p>
|
2002-05-11 10:47:24 -04:00
|
|
|
*
|
2003-02-01 08:28:28 -05:00
|
|
|
* <p>The motivation behind this class is quite nasty if you look
|
|
|
|
* behind the scenes, but it serves the application programmer well by
|
|
|
|
* providing him with the easy-to-use {@link SummaryInformation} and
|
|
|
|
* {@link DocumentSummaryInformation} classes. When parsing the data a
|
|
|
|
* property set stream consists of (possibly coming from an {@link
|
|
|
|
* java.io.InputStream}) we want to read and process each byte only
|
|
|
|
* once. Since we don't know in advance which kind of property set we
|
|
|
|
* have, we can expect only the most general {@link
|
|
|
|
* PropertySet}. Creating a special subclass should be as easy as
|
|
|
|
* calling the special subclass' constructor and pass the general
|
|
|
|
* {@link PropertySet} in. To make things easy internally, the special
|
|
|
|
* class just holds a reference to the general {@link PropertySet} and
|
|
|
|
* delegates all method calls to it.</p>
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2003-02-01 08:28:28 -05:00
|
|
|
* <p>A cleaner implementation would have been like this: The {@link
|
|
|
|
* PropertySetFactory} parses the stream data into some internal
|
|
|
|
* object first. Then it finds out whether the stream is a {@link
|
|
|
|
* SummaryInformation}, a {@link DocumentSummaryInformation} or a
|
|
|
|
* general {@link PropertySet}. However, the current implementation
|
|
|
|
* went the other way round historically: the convenience classes came
|
|
|
|
* only late to my mind.</p>
|
2002-02-13 23:00:59 -05:00
|
|
|
*/
|
2006-03-03 11:57:55 -05:00
|
|
|
public abstract class SpecialPropertySet extends MutablePropertySet
|
2003-02-01 08:28:28 -05:00
|
|
|
{
|
2013-07-03 07:36:11 -04:00
|
|
|
/**
|
2016-07-03 14:25:05 -04:00
|
|
|
* The id to name mapping of the properties in this set.
|
|
|
|
*
|
|
|
|
* @return the id to name mapping of the properties in this set
|
2013-07-03 07:36:11 -04:00
|
|
|
*/
|
|
|
|
public abstract PropertyIDMap getPropertySetIDMap();
|
2002-02-13 23:00:59 -05:00
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* <p>The "real" property set <code>SpecialPropertySet</code>
|
|
|
|
* delegates to.</p>
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
private final MutablePropertySet delegate;
|
2002-02-13 23:00:59 -05:00
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* <p>Creates a <code>SpecialPropertySet</code>.
|
|
|
|
*
|
2006-03-03 11:57:55 -05:00
|
|
|
* @param ps The property set to be encapsulated by the
|
2003-08-02 15:02:28 -04:00
|
|
|
* <code>SpecialPropertySet</code>
|
|
|
|
*/
|
|
|
|
public SpecialPropertySet(final PropertySet ps)
|
2006-03-03 11:57:55 -05:00
|
|
|
{
|
|
|
|
delegate = new MutablePropertySet(ps);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* <p>Creates a <code>SpecialPropertySet</code>.
|
|
|
|
*
|
|
|
|
* @param ps The mutable property set to be encapsulated by the
|
|
|
|
* <code>SpecialPropertySet</code>
|
|
|
|
*/
|
|
|
|
public SpecialPropertySet(final MutablePropertySet ps)
|
2003-02-01 08:28:28 -05:00
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
delegate = ps;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#getByteOrder
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2003-02-01 08:28:28 -05:00
|
|
|
public int getByteOrder()
|
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getByteOrder();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#getFormat
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2003-02-01 08:28:28 -05:00
|
|
|
public int getFormat()
|
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getFormat();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#getOSVersion
|
2003-02-22 09:27:16 -05:00
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2003-08-02 15:02:28 -04:00
|
|
|
public int getOSVersion()
|
2003-02-01 08:28:28 -05:00
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getOSVersion();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#getClassID
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2003-02-01 08:28:28 -05:00
|
|
|
public ClassID getClassID()
|
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getClassID();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#getSectionCount
|
2003-02-22 09:27:16 -05:00
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2003-08-02 15:02:28 -04:00
|
|
|
public int getSectionCount()
|
2003-02-01 08:28:28 -05:00
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getSectionCount();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#getSections
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2013-07-03 07:24:01 -04:00
|
|
|
public List<Section> getSections()
|
2003-02-01 08:28:28 -05:00
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getSections();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#isSummaryInformation
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2003-02-01 08:28:28 -05:00
|
|
|
public boolean isSummaryInformation()
|
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.isSummaryInformation();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#isDocumentSummaryInformation
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2003-02-01 08:28:28 -05:00
|
|
|
public boolean isDocumentSummaryInformation()
|
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.isDocumentSummaryInformation();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#getSingleSection
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public Section getFirstSection()
|
|
|
|
{
|
|
|
|
return delegate.getFirstSection();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#addSection(org.apache.poi.hpsf.Section)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void addSection(final Section section)
|
|
|
|
{
|
|
|
|
delegate.addSection(section);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#clearSections()
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void clearSections()
|
|
|
|
{
|
|
|
|
delegate.clearSections();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setByteOrder(int)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void setByteOrder(final int byteOrder)
|
|
|
|
{
|
|
|
|
delegate.setByteOrder(byteOrder);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setClassID(org.apache.poi.hpsf.ClassID)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void setClassID(final ClassID classID)
|
|
|
|
{
|
|
|
|
delegate.setClassID(classID);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setFormat(int)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void setFormat(final int format)
|
|
|
|
{
|
|
|
|
delegate.setFormat(format);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setOSVersion(int)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void setOSVersion(final int osVersion)
|
|
|
|
{
|
|
|
|
delegate.setOSVersion(osVersion);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#toInputStream()
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public InputStream toInputStream() throws IOException, WritingNotSupportedException
|
|
|
|
{
|
|
|
|
return delegate.toInputStream();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#write(org.apache.poi.poifs.filesystem.DirectoryEntry, java.lang.String)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void write(final DirectoryEntry dir, final String name) throws WritingNotSupportedException, IOException
|
|
|
|
{
|
|
|
|
delegate.write(dir, name);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#write(java.io.OutputStream)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public void write(final OutputStream out) throws WritingNotSupportedException, IOException
|
|
|
|
{
|
|
|
|
delegate.write(out);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#equals(java.lang.Object)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public boolean equals(final Object o)
|
|
|
|
{
|
|
|
|
return delegate.equals(o);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getProperties()
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public Property[] getProperties() throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getProperties();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getProperty(int)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
protected Object getProperty(final int id) throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getProperty(id);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getPropertyBooleanValue(int)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
protected boolean getPropertyBooleanValue(final int id) throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getPropertyBooleanValue(id);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getPropertyIntValue(int)
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
protected int getPropertyIntValue(final int id) throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getPropertyIntValue(id);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2013-07-03 07:24:01 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Fetches the property with the given ID, then does its
|
|
|
|
* best to return it as a String
|
2016-07-03 14:25:05 -04:00
|
|
|
*
|
|
|
|
* @param propertyId the property id
|
|
|
|
*
|
2013-07-03 07:24:01 -04:00
|
|
|
* @return The property as a String, or null if unavailable
|
|
|
|
*/
|
|
|
|
protected String getPropertyStringValue(final int propertyId) {
|
2013-07-03 07:36:11 -04:00
|
|
|
Object propertyValue = getProperty(propertyId);
|
|
|
|
return getPropertyStringValue(propertyValue);
|
|
|
|
}
|
|
|
|
protected static String getPropertyStringValue(final Object propertyValue) {
|
2013-07-03 07:24:01 -04:00
|
|
|
// Normal cases
|
2013-07-03 07:36:11 -04:00
|
|
|
if (propertyValue == null) return null;
|
|
|
|
if (propertyValue instanceof String) return (String)propertyValue;
|
2013-07-03 07:24:01 -04:00
|
|
|
|
|
|
|
// Do our best with some edge cases
|
2013-07-03 07:36:11 -04:00
|
|
|
if (propertyValue instanceof byte[]) {
|
|
|
|
byte[] b = (byte[])propertyValue;
|
2013-07-03 07:24:01 -04:00
|
|
|
if (b.length == 0) {
|
|
|
|
return "";
|
|
|
|
}
|
|
|
|
if (b.length == 1) {
|
|
|
|
return Byte.toString(b[0]);
|
|
|
|
}
|
|
|
|
if (b.length == 2) {
|
|
|
|
return Integer.toString( LittleEndian.getUShort(b) );
|
|
|
|
}
|
|
|
|
if (b.length == 4) {
|
|
|
|
return Long.toString( LittleEndian.getUInt(b) );
|
|
|
|
}
|
|
|
|
// Maybe it's a string? who knows!
|
2015-09-01 17:46:30 -04:00
|
|
|
return new String(b, Charset.forName("ASCII"));
|
2013-07-03 07:24:01 -04:00
|
|
|
}
|
2013-07-03 07:36:11 -04:00
|
|
|
return propertyValue.toString();
|
2013-07-03 07:24:01 -04:00
|
|
|
}
|
|
|
|
|
2006-03-03 11:57:55 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#hashCode()
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public int hashCode()
|
|
|
|
{
|
|
|
|
return delegate.hashCode();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#toString()
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public String toString()
|
|
|
|
{
|
|
|
|
return delegate.toString();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#wasNull()
|
|
|
|
*/
|
2016-07-03 14:25:05 -04:00
|
|
|
@Override
|
2006-03-03 11:57:55 -05:00
|
|
|
public boolean wasNull() throws NoSingleSectionException
|
2003-02-01 08:28:28 -05:00
|
|
|
{
|
2006-03-03 11:57:55 -05:00
|
|
|
return delegate.wasNull();
|
2002-02-13 23:00:59 -05:00
|
|
|
}
|
|
|
|
|
|
|
|
}
|