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.
|
|
|
|
==================================================================== */
|
|
|
|
|
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;
|
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;
|
|
|
|
|
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
|
|
|
*
|
2003-08-30 05:13:53 -04:00
|
|
|
* @author Rainer Klute <a
|
|
|
|
* href="mailto:klute@rainer-klute.de"><klute@rainer-klute.de></a>
|
2003-02-01 08:28:28 -05:00
|
|
|
* @version $Id$
|
|
|
|
* @since 2002-02-09
|
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
|
|
|
{
|
2008-08-12 14:44:50 -04:00
|
|
|
/**
|
|
|
|
* The id to name mapping of the properties
|
|
|
|
* in this set.
|
|
|
|
*/
|
|
|
|
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>
|
|
|
|
*/
|
2006-03-03 11:57:55 -05:00
|
|
|
private 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
|
|
|
|
*/
|
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
|
|
|
|
*/
|
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
|
|
|
*/
|
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
|
|
|
|
*/
|
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
|
|
|
*/
|
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
|
|
|
|
*/
|
2003-02-01 08:28:28 -05:00
|
|
|
public List getSections()
|
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getSections();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* @see PropertySet#isSummaryInformation
|
|
|
|
*/
|
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
|
|
|
|
*/
|
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
|
|
|
|
*/
|
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)
|
|
|
|
*/
|
|
|
|
public void addSection(final Section section)
|
|
|
|
{
|
|
|
|
delegate.addSection(section);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#clearSections()
|
|
|
|
*/
|
|
|
|
public void clearSections()
|
|
|
|
{
|
|
|
|
delegate.clearSections();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setByteOrder(int)
|
|
|
|
*/
|
|
|
|
public void setByteOrder(final int byteOrder)
|
|
|
|
{
|
|
|
|
delegate.setByteOrder(byteOrder);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setClassID(org.apache.poi.hpsf.ClassID)
|
|
|
|
*/
|
|
|
|
public void setClassID(final ClassID classID)
|
|
|
|
{
|
|
|
|
delegate.setClassID(classID);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setFormat(int)
|
|
|
|
*/
|
|
|
|
public void setFormat(final int format)
|
|
|
|
{
|
|
|
|
delegate.setFormat(format);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#setOSVersion(int)
|
|
|
|
*/
|
|
|
|
public void setOSVersion(final int osVersion)
|
|
|
|
{
|
|
|
|
delegate.setOSVersion(osVersion);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.MutablePropertySet#toInputStream()
|
|
|
|
*/
|
|
|
|
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)
|
|
|
|
*/
|
|
|
|
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)
|
|
|
|
*/
|
|
|
|
public void write(final OutputStream out) throws WritingNotSupportedException, IOException
|
|
|
|
{
|
|
|
|
delegate.write(out);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#equals(java.lang.Object)
|
|
|
|
*/
|
|
|
|
public boolean equals(final Object o)
|
|
|
|
{
|
|
|
|
return delegate.equals(o);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getProperties()
|
|
|
|
*/
|
|
|
|
public Property[] getProperties() throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getProperties();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getProperty(int)
|
|
|
|
*/
|
|
|
|
protected Object getProperty(final int id) throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getProperty(id);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getPropertyBooleanValue(int)
|
|
|
|
*/
|
|
|
|
protected boolean getPropertyBooleanValue(final int id) throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getPropertyBooleanValue(id);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#getPropertyIntValue(int)
|
|
|
|
*/
|
|
|
|
protected int getPropertyIntValue(final int id) throws NoSingleSectionException
|
|
|
|
{
|
|
|
|
return delegate.getPropertyIntValue(id);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#hashCode()
|
|
|
|
*/
|
|
|
|
public int hashCode()
|
|
|
|
{
|
|
|
|
return delegate.hashCode();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#toString()
|
|
|
|
*/
|
|
|
|
public String toString()
|
|
|
|
{
|
|
|
|
return delegate.toString();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @see org.apache.poi.hpsf.PropertySet#wasNull()
|
|
|
|
*/
|
|
|
|
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
|
|
|
}
|
|
|
|
|
|
|
|
}
|