01: /* ----- BEGIN LICENSE BLOCK -----
02: * Version: MPL 1.1
03: *
04: * The contents of this file are subject to the Mozilla Public License Version
05: * 1.1 (the "License"); you may not use this file except in compliance with
06: * the License. You may obtain a copy of the License at
07: * http://www.mozilla.org/MPL/
08: *
09: * Software distributed under the License is distributed on an "AS IS" basis,
10: * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
11: * for the specific language governing rights and limitations under the
12: * License.
13: *
14: * The Original Code is the DataShare server.
15: *
16: * The Initial Developer of the Original Code is
17: * Ball Aerospace & Technologies Corp, Fairborn, Ohio
18: * Portions created by the Initial Developer are Copyright (C) 2001
19: * the Initial Developer. All Rights Reserved.
20: *
21: * Contributor(s): Charles Wood <cwood@ball.com>
22: *
23: * ----- END LICENSE BLOCK ----- */
24: /* RCS $Id: LoggingInterface.java,v 1.1 2002/01/29 20:55:28 lizellaman Exp $
25: * $Log: LoggingInterface.java,v $
26: * Revision 1.1 2002/01/29 20:55:28 lizellaman
27: * Added LoggingInterface, modified the PropertiesInterface implementation
28: *
29: *
30: */
31:
32: package org.datashare;
33:
34: import java.util.Hashtable;
35:
36: /**
37: * this interface is to be implemented by the class that provides the extended Logging of
38: * console messages that is needed by DataShare.
39: * @date January 25, 2002
40: * @author Charles Wood
41: * @version 1.0
42: */
43: public interface LoggingInterface {
44: /**
45: * if true, we will augment the ADSDebug settings and force our text to our
46: * console based on filter settings and categories selected.
47: */
48: //boolean override = false; // not implemented yet...
49:
50: // valid values for level:
51: final static int DEBUG = 1;
52: final static int WARNING = 2;
53: final static int ERROR = 3;
54: final static int FATALERROR = 4;
55:
56: final static String levelStrings[] = { "Unkown", "Debug",
57: "Warning", "Error", "FatalError" };
58:
59: // valid values for category:
60: final static int CLIENT = 1;
61: final static int SESSION = 2;
62: final static int DATABASE = 3;
63: final static int NETWORK = 4;
64: final static int GENERALSTATUS = 5;
65:
66: final static String categoryStrings[] = { "Unknown", "Client",
67: "Session", "Database", "Network", "GeneralStatus" };
68:
69: /**
70: * should be used to log/capture Exceptions
71: * @param level valid values are defined in this class and are as follows:
72: * "DEBUG", "WARNING", "ERROR", "FATALERROR"
73: */
74: void logException(int level, Exception e);
75:
76: /**
77: * this is the method that should be used for all console messages of DataShare
78: * so that filtering at runtime may be implemented.
79: * @param level valid values are defined in this class and are as follows:
80: * "DEBUG", "WARNING", "ERROR", "FATALERROR"
81: * @param category valid values are defined in this class and are as follows:
82: * "CLIENT", "SESSION", "DATABASE", "NETWORK"
83: */
84: void debugMsg(int level, int category, String msg);
85:
86: }
|