org.springframework.batch.item.xml
Class StaxEventItemWriter<T>

java.lang.Object
  org.springframework.batch.item.util.ExecutionContextUserSupport
      org.springframework.batch.item.xml.StaxEventItemWriter<T>

All Implemented Interfaces:

ResourceAwareItemWriterItemStream<T>, ItemStream, ItemWriter<T>, org.springframework.beans.factory.InitializingBean

public class StaxEventItemWriter<T>
extends ExecutionContextUserSupport
implements ResourceAwareItemWriterItemStream<T>, org.springframework.beans.factory.InitializingBean

An implementation of ItemWriter which uses StAX and Marshaller for serializing object to XML. This item writer also provides restart, statistics and transaction features by implementing corresponding interfaces. The implementation is *not* thread-safe.

Author:

Peter Zozom, Robert Kasanicky

Constructor Summary

StaxEventItemWriter()

Method Summary

void	afterPropertiesSet()
void	close() Flush and close the output source.
protected void	endDocument(javax.xml.stream.XMLEventWriter writer) Writes the EndDocument tag manually.
java.lang.String	getEncoding() Get used encoding.
java.util.Map<java.lang.String,java.lang.String>	getRootElementAttributes() Get attributes of the root element.
java.lang.String	getRootTagName() Get the tag name of the root element.
java.lang.String	getRootTagNamespace() Get the namespace of the root element.
java.lang.String	getRootTagNamespacePrefix() Get the namespace prefix of the root element.
java.lang.String	getVersion() Get XML version.
void	open(ExecutionContext executionContext) Open the output source
void	setEncoding(java.lang.String encoding) Set encoding to be used for output file.
void	setFooterCallback(StaxWriterCallback footerCallback) footerCallback is called after writing all items but before closing the file
void	setHeaderCallback(StaxWriterCallback headerCallback) headerCallback is called before writing any items.
void	setMarshaller(org.springframework.oxm.Marshaller marshaller) Set Object to XML marshaller.
void	setOverwriteOutput(boolean overwriteOutput) Set "overwrite" flag for the output file.
void	setResource(org.springframework.core.io.Resource resource) Set output file.
void	setRootElementAttributes(java.util.Map<java.lang.String,java.lang.String> rootElementAttributes) Set the root element attributes to be written.
void	setRootTagName(java.lang.String rootTagName) Set the tag name of the root element.
void	setSaveState(boolean saveState)
void	setTransactional(boolean transactional) Flag to indicate that writes should be deferred to the end of a transaction if present.
void	setVersion(java.lang.String version) Set XML version to be used for output XML.
protected void	startDocument(javax.xml.stream.XMLEventWriter writer) Writes simple XML header containing: xml declaration - defines encoding and XML version opening tag of the root element and its attributes If this is not sufficient for you, simply override this method.
void	update(ExecutionContext executionContext) Get the restart data.
void	write(java.util.List<? extends T> items) Write the value objects and flush them to the file.

Methods inherited from class org.springframework.batch.item.util.ExecutionContextUserSupport

getKey, getName, setName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StaxEventItemWriter

public StaxEventItemWriter()

Method Detail

setResource

public void setResource(org.springframework.core.io.Resource resource)

Set output file.

Specified by:

setResource in interface ResourceAwareItemWriterItemStream<T>

Parameters:

resource - the output file

setMarshaller

public void setMarshaller(org.springframework.oxm.Marshaller marshaller)

Set Object to XML marshaller.

Parameters:

marshaller - the Object to XML marshaller

setHeaderCallback

public void setHeaderCallback(StaxWriterCallback headerCallback)

headerCallback is called before writing any items.

setFooterCallback

public void setFooterCallback(StaxWriterCallback footerCallback)

footerCallback is called after writing all items but before closing the file

setTransactional

public void setTransactional(boolean transactional)

Flag to indicate that writes should be deferred to the end of a transaction if present. Defaults to true.

