mirror of https://github.com/sipwise/jitsi.git
Moves PropertyChangeListener/Event from .configuration.event to .util because they're generic and of interest to other use cases.
Lyubomir Marinov
17 years ago
parent
4b85461e69
commit
a376ea4cde
@ -1,107 +0,0 @@
|
||||
/*
|
||||
* SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
|
||||
*
|
||||
* Distributable under LGPL license.
|
||||
* See terms of license at gnu.org.
|
||||
*/
|
||||
package net.java.sip.communicator.service.configuration.event;
|
||||
|
||||
|
||||
|
||||
/**
|
||||
* A "ConfigurationChange" event gets delivered whenever a someone changes a
|
||||
* configuration property. A ConfigurationEvent object is sent as an
|
||||
* argument to the ConfigurationChangeListener methods.
|
||||
* <P>
|
||||
* Normally ConfigurationChangeEvents are accompanied by the name and the old
|
||||
* and new values of the changed property. If the new value is a primitive
|
||||
* type (such as int or boolean) it must be wrapped as the
|
||||
* corresponding java.lang.* Object type (such as Integer or Boolean).
|
||||
* <P>
|
||||
* Null values may be provided for the old and the new values if their
|
||||
* true values are not known.
|
||||
* <P>
|
||||
* An event source may send a null object as the name to indicate that an
|
||||
* arbitrary set of if its properties have changed. In this case the
|
||||
* old and new values should also be null.
|
||||
* <P>
|
||||
* In the case where the event reflects the change of a constrained property,
|
||||
* it will first be dispatched to all propertyWillChange methods and only in
|
||||
* case that none of them has objected (no ChangeVetoException has been thrown)
|
||||
* the propertyChange method is called.
|
||||
*
|
||||
* @author Emil Ivov
|
||||
*/
|
||||
public class PropertyChangeEvent
|
||||
extends java.util.EventObject
|
||||
{
|
||||
|
||||
/**
|
||||
* name of the property that changed. May be null, if not known.
|
||||
* @serial
|
||||
*/
|
||||
private String propertyName;
|
||||
|
||||
/**
|
||||
* New value for property. May be null if not known.
|
||||
* @serial
|
||||
*/
|
||||
private Object newValue;
|
||||
|
||||
/**
|
||||
* Previous value for property. May be null if not known.
|
||||
* @serial
|
||||
*/
|
||||
private Object oldValue;
|
||||
|
||||
/**
|
||||
* Constructs a new <tt>PropertyChangeEvent</tt>.
|
||||
*
|
||||
* @param source The bean that fired the event.
|
||||
* @param propertyName The programmatic name of the property
|
||||
* that was changed.
|
||||
* @param oldValue The old value of the property.
|
||||
* @param newValue The new value of the property.
|
||||
*/
|
||||
public PropertyChangeEvent(Object source, String propertyName,
|
||||
Object oldValue, Object newValue)
|
||||
{
|
||||
super(source);
|
||||
this.propertyName = propertyName;
|
||||
this.newValue = newValue;
|
||||
this.oldValue = oldValue;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the programmatic name of the property that was changed.
|
||||
*
|
||||
* @return The programmatic name of the property that was changed.
|
||||
* May be null if multiple properties have changed.
|
||||
*/
|
||||
public String getPropertyName()
|
||||
{
|
||||
return propertyName;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the new value for the property, expressed as an Object.
|
||||
*
|
||||
* @return The new value for the property, expressed as an Object.
|
||||
* May be null if multiple properties have changed.
|
||||
*/
|
||||
public Object getNewValue()
|
||||
{
|
||||
return newValue;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the old value for the property, expressed as an Object.
|
||||
*
|
||||
* @return The old value for the property, expressed as an Object.
|
||||
* May be null if multiple properties have changed.
|
||||
*/
|
||||
public Object getOldValue()
|
||||
{
|
||||
return oldValue;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,111 @@
|
||||
/*
|
||||
* SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
|
||||
*
|
||||
* Distributable under LGPL license.
|
||||
* See terms of license at gnu.org.
|
||||
*/
|
||||
package net.java.sip.communicator.util;
|
||||
|
||||
import java.util.*;
|
||||
|
||||
/**
|
||||
* A "ConfigurationChange" event gets delivered whenever a someone changes a
|
||||
* configuration property. A ConfigurationEvent object is sent as an argument to
|
||||
* the ConfigurationChangeListener methods.
|
||||
* <P>
|
||||
* Normally ConfigurationChangeEvents are accompanied by the name and the old
|
||||
* and new values of the changed property. If the new value is a primitive type
|
||||
* (such as int or boolean) it must be wrapped as the corresponding java.lang.*
|
||||
* Object type (such as Integer or Boolean).
|
||||
* <P>
|
||||
* Null values may be provided for the old and the new values if their true
|
||||
* values are not known.
|
||||
* <P>
|
||||
* An event source may send a null object as the name to indicate that an
|
||||
* arbitrary set of if its properties have changed. In this case the old and new
|
||||
* values should also be null.
|
||||
* <P>
|
||||
* In the case where the event reflects the change of a constrained property, it
|
||||
* will first be dispatched to all propertyWillChange methods and only in case
|
||||
* that none of them has objected (no ChangeVetoException has been thrown) the
|
||||
* propertyChange method is called.
|
||||
*
|
||||
* @author Emil Ivov
|
||||
*/
|
||||
public class PropertyChangeEvent
|
||||
extends EventObject
|
||||
{
|
||||
|
||||
/**
|
||||
* name of the property that changed. May be null, if not known.
|
||||
*
|
||||
* @serial
|
||||
*/
|
||||
private final String propertyName;
|
||||
|
||||
/**
|
||||
* New value for property. May be null if not known.
|
||||
*
|
||||
* @serial
|
||||
*/
|
||||
private final Object newValue;
|
||||
|
||||
/**
|
||||
* Previous value for property. May be null if not known.
|
||||
*
|
||||
* @serial
|
||||
*/
|
||||
private final Object oldValue;
|
||||
|
||||
/**
|
||||
* Constructs a new <tt>PropertyChangeEvent</tt>.
|
||||
*
|
||||
* @param source The bean that fired the event.
|
||||
* @param propertyName The programmatic name of the property that was
|
||||
* changed.
|
||||
* @param oldValue The old value of the property.
|
||||
* @param newValue The new value of the property.
|
||||
*/
|
||||
public PropertyChangeEvent(Object source, String propertyName,
|
||||
Object oldValue, Object newValue)
|
||||
{
|
||||
super(source);
|
||||
|
||||
this.propertyName = propertyName;
|
||||
this.newValue = newValue;
|
||||
this.oldValue = oldValue;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the programmatic name of the property that was changed.
|
||||
*
|
||||
* @return The programmatic name of the property that was changed. May be
|
||||
* null if multiple properties have changed.
|
||||
*/
|
||||
public String getPropertyName()
|
||||
{
|
||||
return propertyName;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the new value for the property, expressed as an Object.
|
||||
*
|
||||
* @return The new value for the property, expressed as an Object. May be
|
||||
* null if multiple properties have changed.
|
||||
*/
|
||||
public Object getNewValue()
|
||||
{
|
||||
return newValue;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the old value for the property, expressed as an Object.
|
||||
*
|
||||
* @return The old value for the property, expressed as an Object. May be
|
||||
* null if multiple properties have changed.
|
||||
*/
|
||||
public Object getOldValue()
|
||||
{
|
||||
return oldValue;
|
||||
}
|
||||
}
|
||||
Loading…
Reference in new issue