Package net.obvj.confectory.mapper

Class DocumentMapper

java.lang.Object

net.obvj.confectory.mapper.DocumentMapper

All Implemented Interfaces:

Mapper<Document>

public class DocumentMapper
extends Object
implements Mapper<Document>

A specialized Mapper that loads the contents of a valid XML Source (e.g.: file, URL) as a W3C Document.

This allows fetching the contents using XPath expressions.

NOTE: DOCTYPE declarations (either internal or external) are disabled for security reasons.

Since:

2.4.0

Author:

oswaldo.bapvic.jr (Oswaldo Junior)

Constructor Summary

Constructors

Constructor	Description
DocumentMapper()

Method Summary

Modifier and Type	Method	Description
Document	apply(InputStream inputStream)	Applies this Mapper into the given input.
ConfigurationHelper<Document>	configurationHelper(Document document)	Creates a new ConfigurationHelper instance recommended by this Mapper.

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentMapper

public DocumentMapper()

Method Detail

apply

public Document apply(InputStream inputStream)
               throws IOException

Description copied from interface: Mapper

Applies this Mapper into the given input.

Note: The input stream must be closed by the caller after the mapping operation.

Specified by:

apply in interface Mapper<Document>

Parameters:

inputStream - the input stream to be mapped

Returns:

the mapped object

Throws:

IOException - if a low-level I/O problem (such and unexpected end-of-input, or network error) occurs

configurationHelper

public ConfigurationHelper<Document> configurationHelper(Document document)

Description copied from interface: Mapper

Creates a new ConfigurationHelper instance recommended by this Mapper.

Specified by:

configurationHelper in interface Mapper<Document>

Parameters:

document - the configuration object to be used by the helper

Returns:

a new ConfigurationHelper instance