Parameters:

transactional - the flag to set

getEncoding

public java.lang.String getEncoding()

Get used encoding.

Returns:

the encoding used

setEncoding

public void setEncoding(java.lang.String encoding)

Set encoding to be used for output file.

Parameters:

encoding - the encoding to be used

getVersion

public java.lang.String getVersion()

Get XML version.

Returns:

the XML version used

setVersion

public void setVersion(java.lang.String version)

Set XML version to be used for output XML.

Parameters:

version - the XML version to be used

getRootTagName

public java.lang.String getRootTagName()

Get the tag name of the root element.

Returns:

the root element tag name

setRootTagName

public void setRootTagName(java.lang.String rootTagName)

Set the tag name of the root element. If not set, default name is used ("root"). Namespace URI and prefix can also be set optionally using the notation:

 {uri}prefix:root
 

The prefix is optional (defaults to empty), but if it is specified then the uri must be provided. In addition you might want to declare other namespaces using the root attributes.

Parameters:

rootTagName - the tag name to be used for the root element

getRootTagNamespacePrefix

public java.lang.String getRootTagNamespacePrefix()

Get the namespace prefix of the root element. Empty by default.

Returns:

the rootTagNamespacePrefix

getRootTagNamespace

public java.lang.String getRootTagNamespace()

Get the namespace of the root element.

Returns:

the rootTagNamespace

getRootElementAttributes

public java.util.Map<java.lang.String,java.lang.String> getRootElementAttributes()

Get attributes of the root element.

Returns:

attributes of the root element

setRootElementAttributes

public void setRootElementAttributes(java.util.Map<java.lang.String,java.lang.String> rootElementAttributes)

Set the root element attributes to be written. If any of the key names begin with "xmlns:" then they are treated as namespace declarations.

Parameters:

rootElementAttributes - attributes of the root element

setOverwriteOutput

public void setOverwriteOutput(boolean overwriteOutput)

Set "overwrite" flag for the output file. Flag is ignored when output file processing is restarted.

Parameters:

overwriteOutput -

setSaveState

public void setSaveState(boolean saveState)

afterPropertiesSet

public void afterPropertiesSet()
                        throws java.lang.Exception

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

java.lang.Exception

See Also:

InitializingBean.afterPropertiesSet()

open

public void open(ExecutionContext executionContext)

Open the output source

Specified by:

open in interface ItemStream

See Also:

ItemStream.open(ExecutionContext)

startDocument

protected void startDocument(javax.xml.stream.XMLEventWriter writer)
                      throws javax.xml.stream.XMLStreamException

Writes simple XML header containing:

• xml declaration - defines encoding and XML version
• opening tag of the root element and its attributes

If this is not sufficient for you, simply override this method. Encoding, version and root tag name can be retrieved with corresponding getters.

Parameters:

writer - XML event writer

Throws:

javax.xml.stream.XMLStreamException

endDocument

protected void endDocument(javax.xml.stream.XMLEventWriter writer)
                    throws javax.xml.stream.XMLStreamException

Writes the EndDocument tag manually.

Parameters:

writer - XML event writer

Throws:

javax.xml.stream.XMLStreamException

close

public void close()

Flush and close the output source.

Specified by:

close in interface ItemStream

See Also:

ItemStream.close()

write

public void write(java.util.List<? extends T> items)
           throws org.springframework.oxm.XmlMappingException,
                  java.lang.Exception

Write the value objects and flush them to the file.

Specified by:

write in interface ItemWriter<T>

Parameters:

items - the value object

Throws:

java.io.IOException

org.springframework.oxm.XmlMappingException

java.lang.Exception - if there are errors. The framework will catch the exception and convert or rethrow it as appropriate.

update

public void update(ExecutionContext executionContext)

Get the restart data.

Specified by:

update in interface ItemStream

Parameters:

executionContext - to be updated

See Also:

ItemStream.update(ExecutionContext)