-
Notifications
You must be signed in to change notification settings - Fork 18
/
Logger.java
134 lines (119 loc) · 3.38 KB
/
Logger.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
/*
* Copyright (c) 2022-2023, FusionAuth, All Rights Reserved
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
* either express or implied. See the License for the specific
* language governing permissions and limitations under the License.
*/
package io.fusionauth.http.log;
/**
* A simple logging interface used by the HTTP server/client instances. This removes any coupling between the HTTP server and specific
* logging frameworks like JUL or SLF4J. Mapping between this logger and other frameworks is simple though.
*
* @author Brian Pontarelli
*/
public interface Logger {
/**
* Logs a debug message.
*
* @param message The message.
*/
void debug(String message);
/**
* Logs a debug message with values.
*
* @param message The message.
* @param values The values for the message.
*/
void debug(String message, Object... values);
/**
* Logs a debug message and stack trace or exception message.
*
* @param message The message.
* @param throwable The exception for the stack trace or message.
*/
void debug(String message, Throwable throwable);
/**
* Logs an error message and stack trace or exception message.
*
* @param message The message.
* @param throwable The exception for the stack trace or message.
*/
void error(String message, Throwable throwable);
/**
* Logs an error message.
*
* @param message The message.
*/
void error(String message);
/**
* Logs an info message.
*
* @param message The message.
*/
void info(String message);
/**
* Logs an info message with values.
*
* @param message The message.
* @param values The values for the message.
*/
void info(String message, Object... values);
/**
* @return True if this Logger is enabled for the Debug level, false otherwise.
*/
boolean isDebugEnabled();
/**
* Returns whether this Logger is enabled for a given {@link Level}.
*
* @param level the level to check
* @return true if enabled, false otherwise.
*/
default boolean isEnabledForLevel(Level level) {
return switch (level) {
case Trace -> isTraceEnabled();
case Debug -> isDebugEnabled();
case Info -> isInfoEnabled();
case Error -> isErrorEnabled();
};
}
/**
* @return True if this Logger is enabled for the Error level, false otherwise.
*/
boolean isErrorEnabled();
/**
* @return True if this Logger is enabled for the Info level, false otherwise.
*/
boolean isInfoEnabled();
/**
* @return True if this Logger is enabled for the Trace level, false otherwise.
*/
boolean isTraceEnabled();
/**
* Sets the level of this logger (optional method).
*
* @param level The level.
*/
void setLevel(Level level);
/**
* Logs a trace message with values.
*
* @param message The message.
* @param values The values for the message.
*/
void trace(String message, Object... values);
/**
* Logs a trace message.
*
* @param message The message.
*/
void trace(String message);
}