blob: c770e64e2781c62f6dc01887ec732026802745c0 (
plain)
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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
//-----------------------------------------------------------------------
// <copyright file="Logger.cs" company="Outercurve Foundation">
// Copyright (c) Outercurve Foundation. All rights reserved.
// </copyright>
//-----------------------------------------------------------------------
namespace DotNetOpenAuth {
using System;
using System.Globalization;
using DotNetOpenAuth.Logging;
using DotNetOpenAuth.Logging.LogProviders;
using DotNetOpenAuth.Messaging;
using Validation;
/// <summary>
/// A general logger for the entire DotNetOpenAuth library.
/// </summary>
/// <remarks>
/// Because this logger is intended for use with non-localized strings, the
/// overloads that take <see cref="CultureInfo"/> have been removed, and
/// <see cref="CultureInfo.InvariantCulture"/> is used implicitly.
/// </remarks>
internal static partial class Logger {
#region Category-specific loggers
/// <summary>
/// The <see cref="ILog"/> instance that is to be used
/// by this static Logger for the duration of the appdomain.
/// </summary>
private static readonly ILog library = CreateWithBanner("DotNetOpenAuth");
/// <summary>
/// Backing field for the <see cref="Yadis"/> property.
/// </summary>
private static readonly ILog yadis = Create("DotNetOpenAuth.Yadis");
/// <summary>
/// Backing field for the <see cref="Messaging"/> property.
/// </summary>
private static readonly ILog messaging = Create("DotNetOpenAuth.Messaging");
/// <summary>
/// Backing field for the <see cref="Channel"/> property.
/// </summary>
private static readonly ILog channel = Create("DotNetOpenAuth.Messaging.Channel");
/// <summary>
/// Backing field for the <see cref="Bindings"/> property.
/// </summary>
private static readonly ILog bindings = Create("DotNetOpenAuth.Messaging.Bindings");
/// <summary>
/// Backing field for the <see cref="Signatures"/> property.
/// </summary>
private static readonly ILog signatures = Create("DotNetOpenAuth.Messaging.Bindings.Signatures");
/// <summary>
/// Backing field for the <see cref="Http"/> property.
/// </summary>
private static readonly ILog http = Create("DotNetOpenAuth.Http");
/// <summary>
/// Backing field for the <see cref="Controls"/> property.
/// </summary>
private static readonly ILog controls = Create("DotNetOpenAuth.Controls");
/// <summary>
/// Backing field for the <see cref="OpenId"/> property.
/// </summary>
private static readonly ILog openId = Create("DotNetOpenAuth.OpenId");
/// <summary>
/// Backing field for the <see cref="OAuth"/> property.
/// </summary>
private static readonly ILog oauth = Create("DotNetOpenAuth.OAuth");
/// <summary>
/// Gets the logger for general library logging.
/// </summary>
internal static ILog Library { get { return library; } }
/// <summary>
/// Gets the logger for service discovery and selection events.
/// </summary>
internal static ILog Yadis { get { return yadis; } }
/// <summary>
/// Gets the logger for Messaging events.
/// </summary>
internal static ILog Messaging { get { return messaging; } }
/// <summary>
/// Gets the logger for Channel events.
/// </summary>
internal static ILog Channel { get { return channel; } }
/// <summary>
/// Gets the logger for binding elements and binding-element related events on the channel.
/// </summary>
internal static ILog Bindings { get { return bindings; } }
/// <summary>
/// Gets the logger specifically used for logging verbose text on everything about the signing process.
/// </summary>
internal static ILog Signatures { get { return signatures; } }
/// <summary>
/// Gets the logger for HTTP-level events.
/// </summary>
internal static ILog Http { get { return http; } }
/// <summary>
/// Gets the logger for events logged by ASP.NET controls.
/// </summary>
internal static ILog Controls { get { return controls; } }
/// <summary>
/// Gets the logger for high-level OpenID events.
/// </summary>
internal static ILog OpenId { get { return openId; } }
/// <summary>
/// Gets the logger for high-level OAuth events.
/// </summary>
internal static ILog OAuth { get { return oauth; } }
#endregion
/// <summary>
/// Creates an additional logger on demand for a subsection of the application.
/// </summary>
/// <param name="name">A name that will be included in the log file.</param>
/// <returns>The <see cref="ILog"/> instance created with the given name.</returns>
internal static ILog Create(string name) {
Requires.NotNullOrEmpty(name, "name");
return InitializeFacade(name);
}
/// <summary>
/// Creates the main logger for the library, and emits an INFO message
/// that is the name and version of the library.
/// </summary>
/// <param name="name">A name that will be included in the log file.</param>
/// <returns>The <see cref="ILog"/> instance created with the given name.</returns>
internal static ILog CreateWithBanner(string name) {
Requires.NotNullOrEmpty(name, "name");
ILog log = Create(name);
log.Info(Util.LibraryVersion);
return log;
}
/// <summary>
/// Creates an additional logger on demand for a subsection of the application.
/// </summary>
/// <param name="type">A type whose full name that will be included in the log file.</param>
/// <returns>The <see cref="ILog"/> instance created with the given type name.</returns>
internal static ILog Create(Type type) {
Requires.NotNull(type, "type");
return Create(type.FullName);
}
/// <summary>
/// Discovers the presence of Log4net.dll and other logging mechanisms
/// and returns the best available logger.
/// </summary>
/// <param name="name">The name of the log to initialize.</param>
/// <returns>The <see cref="ILog"/> instance of the logger to use.</returns>
private static ILog InitializeFacade(string name) {
return LogProvider.GetLogger(name);
}
}
}
|
