You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by ni...@apache.org on 2002/03/06 17:58:50 UTC
cvs commit: xml-cocoon2/src/java/org/apache/cocoon/serialization ElementProcessorSerializer.java HSSFSerializer.java HSSFSerializer.xconf POIFSSerializer.java
nicolaken 02/03/06 08:58:50
Added: src/java/org/apache/cocoon/serialization
ElementProcessorSerializer.java HSSFSerializer.java
HSSFSerializer.xconf POIFSSerializer.java
Log:
Jakarta POI elementprocessor component, HSSF Serializer and samples. Original code by Marc Johnson (mjohnson at apache dot org) and Andrew C. Oliver (acoliver at apache dot org).
Revision Changes Path
1.1 xml-cocoon2/src/java/org/apache/cocoon/serialization/ElementProcessorSerializer.java
Index: ElementProcessorSerializer.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 1999-2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
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.
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.
4. The names "Apache Cocoon" 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.
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.
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 (INCLU-
DING, 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.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation and was originally created by
Stefano Mazzocchi <st...@apache.org>. For more information on the Apache
Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.cocoon.serialization;
import org.apache.cocoon.serialization.Serializer;
import org.apache.avalon.framework.component.Component;
import org.apache.avalon.framework.component.ComponentException;
import org.apache.avalon.framework.component.Composable;
import org.apache.avalon.framework.component.ComponentManager;
import org.apache.cocoon.components.elementprocessor.CannotCreateElementProcessorException;
import org.apache.cocoon.components.elementprocessor.*;
import org.apache.cocoon.components.elementprocessor.types.*;
import org.apache.avalon.framework.logger.AbstractLoggable;
import org.xml.sax.Attributes;
import org.xml.sax.Locator;
import org.xml.sax.SAXException;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Stack;
/**
* An implementation of nearly all of the methods included in the
* org.apache.poi.serialization.Serializer interface
*
* This is an abstract class. Concrete extensions need to implement
* the following methods:
* <ul>
* <li>String getMimeType()</li>
* <li>void endDocument()</li>
* <li>ElementProcessorFactory getElementProcessorFactory()</li>
* <li>void doPreInitialization(ElementProcessor processor)</li>
* </ul>
*
* @author Marc Johnson (marc_johnson27591@hotmail.com)
* @author Nicola Ken Barozzi (nicolaken@apache.org)
*/
public abstract class ElementProcessorSerializer
extends AbstractLoggable implements Serializer, Composable
{
private static final boolean _should_set_content_length = false;
private OutputStream _output_stream;
private Stack _open_elements;
private Locator _locator;
/** Component Manager */
protected ComponentManager manager = null;
/**
* Constructor
*/
public ElementProcessorSerializer()
{
_output_stream = null;
_open_elements = new Stack();
_locator = null;
}
public void compose(ComponentManager manager) {
this.manager = manager;
}
/**
* get the appropriate ElementProcessorFactory
*
* @return an ElementProcessorFactory suitable for the file type
*/
protected abstract ElementProcessorFactory getElementProcessorFactory();
/**
* perform whatever pre-initialization seems good on the
* ElementProcessor
*
* @param processor the processor to be initialized
*
* @exception SAXException on errors
*/
protected abstract void doPreInitialization(ElementProcessor processor)
throws SAXException;
/**
* @return the output stream
*/
protected OutputStream getOutputStream()
{
return _output_stream;
}
/**
* Create a new SAXException
*
* @param message the exception message
* @param e the underlying exception (may be null)
*
* @return new SAXException
*/
protected SAXException SAXExceptionFactory(final String message,
final Exception e)
{
StringBuffer message_buffer = new StringBuffer();
message_buffer.append((message == null) ? ""
: message);
if (_locator != null)
{
message_buffer.append("; System id: \"");
message_buffer.append(_locator.getSystemId());
message_buffer.append("\"; public id: \"");
message_buffer.append(_locator.getPublicId());
message_buffer.append("\"; line number: ");
message_buffer.append(_locator.getLineNumber());
message_buffer.append("; column number: ");
message_buffer.append(_locator.getColumnNumber());
}
SAXException rval = null;
if (e != null)
{
rval = new SAXException(message_buffer.toString(), e);
}
else
{
rval = new SAXException(message_buffer.toString());
}
return rval;
}
/**
* Create a SAXException
*
* @param message the exception message
*
* @return new SAXException
*/
protected SAXException SAXExceptionFactory(final String message)
{
return SAXExceptionFactory(message, null);
}
private ElementProcessor getCurrentElementProcessor()
{
return _open_elements.empty() ? null
: ( ElementProcessor ) _open_elements
.peek();
}
private char [] cleanupArray(final char [] array, final int start,
final int length)
{
char[] output = new char[ length ];
System.arraycopy(array, start, output, 0, length);
return output;
}
/* ********** START implementation of SitemapOutputComponent ********** */
/**
* Set the OutputStream where the requested resource should be
* serialized.
*
* @param out the OutputStream to which the serialized data will
* be written
*/
public void setOutputStream(final OutputStream out)
{
_output_stream = out;
}
/**
* Test if the component wants to set the content length.
*
* @return false
*/
public boolean shouldSetContentLength()
{
return _should_set_content_length;
}
/* ********** END implementation of SitemapOutputComponent ********** */
/* ********** START implementation of LexicalHandler ********** */
/**
* Report an XML comment anywhere in the document. We don't really
* care.
*
* @param ignored_ch
* @param ignored_start
* @param ignored_length
*/
public void comment(final char [] ignored_ch, final int ignored_start,
final int ignored_length)
{
}
/**
* Report the end of a CDATA section. We don't really care.
*/
public void endCDATA()
{
}
/**
* Report the end of DTD declarations. We don't really care.
*/
public void endDTD()
{
}
/**
* Report the end of an entity. We don't really care.
*
* @param ignored_name
*/
public void endEntity(final String ignored_name)
{
}
/**
* Report the start of a CDATA section. We don't really care.
*/
public void startCDATA()
{
}
/**
* Report the start of DTD declarations, if any. We don't really
* care.
*
* @param ignored_name
* @param ignored_publicId
* @param ignored_systemId
*/
public void startDTD(final String ignored_name,
final String ignored_publicId,
final String ignored_systemId)
{
}
/**
* Report the beginning of some internal and external XML
* entities. We don't really care.
*
* @param ignored_name
*/
public void startEntity(final String ignored_name)
{
}
/* ********** END implementation of LexicalHandler ********** */
/* ********** START implementation of ContentHandler ********** */
/**
* Receive notification of character data.
*
* @param ch the character array
* @param start the start index in ch
* @param length the length of the valid part of ch
*
* @exception SAXException if anything goes wrong in processing
* the character data
*/
public void characters(final char [] ch, final int start,
final int length)
throws SAXException
{
try
{
getCurrentElementProcessor().acceptCharacters(cleanupArray(ch,
start, length));
}
catch (Exception e)
{
throw SAXExceptionFactory("could not process characters event",
e);
}
}
/**
* Receive notification of the end of an element.
*
* @param ignored_namespaceURI
* @param ignored_localName
* @param ignored_qName
*
* @exception SAXException on any errors processing the event.
*/
public void endElement(final String ignored_namespaceURI,
final String ignored_localName,
final String ignored_qName)
throws SAXException
{
try
{
getCurrentElementProcessor().endProcessing();
_open_elements.pop();
}
catch (Exception e)
{
throw SAXExceptionFactory("could not process endElement event",
e);
}
}
/**
* End the scope of a prefix-URI mapping. We don't really care.
*
* @param ignored_prefix
*/
public void endPrefixMapping(final String ignored_prefix)
{
}
/**
* Receive notification of ignorable whitespace in element
* content.
*
* @param ch the character array
* @param start the start index in ch
* @param length the length of the valid part of ch
*
* @exception SAXException if anything goes wrong in processing
* the character data
*/
public void ignorableWhitespace(final char [] ch, final int start,
final int length)
throws SAXException
{
try
{
getCurrentElementProcessor()
.acceptWhitespaceCharacters(cleanupArray(ch, start, length));
}
catch (Exception e)
{
throw SAXExceptionFactory(
"could not process ignorableWhitespace event", e);
}
}
/**
* Receive notification of a processing instruction. We don't
* really care.
*
* @param ignored_target
* @param ignored_data
*/
public void processingInstruction(final String ignored_target,
final String ignored_data)
{
}
/**
* Receive an object for locating the origin of SAX document
* events.
*
* @param locator the Locator object
*/
public void setDocumentLocator(final Locator locator)
{
_locator = locator;
}
/**
* Receive notification of a skipped entity. We don't really care.
*
* @param ignored_name
*/
public void skippedEntity(final String ignored_name)
{
}
/**
* Receive notification of the beginning of a document.
*/
public void startDocument()
{
// nothing to do; should be ready as soon as we were
// constructed
}
/**
* Receive notification of the beginning of an element.
*
* @param namespaceURI the namespace this element is in
* @param localName the local name of the element
* @param qName the qualified name of the element
* @param atts the Attributes, if any, of the element
*
* @exception SAXException if we cannot create an ElementProcessor
* to handle the element
*/
public void startElement(final String namespaceURI,
final String localName, final String qName,
final Attributes atts)
throws SAXException
{
String name = "";
if ((localName != null) && (localName.length() != 0))
{
name = localName;
}
else if ((qName != null) && (qName.length() != 0))
{
name = qName;
}
ElementProcessor processor;
try
{
processor =
getElementProcessorFactory().createElementProcessor(name);
}
catch (CannotCreateElementProcessorException e)
{
throw SAXExceptionFactory("could not process startElement event",
e);
}
doPreInitialization(processor);
Attribute[] attributes = (atts == null) ? new Attribute[ 0 ]
: new Attribute[ atts.getLength() ];
for (int j = 0; j < attributes.length; j++)
{
attributes[ j ] = new Attribute(atts.getQName(j),
atts.getValue(j));
}
try
{
processor.initialize(attributes, getCurrentElementProcessor());
}
catch (IOException e)
{
throw SAXExceptionFactory("Exception processing startElement", e);
}
_open_elements.push(processor);
}
/**
* Begin the scope of a prefix-URI Namespace mapping. We don't
* really care.
*
* @param ignored_prefix
* @param ignored_uri
*/
public void startPrefixMapping(final String ignored_prefix,
final String ignored_uri)
{
}
/* ********** END implementation of ContentHandler ********** */
} // end public abstract class ElementProcessorSerializer
1.1 xml-cocoon2/src/java/org/apache/cocoon/serialization/HSSFSerializer.java
Index: HSSFSerializer.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 1999-2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
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.
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.
4. The names "Apache Cocoon" 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.
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.
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 (INCLU-
DING, 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.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation and was originally created by
Stefano Mazzocchi <st...@apache.org>. For more information on the Apache
Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.cocoon.serialization;
import org.apache.avalon.framework.activity.Initializable;
import org.apache.avalon.framework.component.ComponentSelector;
import org.apache.cocoon.components.elementprocessor.ElementProcessor;
import org.apache.cocoon.components.elementprocessor.ElementProcessorFactory;
import org.apache.cocoon.components.elementprocessor.impl.poi.hssf.HSSFElementProcessorFactory;
/**
* Serializer to produce an HSSF stream.
*
*@author Marc Johnson (marc_johnson27591@hotmail.com)
*@author Nicola Ken Barozzi (nicolaken@apache.org)
*@created 26 febbraio 2002
*/
public class HSSFSerializer
extends POIFSSerializer implements Initializable
{
private ElementProcessorFactory _element_processor_factory;
private final static String _mime_type = "vnd.ms-excel";
/**
* Constructor
*/
public HSSFSerializer() {
super();
}
/**
* Initialialize the component. Initialization includes
* allocating any resources required throughout the
* components lifecycle.
*
* @exception Exception if an error occurs
*/
public void initialize() throws Exception{
_element_processor_factory =
(ElementProcessorFactory)manager.lookup("org.apache.cocoon.components.elementprocessor.impl.poi.hssf.HSSFElementProcessorFactory");
}
/**
* get the mime type
*
*@return vnd.ms-excel
*/
public String getMimeType() {
return _mime_type;
}
/**
* get the ElementProcessorFactory
*
*@return the ElementProcessorFactory
*/
protected ElementProcessorFactory getElementProcessorFactory() {
return _element_processor_factory;
}
/**
* post-processing for endDocument
*/
protected void doLocalPostEndDocument() { }
/**
* pre-processing for endDocument
*/
protected void doLocalPreEndDocument() { }
}
1.1 xml-cocoon2/src/java/org/apache/cocoon/serialization/HSSFSerializer.xconf
Index: HSSFSerializer.xconf
===================================================================
<component
role="org.apache.cocoon.components.elementprocessor.impl.poi.hssf.HSSFElementProcessorFactory"
class="org.apache.cocoon.components.elementprocessor.impl.poi.hssf.HSSFElementProcessorFactory">
</component>
1.1 xml-cocoon2/src/java/org/apache/cocoon/serialization/POIFSSerializer.java
Index: POIFSSerializer.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 1999-2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
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.
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.
4. The names "Apache Cocoon" 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.
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.
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 (INCLU-
DING, 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.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation and was originally created by
Stefano Mazzocchi <st...@apache.org>. For more information on the Apache
Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.cocoon.serialization;
import java.io.IOException;
import java.io.OutputStream;
import org.apache.cocoon.components.elementprocessor.ElementProcessor;
import org.apache.cocoon.components.elementprocessor.CannotCreateElementProcessorException;
import org.apache.poi.poifs.filesystem.POIFSFileSystem;
import org.apache.cocoon.components.elementprocessor.impl.poi.POIFSElementProcessor;
import org.xml.sax.SAXException;
/**
* An extension of ElementProcessorSerializer with extensions for dealing with
* the POIFS filesystem This is an abstract class. Concrete extensions need to
* implement the following methods:
* <ul>
* <li> String getMimeType()</li>
* <li> void doLocalPreEndDocument()</li>
* <li> void doLocalPostEndDocument()</li>
* <li> ElementProcessorFactory getElementProcessorFactory()</li>
* </li>
* </ul>
*
*
*@author Marc Johnson (marc_johnson27591@hotmail.com)
*@author Nicola Ken Barozzi (nicolaken@apache.org)
*@created 26 febbraio 2002
*/
public abstract class POIFSSerializer
extends ElementProcessorSerializer
{
private POIFSFileSystem _filesystem;
/**
* Constructor
*/
public POIFSSerializer() {
super();
_filesystem = new POIFSFileSystem();
}
/*
* ********** START implementation of ContentHandler **********
*/
/**
* Receive notification of the end of a document.
*
*@exception SAXException if there is an error writing the document to the
* output stream
*/
public void endDocument()
throws SAXException {
doLocalPreEndDocument();
OutputStream stream = getOutputStream();
if ( stream != null ) {
try {
_filesystem.writeFilesystem( stream );
}
catch ( IOException e ) {
throw SAXExceptionFactory(
"could not process endDocument event", e );
}
}
else {
throw SAXExceptionFactory(
"no outputstream for writing the document!!" );
}
doLocalPostEndDocument();
}
/**
* Provide access to the filesystem for extending classes
*
*@return the filesystem
*/
protected POIFSFileSystem getFilesystem() {
return _filesystem;
}
/**
* Extending classes should do whatever they need to do prior to writing the
* filesystem out
*/
protected abstract void doLocalPreEndDocument();
/**
* Extending classes should do whatever they need to do after writing the
* filesystem out
*/
protected abstract void doLocalPostEndDocument();
/**
* perform pre-initialization on an element processor
*
*@param processor the element processor to be iniitialized
*@exception SAXException on errors
*/
protected void doPreInitialization( ElementProcessor processor )
throws SAXException {
try {
( ( POIFSElementProcessor ) processor ).setFilesystem( _filesystem );
}
catch ( ClassCastException e ) {
throw SAXExceptionFactory( "could not pre-initialize processor",
e );
}
}
/*
* ********** END implementation of ContentHandler **********
*/
}
// end public abstract class POIFSSerializer
----------------------------------------------------------------------
In case of troubles, e-mail: webmaster@xml.apache.org
To unsubscribe, e-mail: cocoon-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: cocoon-cvs-help@xml.apache.org