|
| 1 | +// |
| 2 | +// Copyright (c) Microsoft. All rights reserved. |
| 3 | +// Licensed under the MIT license. See LICENSE file in the project root for full license information. |
| 4 | +// |
| 5 | + |
| 6 | +using System.Diagnostics; |
| 7 | + |
| 8 | +namespace Microsoft.SqlTools.BatchParser.Utility |
| 9 | +{ |
| 10 | + /// <summary> |
| 11 | + /// Provides a simple logging interface built on top of .Net tracing frameworks |
| 12 | + /// </summary> |
| 13 | + /// <remarks>This functionality is a simplified version of other similar implementations such as from Microsoft.SqlTools.Hosting, using |
| 14 | + /// just pure Trace calls instead of setting up a TraceSource and/or listeners to keep this as simple as possible.</remarks> |
| 15 | + public static class Logger |
| 16 | + { |
| 17 | + /// <summary> |
| 18 | + /// Writes a message to the log file with the Verbose event level |
| 19 | + /// </summary> |
| 20 | + /// <param name="logMessage">The message text to be written.</param> |
| 21 | + public static void Verbose(string logMessage) => Write(TraceEventType.Verbose, logMessage); |
| 22 | + |
| 23 | + /// <summary> |
| 24 | + /// Writes a message to the log file with the Information event level |
| 25 | + /// </summary> |
| 26 | + /// <param name="logMessage">The message text to be written.</param> |
| 27 | + public static void Information(string logMessage) => Write(TraceEventType.Information, logMessage); |
| 28 | + |
| 29 | + /// <summary> |
| 30 | + /// Writes a message to the log file with the Warning event level |
| 31 | + /// </summary> |
| 32 | + /// <param name="logMessage">The message text to be written.</param> |
| 33 | + public static void Warning(string logMessage) => Write(TraceEventType.Warning, logMessage); |
| 34 | + |
| 35 | + /// <summary> |
| 36 | + /// Writes a message to the log file with the Error event level |
| 37 | + /// </summary> |
| 38 | + /// <param name="logMessage">The message text to be written.</param> |
| 39 | + public static void Error(string logMessage) => Write(TraceEventType.Error, logMessage); |
| 40 | + |
| 41 | + /// <summary> |
| 42 | + /// Writes a message to the log file with the Critical event level |
| 43 | + /// </summary> |
| 44 | + /// <param name="logMessage">The message text to be written.</param> |
| 45 | + public static void Critical(string logMessage) => Write(TraceEventType.Critical, logMessage); |
| 46 | + |
| 47 | + /// <summary> |
| 48 | + /// Writes a message to the log file. |
| 49 | + /// </summary> |
| 50 | + /// <param name="eventType">The level at which the message will be written.</param> |
| 51 | + /// <param name="logEvent">The event id enumeration for the log event.</param> |
| 52 | + /// <param name="logMessage">The message text to be written.</param> |
| 53 | + public static void Write( |
| 54 | + TraceEventType eventType, |
| 55 | + string logMessage) |
| 56 | + { |
| 57 | + // Note that despite the more fine grained TraceEventType we expose in this class we currently are using just the default |
| 58 | + // Trace methods available which only allow Error/Warning/Information. An improvement would be to fully implement a TraceSource/EventSource |
| 59 | + // and use that instead, then ensure that users of this library are set up to consume events from that source. |
| 60 | + switch (eventType) |
| 61 | + { |
| 62 | + case TraceEventType.Critical: |
| 63 | + case TraceEventType.Error: |
| 64 | + if (eventType == TraceEventType.Critical) |
| 65 | + { |
| 66 | + logMessage = $@"event={eventType}: {logMessage}"; |
| 67 | + } |
| 68 | + |
| 69 | + Trace.TraceError(logMessage); |
| 70 | + break; |
| 71 | + case TraceEventType.Warning: |
| 72 | + Trace.TraceWarning(logMessage); |
| 73 | + break; |
| 74 | + case TraceEventType.Information: |
| 75 | + case TraceEventType.Resume: |
| 76 | + case TraceEventType.Start: |
| 77 | + case TraceEventType.Stop: |
| 78 | + case TraceEventType.Suspend: |
| 79 | + case TraceEventType.Transfer: |
| 80 | + case TraceEventType.Verbose: |
| 81 | + if (eventType != TraceEventType.Information) |
| 82 | + { |
| 83 | + logMessage = $@"event={eventType}: {logMessage}"; |
| 84 | + } |
| 85 | + |
| 86 | + Trace.TraceInformation(logMessage); |
| 87 | + break; |
| 88 | + } |
| 89 | + } |
| 90 | + } |
| 91 | +} |
0 commit comments