1 package org.apache.turbine.services.logging;
2
3 /* ====================================================================
4 * The Apache Software License, Version 1.1
5 *
6 * Copyright (c) 2001 The Apache Software Foundation. All rights
7 * reserved.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 *
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 *
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in
18 * the documentation and/or other materials provided with the
19 * distribution.
20 *
21 * 3. The end-user documentation included with the redistribution,
22 * if any, must include the following acknowledgment:
23 * "This product includes software developed by the
24 * Apache Software Foundation (http://www.apache.org/)."
25 * Alternately, this acknowledgment may appear in the software itself,
26 * if and wherever such third-party acknowledgments normally appear.
27 *
28 * 4. The names "Apache" and "Apache Software Foundation" and
29 * "Apache Turbine" must not be used to endorse or promote products
30 * derived from this software without prior written permission. For
31 * written permission, please contact apache@apache.org.
32 *
33 * 5. Products derived from this software may not be called "Apache",
34 * "Apache Turbine", nor may "Apache" appear in their name, without
35 * prior written permission of the Apache Software Foundation.
36 *
37 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
38 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
39 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
40 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
41 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
42 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
43 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
44 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
45 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
46 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
47 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
48 * SUCH DAMAGE.
49 * ====================================================================
50 *
51 * This software consists of voluntary contributions made by many
52 * individuals on behalf of the Apache Software Foundation. For more
53 * information on the Apache Software Foundation, please see
54 * <http://www.apache.org/>.
55 */
56
57 import org.apache.turbine.services.Service;
58 import org.apache.turbine.util.RunData;
59
60 /***
61 * A service that provides logging capabilities to Turbine.
62 * <p>
63 * This interface specifies the various possibilities of
64 * log message writing that are available to Turbine components
65 * and applications.
66 *
67 * @see org.apache.turbine.services.logging.Logger
68 * @author <a href="mailto:Tomasz.Zielinski@e-point.pl">Tomasz Zielinski</a>
69 * @author <a href="mailto:jon@latchkey.com">Jon S. Stevens</a>
70 * @version $Id: LoggingService.java,v 1.1.1.1 2001/08/16 05:09:04 jvanzyl Exp $
71 */
72 public interface LoggingService extends Service
73 {
74 /*** The name of the service */
75 public static final String SERVICE_NAME = "LoggingService";
76
77 /***
78 * This method returns default logger for Turbine System
79 */
80 public Logger getLogger();
81
82 /***
83 * This method returns logger with given name or default logger if
84 * the logger of specific name can't be found.
85 */
86 public Logger getLogger(String logName);
87
88 /***
89 * This method sets the log level in default logger
90 */
91 public void setLogLevel(int level);
92
93 /***
94 * This method sets the log level in the logger of given name
95 */
96 public void setLogLevel(String logName, int level);
97
98 /***
99 * This method sets format style of the default logger
100 */
101 public void setFormat(String format);
102
103 /***
104 * This method sets format style of the given logger.
105 */
106 public void setFormat(String logName, String format);
107
108
109 /***
110 * This is a log method with logLevel == DEBUG,printing is done by
111 * the default logger
112 */
113 public void debug(String message);
114
115 /***
116 * This is a log method with logLevel == DEBUG,printing is done by
117 * the default logger
118 */
119 public void debug(String message, Throwable t);
120
121 /***
122 * This is a log method with logLevel == DEBUG,printing is done by
123 * the given logger
124 */
125 public void debug(String logName, String message, Throwable t);
126
127 /***
128 * This is a log method with logLevel == DEBUG,printing is done by
129 * the given logger
130 */
131 public void debug(String logName, String message);
132
133 /***
134 * This is a log method with logLevel == DEBUG,printing is done by
135 * the default logger
136 */
137 public void debug(String message, RunData data);
138
139 /***
140 * This is a log method with logLevel == DEBUG,printing is done by
141 * the default logger
142 */
143 public void debug(String message, RunData data, Throwable t);
144
145 /***
146 * This is a log method with logLevel == DEBUG,printing is done by
147 * the given logger
148 */
149 public void debug(String logName, String message, RunData data,
150 Throwable t);
151
152 /***
153 * This is a log method with logLevel == DEBUG,printing is done by
154 * the given logger
155 */
156 public void debug(String logName, String message, RunData data);
157
158 /***
159 * This is a log method with logLevel == INFO,printing is done by
160 * the default logger
161 */
162 public void info(String message);
163
164 /***
165 * This is a log method with logLevel == INFO,printing is done by
166 * the default logger
167 */
168 public void info(String message, Throwable t);
169
170 /***
171 * This is a log method with logLevel == INFO,printing is done by
172 * the given logger
173 */
174 public void info(String logName, String message);
175
176 /***
177 * This is a log method with logLevel == INFO,printing is done by
178 * the given logger
179 */
180 public void info(String logName, String message, Throwable t);
181
182 /***
183 * This is a log method with logLevel == INFO,printing is done by
184 * the default logger
185 */
186 public void info(String message, RunData data);
187
188 /***
189 * This is a log method with logLevel == INFO,printing is done by
190 * the default logger
191 */
192 public void info(String message, RunData data, Throwable t);
193
194 /***
195 * This is a log method with logLevel == INFO,printing is done by
196 * the given logger
197 */
198 public void info(String logName, String message, RunData data);
199
200 /***
201 * This is a log method with logLevel == INFO,printing is done by
202 * the given logger
203 */
204 public void info(String logName, String message, RunData data, Throwable t);
205
206 /***
207 * This is a log method with logLevel == WARN,printing is done by
208 * the default logger
209 */
210 public void warn(String message);
211
212 /***
213 * This is a log method with logLevel == WARN,printing is done by
214 * the default logger
215 */
216 public void warn(String message, Throwable t);
217
218 /***
219 * This is a log method with logLevel == WARN,printing is done by
220 * the given logger
221 */
222 public void warn(String logName, String message);
223
224 /***
225 * This is a log method with logLevel == WARN,printing is done by
226 * the given logger
227 */
228 public void warn(String logName, String message, Throwable t);
229
230 /***
231 * This is a log method with logLevel == WARN,printing is done by
232 * the default logger
233 */
234 public void warn(String message, RunData data);
235
236 /***
237 * This is a log method with logLevel == WARN,printing is done by
238 * the default logger
239 */
240 public void warn(String message, RunData data, Throwable t);
241
242 /***
243 * This is a log method with logLevel == WARN,printing is done by
244 * the given logger
245 */
246 public void warn(String logName, String message, RunData data);
247
248 /***
249 * This is a log method with logLevel == WARN,printing is done by
250 * the given logger
251 */
252 public void warn(String logName, String message, RunData data, Throwable t);
253
254 /***
255 * This is a log method with logLevel == ERROR,printing is done by
256 * the default logger
257 */
258 public void error(String message);
259
260 /***
261 * This is a log method with logLevel == ERROR,printing is done by
262 * the default logger
263 */
264 public void error(String message, Throwable t);
265
266 /***
267 * This is a log method with logLevel == ERROR,printing is done by
268 * the given logger
269 */
270 public void error(String logName, String message);
271
272 /***
273 * This is a log method with logLevel == ERROR,printing is done by
274 * the given logger
275 */
276 public void error(String logName, String message, Throwable t);
277
278 /***
279 * This is a log method with logLevel == ERROR,printing is done by
280 * the default logger
281 */
282 public void error(String message, RunData data);
283
284 /***
285 * This is a log method with logLevel == ERROR,printing is done by
286 * the default logger
287 */
288 public void error(String message, RunData data, Throwable t);
289
290 /***
291 * This is a log method with logLevel == ERROR,printing is done by
292 * the given logger
293 */
294 public void error(String logName, String message, RunData data);
295
296 /***
297 * This is a log method with logLevel == ERROR,printing is done by
298 * the given logger
299 */
300 public void error(String logName, String message, RunData data,
301 Throwable t);
302 }
This page was automatically generated by Maven