Package org.apache.log4j.receivers.xml

Class UtilLoggingXMLDecoder

java.lang.Object

org.apache.log4j.receivers.xml.UtilLoggingXMLDecoder

All Implemented Interfaces:

Decoder

public class UtilLoggingXMLDecoder
extends Object
implements Decoder

Decodes JDK 1.4's java.util.logging package events delivered via XML (using the logger.dtd).

Field Summary

Fields

Modifier and Type	Field	Description
private Map	additionalProperties	Additional properties.
private static final String	BEGIN_PART	Document prolog.
private DocumentBuilder	docBuilder	Document builder.
private static final String	ENCODING
private static final String	END_PART	Document close.
private Component	owner	Owner.
private String	partialEvent	Partial event.
private static final String	RECORD_END	Record end.

Constructor Summary

Constructors

Constructor	Description
UtilLoggingXMLDecoder()	Create new instance.
UtilLoggingXMLDecoder(Component o)	Create new instance.

Method Summary

Modifier and Type	Method	Description
org.apache.log4j.spi.LoggingEvent	decode(String data)	Converts the string data into an XML Document, and then soaks out the relevant bits to form a new LoggingEvent instance which can be used by any Log4j element locally.
Vector	decode(URL url)	Decodes a File into a Vector of LoggingEvents.
Vector	decodeEvents(String document)	Decodes a String representing a number of events into a Vector of LoggingEvents.
private Vector	decodeEvents(Document document)	Given a Document, converts the XML into a Vector of LoggingEvents.
private String	getCData(Node n)	Get contents of CDATASection.
private Document	parse(String data)	Converts the LoggingEvent data in XML string format into an actual XML Document class instance.
void	setAdditionalProperties(Map properties)	Sets an additionalProperty map, where each Key/Value pair is automatically added to each LoggingEvent as it is decoded.

Methods inherited from class java.lang.Object

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

Field Details

BEGIN_PART

private static final String BEGIN_PART

Document prolog.

See Also:

• Constant Field Values

END_PART

private static final String END_PART

Document close.

See Also:

• Constant Field Values

docBuilder

private DocumentBuilder docBuilder

Document builder.

additionalProperties

private Map additionalProperties

Additional properties.

partialEvent

private String partialEvent

Partial event.

RECORD_END

private static final String RECORD_END

Record end.

See Also:

• Constant Field Values

owner

private Component owner

Owner.

ENCODING

private static final String ENCODING

See Also:

• Constant Field Values

Constructor Details

UtilLoggingXMLDecoder

public UtilLoggingXMLDecoder(Component o)

Create new instance.

Parameters:

o - owner

UtilLoggingXMLDecoder

public UtilLoggingXMLDecoder()

Create new instance.

Method Details

setAdditionalProperties

public void setAdditionalProperties(Map properties)

Sets an additionalProperty map, where each Key/Value pair is automatically added to each LoggingEvent as it is decoded. This is useful, say, to include the source file name of the Logging events

Specified by:

setAdditionalProperties in interface Decoder

Parameters:

properties - additional properties

parse

private Document parse(String data)

Converts the LoggingEvent data in XML string format into an actual XML Document class instance.

Parameters:

data - XML fragment

Returns:

dom document

decode

public Vector decode(URL url)
              throws IOException

Decodes a File into a Vector of LoggingEvents.

Specified by:

decode in interface Decoder

Parameters:

url - the url of a file containing events to decode

Returns:

Vector of LoggingEvents

Throws:

IOException - if IO error during processing.

decodeEvents

public Vector decodeEvents(String document)

Decodes a String representing a number of events into a Vector of LoggingEvents.

Specified by:

decodeEvents in interface Decoder

Parameters:

document - to decode events from

Returns:

Vector of LoggingEvents

decode

public org.apache.log4j.spi.LoggingEvent decode(String data)

Converts the string data into an XML Document, and then soaks out the relevant bits to form a new LoggingEvent instance which can be used by any Log4j element locally.

Specified by:

decode in interface Decoder

Parameters:

data - XML fragment

Returns:

a single LoggingEvent or null

decodeEvents

private Vector decodeEvents(Document document)

Given a Document, converts the XML into a Vector of LoggingEvents.

Parameters:

document - XML document

Returns:

Vector of LoggingEvents

getCData

private String getCData(Node n)

Get contents of CDATASection.

Parameters:

n - CDATASection

Returns:

text content of all text or CDATA children of node.