com.topologi.diffx.event.impl
Class IgnorableSpaceEvent

java.lang.Object
  com.topologi.diffx.event.impl.IgnorableSpaceEvent

All Implemented Interfaces:

DiffXEvent, TextEvent, XMLFormattable, XMLWritable

public final class IgnorableSpaceEvent

extends Object

implements TextEvent

A particular type of event reserved for ignored white spaces.

This class can be used to ignore whitespaces for processing but preserve them for formatting. This event keeps the exact formatting of the white space henceby preserving it, but will consider any instances of this class to be equal regardless of their actual formatting so that the algorithm ignores the differences.

Version:

7 April 2005

Author:

Christophe Lauret (Allette Systems)

Constructor Summary

IgnorableSpaceEvent(CharSequence seq)
Creates a new ignorable white space event.

Method Summary

boolean	equals(DiffXEvent e) Returns true if the event is an ignorable white space, regardless of the characters that it matches.
String	getCharacters() Returns the characters that this event represents.
int	getWeight() Returns the weight of this event.
int	hashCode() Always return the same value.
void	setWeight(int weight) Ignored.
String	toString()
String	toXML() Returns a xml representation of the object of the implementing class.
StringBuffer	toXML(StringBuffer xml) Appends the XML representation of the object of the implementing class.
void	toXML(XMLWriter xml) Writes the XML representation of the implementing instance using the specified XMLWriter.

Methods inherited from class java.lang.Object

equals, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

IgnorableSpaceEvent

public IgnorableSpaceEvent(CharSequence seq)
                    throws NullPointerException

Creates a new ignorable white space event.

Parameters:

seq - The char sequence.

Throws:

NullPointerException - If the given String is null.

Method Detail

toString

public String toString()

See Also:

Object.toString()

hashCode

public int hashCode()

Always return the same value.

See Also:

Object.hashCode()

equals

public boolean equals(DiffXEvent e)

Returns true if the event is an ignorable white space, regardless of the characters that it matches.

Specified by:

equals in interface DiffXEvent

Parameters:

e - The event to compare with this event.

Returns:

true if considered equal; false otherwise.

getCharacters

public String getCharacters()

Returns the characters that this event represents.

Note: this method will return the characters as used by Java (ie. Unicode), they may not be suitable for writing to an XML string.

Specified by:

getCharacters in interface TextEvent

Returns:

The characters that this event represents.

toXML

public void toXML(XMLWriter xml)
           throws IOException

Description copied from interface: XMLWritable

Writes the XML representation of the implementing instance using the specified XMLWriter.

Specified by:

toXML in interface XMLWritable

Parameters:

xml - The XMLWriter to use.

Throws:

IOException - IF an I/O exception occurs whilst writing.

See Also:

XMLWritable.toXML(com.topologi.diffx.xml.XMLWriter)

toXML

public String toXML()

Description copied from interface: XMLFormattable

Returns a xml representation of the object of the implementing class.

Most implementation should use the following code to ensure consistent data with the other toXML method:

return this.toXML(new StringBuffer()).toString();

Specified by:

toXML in interface XMLFormattable

Returns:

a XML representation of the object of the implementing class.

See Also:

XMLFormattable.toXML()

toXML

public StringBuffer toXML(StringBuffer xml)
                   throws NullPointerException

Description copied from interface: XMLFormattable

Appends the XML representation of the object of the implementing class.

Implementations must ensure that the returned string buffer is the same object as the specified string buffer.

Specified by:

toXML in interface XMLFormattable

Parameters:

xml - The string buffer to which the XML representation is appended to.

Returns:

The modified string buffer.

Throws:

NullPointerException - if the specified character sequence is null.

See Also:

XMLWritable.toXML(com.topologi.diffx.xml.XMLWriter)

getWeight

public int getWeight()

Description copied from interface: DiffXEvent

Returns the weight of this event.

The default weight should be 1.

Specified by:

getWeight in interface DiffXEvent

Returns:

The weight of this event.

See Also:

DiffXEvent.getWeight()

setWeight

public void setWeight(int weight)

Ignored.

Specified by:

setWeight in interface DiffXEvent

Parameters:

weight - The weight of this event.

See Also:

DiffXEvent.setWeight(int)