com.topologi.diffx.event.impl
Class CloseElementEventNSImpl

java.lang.Object
  extended bycom.topologi.diffx.event.impl.DiffXEventBase
      extended bycom.topologi.diffx.event.impl.CloseElementEventNSImpl
All Implemented Interfaces:
CloseElementEvent, DiffXEvent, XMLFormattable, XMLWritable

public final class CloseElementEventNSImpl
extends com.topologi.diffx.event.impl.DiffXEventBase
implements CloseElementEvent

The event corresponding to the startElement SAX event.

Version:
3 April 2005
Author:
Christophe Lauret (Allette Systems)

Constructor Summary
CloseElementEventNSImpl(OpenElementEvent event)
          Creates a new close element event from the corresponding open element event.
CloseElementEventNSImpl(String name)
          Creates a new close element event with the default URI.
CloseElementEventNSImpl(String uri, String name)
          Creates a new close element event
 
Method Summary
 boolean equals(DiffXEvent e)
          Returns true if the event is a
 boolean equals(Object o)
          Invokes the DiffXEvent.equals(DiffXEvent) method if the specified object if not null and is an instance of DiffXEvent.
 String getName()
          Returns the local name of the element.
 OpenElementEvent getOpenElement()
          Returns the corresponding event element.
 String getURI()
          Returns the namespace URI the element belongs to.
 int getWeight()
          Returns the weight of this event.
 int hashCode()
           
 boolean match(OpenElementEvent event)
          Indicates whether the specified open element event matches this close element event.
 void setWeight(int weight)
          Sets the weight of this event.
 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
getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.topologi.diffx.event.DiffXEvent
getWeight, setWeight
 
Methods inherited from interface com.topologi.diffx.xml.XMLFormattable
toXML
 

Constructor Detail

CloseElementEventNSImpl

public CloseElementEventNSImpl(String name)
                        throws NullPointerException
Creates a new close element event with the default URI.

Parameters:
name - The local name of the element
Throws:
NullPointerException - If the name is null.
See Also:
Constants.DEFAULT_URI

CloseElementEventNSImpl

public CloseElementEventNSImpl(String uri,
                               String name)
                        throws NullPointerException
Creates a new close element event

Parameters:
uri - The namespace URI of the element
name - The local name of the element
Throws:
NullPointerException - if any of the argument is null.

CloseElementEventNSImpl

public CloseElementEventNSImpl(OpenElementEvent event)
                        throws NullPointerException
Creates a new close element event from the corresponding open element event.

Parameters:
event - The corresponding open element event.
Throws:
NullPointerException - If the name is null.
Method Detail

getName

public String getName()
Description copied from interface: CloseElementEvent
Returns the local name of the element.

Specified by:
getName in interface CloseElementEvent
Returns:
Returns the name.

getURI

public String getURI()
Description copied from interface: CloseElementEvent
Returns the namespace URI the element belongs to.

This method should return null if the implementation is not namespace aware.

Specified by:
getURI in interface CloseElementEvent
Returns:
Returns the uri.

getOpenElement

public OpenElementEvent getOpenElement()
Description copied from interface: CloseElementEvent
Returns the corresponding event element.

Specified by:
getOpenElement in interface CloseElementEvent
Returns:
The corresponding event element.
See Also:
CloseElementEvent.getOpenElement()

match

public boolean match(OpenElementEvent event)
Description copied from interface: CloseElementEvent
Indicates whether the specified open element event matches this close element event.

This method first checks whether the open element event is the same as event returned by the CloseElementEvent.getOpenElement() method, if not it simply compares the name of the element and the namespace URI it belongs to.

Specified by:
match in interface CloseElementEvent
Parameters:
event - The open element event to test.
Returns:
true if there is a match; false otherwise.
See Also:
CloseElementEvent.match(com.topologi.diffx.event.OpenElementEvent)

hashCode

public int hashCode()
See Also:
Object.hashCode()

equals

public boolean equals(DiffXEvent e)
Returns true if the event is a

Specified by:
equals in interface DiffXEvent
Parameters:
e - The event to compare with this event.
Returns:
true if this event is equal to the specified event; false otherwise.
See Also:
DiffXEvent.equals(DiffXEvent)

toString

public String toString()
See Also:
Object.toString()

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 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)

equals

public final boolean equals(Object o)
Invokes the DiffXEvent.equals(DiffXEvent) method if the specified object if not null and is an instance of DiffXEvent.

Parameters:
o - The object to compare.
Returns:
true if the specified object is equal; false otherwise.

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()

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)
Description copied from interface: DiffXEvent
Sets the weight of this event.

This method is intended for use by algorithms, optimisers and loaders in order to adjust the importance of an event.

Specified by:
setWeight in interface DiffXEvent
Parameters:
weight - The weight of this event.
See Also:
DiffXEvent.setWeight(int)