01: /*
02: *
03: *
04: * Copyright 1990-2007 Sun Microsystems, Inc. All Rights Reserved.
05: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
06: *
07: * This program is free software; you can redistribute it and/or
08: * modify it under the terms of the GNU General Public License version
09: * 2 only, as published by the Free Software Foundation.
10: *
11: * This program is distributed in the hope that it will be useful, but
12: * WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * General Public License version 2 for more details (a copy is
15: * included at /legal/license.txt).
16: *
17: * You should have received a copy of the GNU General Public License
18: * version 2 along with this work; if not, write to the Free Software
19: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20: * 02110-1301 USA
21: *
22: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
23: * Clara, CA 95054 or visit www.sun.com if you need additional
24: * information or have any questions.
25: */
26:
27: package com.sun.midp.util;
28:
29: import java.util.Hashtable;
30:
31: /**
32: * A simple tracing mechanism that's useful for i3 tests to get calls when a
33: * particular tracepoint is hit.
34: */
35: public class LiveTracer {
36: // Hashtable<String, LiveTraceListener>
37: Hashtable listeners = new Hashtable();
38:
39: /**
40: * Registers a listener for tracepoints identified by this tag. When a
41: * tracepoint is hit whose tag matches this one, the listener is called.
42: * Replaces any listener that might already exist for this tag.
43: */
44: public void add(String tag, LiveTraceListener l) {
45: listeners.put(tag, l);
46: }
47:
48: /**
49: * Unregisters the indicated listener from the tracer.
50: */
51: public void remove(String tag) {
52: listeners.remove(tag);
53: }
54:
55: /**
56: * Clears all listeners from the tracer.
57: */
58: public void clear() {
59: listeners.clear();
60: }
61:
62: /**
63: * Indicates a tracepoint identified by this tag. If there is a listener
64: * registered for this tag, the listener is called.
65: */
66: public void trace(String tag) {
67: LiveTraceListener l = (LiveTraceListener) listeners.get(tag);
68:
69: if (l != null) {
70: l.call(tag);
71: }
72: }
73: }
|