2002-05-11 10:47:24 -04:00
|
|
|
/*
|
|
|
|
* ====================================================================
|
|
|
|
* The Apache Software License, Version 1.1
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* Copyright (c) 2000 The Apache Software Foundation. All rights
|
|
|
|
* reserved.
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in
|
|
|
|
* the documentation and/or other materials provided with the
|
|
|
|
* distribution.
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* 3. The end-user documentation included with the redistribution,
|
|
|
|
* if any, must include the following acknowledgment:
|
|
|
|
* "This product includes software developed by the
|
|
|
|
* Apache Software Foundation (http://www.apache.org/)."
|
|
|
|
* Alternately, this acknowledgment may appear in the software itself,
|
|
|
|
* if and wherever such third-party acknowledgments normally appear.
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* 4. The names "Apache" and "Apache Software Foundation" must
|
|
|
|
* not be used to endorse or promote products derived from this
|
|
|
|
* software without prior written permission. For written
|
|
|
|
* permission, please contact apache@apache.org.
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* 5. Products derived from this software may not be called "Apache",
|
|
|
|
* nor may "Apache" appear in their name, without prior written
|
|
|
|
* permission of the Apache Software Foundation.
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
|
|
|
|
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
|
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
|
|
|
|
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
|
|
|
|
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
|
|
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
|
|
|
|
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
* SUCH DAMAGE.
|
|
|
|
* ====================================================================
|
2002-02-13 23:00:59 -05:00
|
|
|
*
|
2002-05-11 10:47:24 -04:00
|
|
|
* This software consists of voluntary contributions made by many
|
|
|
|
* individuals on behalf of the Apache Software Foundation. For more
|
|
|
|
* information on the Apache Software Foundation, please see
|
|
|
|
* <http://www.apache.org/>.
|
2002-02-13 23:00:59 -05:00
|
|
|
*/
|
|
|
|
package org.apache.poi.hpsf;
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
import java.util.List;
|
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
|
|
|
*/
|
2003-02-01 08:28:28 -05:00
|
|
|
public abstract class SpecialPropertySet extends PropertySet
|
|
|
|
{
|
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>
|
|
|
|
*/
|
2002-02-13 23:00:59 -05:00
|
|
|
private PropertySet delegate;
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-08-02 15:02:28 -04:00
|
|
|
/**
|
|
|
|
* <p>Creates a <code>SpecialPropertySet</code>.
|
|
|
|
*
|
|
|
|
* @param ps The property set encapsulated by the
|
|
|
|
* <code>SpecialPropertySet</code>
|
|
|
|
*/
|
|
|
|
public SpecialPropertySet(final PropertySet 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
|
|
|
|
*/
|
2003-02-01 08:28:28 -05:00
|
|
|
public Section getSingleSection()
|
|
|
|
{
|
2002-02-13 23:00:59 -05:00
|
|
|
return delegate.getSingleSection();
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|