public class ObjectRecorder extends Thread
ObjectRecorder
takes records(inspections) of an objects
state using reflection and accessibility- framework.
It's strategy is to:
- try to set any field accessible. - try to get the value of the field. - if not succeed: try to invoke a bean- conform getter. - if NoSuchMethod, it's useless (no implementation of MagicClazz here).
Furthermore the ObjectRecorder
has a history - size (buffer) and
an adjustable distance between each inspection.
Modifier and Type | Class and Description |
---|---|
class |
ObjectRecorder.ObjectInspection
Data container for the inspection of the internal intance.
|
Thread.State, Thread.UncaughtExceptionHandler
Modifier and Type | Field and Description |
---|---|
protected IRingBuffer<ObjectRecorder.ObjectInspection> |
m_buffer
Fast buffer to store recorded fiels.
|
protected EventListenerList |
m_changeListeners
The listeners on this recorder.
|
protected Field[] |
m_fields
The fields to inspect on the instance.
|
protected long |
m_interval
The time - interval between to inspections of the Object.
|
protected Object |
m_toinspect
The instance to inspect.
|
protected static boolean |
VERBOSE
Verbosity constant.
|
MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY
Constructor and Description |
---|
ObjectRecorder(Object toinspect,
long interval)
Creates an instance that will inspect the given Object in the given time
interval.
|
Modifier and Type | Method and Description |
---|---|
void |
addChangeListener(ChangeListener x)
Adds a change listener that will be informed about new recordings of the
inspected instances.
|
boolean |
equals(Object obj) |
protected void |
fireChange()
Informs the listeners about a change of this instance.
|
TimeStampedValue[] |
getAttributeHistory(String attributeName)
The History returned by this Method represents the past of the field
specified by attributeName.
|
String[] |
getAttributeNames()
Returns the names of the fields to inspect.
|
Object |
getInspected()
Returns the inspected instance.
|
TimeStampedValue |
getLastValue(String fieldname)
Returns the last recorded value taken from the given field along with the
time stamp identifying the time this value was recored.
|
IRingBuffer<ObjectRecorder.ObjectInspection> |
getRingBuffer()
Returns the internal fifo buffer that stores the
ObjectRecorder.ObjectInspection instances that have been done. |
int |
hashCode() |
void |
inspect()
Makes a record of the state of the object specified in the constructor.
|
void |
removeChangeListener(ChangeListener x)
Removes the given listener for changes of the inpsected instance.
|
void |
run() |
void |
setHistoryLength(int length)
Define the amount of recorded states of the Object to inspect that remain
in memory.
|
void |
setInterval(long sleeptime)
Sets the interval for inpection of the instance to inspect in ms.
|
String |
toString() |
activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, yield
protected static final boolean VERBOSE
protected IRingBuffer<ObjectRecorder.ObjectInspection> m_buffer
protected EventListenerList m_changeListeners
protected Field[] m_fields
protected long m_interval
protected Object m_toinspect
public ObjectRecorder(Object toinspect, long interval)
toinspect
- the instance to inspect.interval
- the interval of inspection in ms.public void addChangeListener(ChangeListener x)
x
- the change listener that will be informed about new recordings of
the inspected instances.public boolean equals(Object obj)
equals
in class Object
Object.equals(java.lang.Object)
protected void fireChange()
public TimeStampedValue[] getAttributeHistory(String attributeName) throws NoSuchAttributeException
attributeName
- field name of the internal instance to inspect.NoSuchAttributeException
- if the attribute / field described by the given argument does not
exist on the internal Object to instpect.getInspected()
public String[] getAttributeNames()
public Object getInspected()
public TimeStampedValue getLastValue(String fieldname) throws NoSuchAttributeException
fieldname
- the field whose value was recorded.NoSuchAttributeException
- if no such field exists on the Object to inspect.public IRingBuffer<ObjectRecorder.ObjectInspection> getRingBuffer()
ObjectRecorder.ObjectInspection
instances that have been done.
ObjectRecorder.ObjectInspection
instances that have been
done.public int hashCode()
hashCode
in class Object
Object.hashCode()
public void inspect()
public void removeChangeListener(ChangeListener x)
x
- the listener to remove.public void run()
run
in interface Runnable
run
in class Thread
Runnable.run()
public void setHistoryLength(int length)
Default value is 100.
length
- the amount of recorded states of the Object to inspect that remain
in memory.public void setInterval(long sleeptime)
sleeptime
- the interval for inpection of the instance to inspect in ms.ObjectRecorder(Object, long)
public String toString()
toString
in class Thread
Object.toString()
Copyright © 2001 - 2010 LGPL, All Rights Footloose.