implab/ImplabNet Commit - r195:ea485487a424

minor changes

cin -

r195:ea485487a424 v2

parent child

Context file:

r195:ea485487a424

Collapse all files

Implab/Diagnostics/OperationContext.cs +3 -3

                             else if (m_ownership)
                                 m_current = LogicalOperation.EMPTY;
                             else {
-                                TraceLog.TraceWarning("DetachLogicalOperation can't be applied in the current context");
+                                TraceLog.TraceWarning("DetachLogicalOperation can't be performed in the current context");
                                 detached = LogicalOperation.EMPTY;
                             }
                         } else {
-                            TraceLog.TraceWarning("DetachLogicalOperation can't be applied in the current context");
+                            TraceLog.TraceWarning("DetachLogicalOperation can't be performed in the current context");
                         }
                         return detached;
                                 m_ownership = false;
                             }
                         } else {
-                            TraceLog.TraceWarning("EndLogicalOperation can't be applied in the current context");
+                            TraceLog.TraceWarning("EndLogicalOperation can't be performed in the current context");
                         }
                         return current;
                     }

Implab/Diagnostics/TraceContext.cs +2 -3

                         StartLogicalOperation(String.Empty);
                     }
-                    public void EndLogicalOperation() {
+                    public LogicalOperation EndLogicalOperation() {
-                        var op = m_current.EndLogicalOperation();
+                        return m_current.EndLogicalOperation();
-                        LogChannel<TraceEvent>.Default.LogEvent(new TraceEvent(TraceEventType.OperationCompleted, String.Format("-{0} : {1}ms",op.Name, op.Duration)));
                     }
                     public LogicalOperation DetachLogicalOperation() {

Implab/Diagnostics/TraceEvent.cs +22 -4

@@ -12,18 +12,36 namespace Implab.Diagnostics {
12	private set;	12	private set;
13	}	13	}
14		14
15	public TraceEvent(TraceEventType type, string message) {	15	/// <summary>
		16	/// The logical operation this event belongs to.
		17	/// </summary>
		18	public LogicalOperation Operation {
		19	get;
		20	private set;
		21	}
		22
		23	/// <summary>
		24	/// Gets the time offset in milliseconds from the start of the operation, if the operation is not specified the value is zero.
		25	/// </summary>
		26	public int OperationTime {
		27	get;
		28	private set;
		29	}
		30
		31	public TraceEvent(LogicalOperation operation, TraceEventType type, string message) {
16	EventType = type;	32	EventType = type;
17	Message = message;	33	Message = message;
		34	Operation = operation;
		35	if (operation != null)
		36	OperationTime = operation.Duration;
18	}	37	}
19		38
20	public override string ToString() {	39	public override string ToString() {
21	/return EventType == TraceEventType.Information ? Message : String.Format("{0}: {1}", EventType, Message);/
22	return Message;	40	return Message;
23	}	41	}
24		42
25	public static TraceEvent Create(TraceEventType type, string format, params object[] args) {	43	public static TraceEvent Create(LogicalOperation operation, TraceEventType type, string format, params object[] args) {
26	return new TraceEvent(type, format == null ? String.Empty : String.Format(format, args));	44	return new TraceEvent(operation, type, format == null ? String.Empty : String.Format(format, args));
27	}	45	}
28	}	46	}
29	}	47	}

Implab/Diagnostics/TraceLog.cs +24 -4

             namespace Implab.Diagnostics {
                 /// <summary>
-                /// Класс для публикации событий выполнения программы, события публикуются через <see cref="LogChannel{TraceEvent}"/>.
+                /// This class is used to trace a logical flow of the application, it publishes events to the default <see cref="TraceEvent"/> channel.
-                /// Журнал трассировки отражает логический ход выполнения программы и существует всегда, поскольку тесно связан с
-                /// контекстом трассировки.
                 /// </summary>
                 public static class TraceLog {
+                    /// <summary>
+                    /// Starts the logical operation nested to the current operation nested to the current one.
+                    /// </summary>
                     [Conditional("TRACE")]
                     public static void StartLogicalOperation() {
                         TraceContext.Instance.StartLogicalOperation();
                     }
+                    /// <summary>
+                    /// Starts the logical operation with the specified name, this name is usefull in logs.
+                    /// </summary>
+                    /// <param name="name">Name.</param>
                     [Conditional("TRACE")]
                     public static void StartLogicalOperation(string name) {
                         TraceContext.Instance.StartLogicalOperation(name);
                     }
+                    /// <summary>
+                    /// Ends the logical operation and restores the previous one.
+                    /// </summary>
                     [Conditional("TRACE")]
                     public static void EndLogicalOperation() {
-                        TraceContext.Instance.EndLogicalOperation();
+                        var op = TraceContext.Instance.EndLogicalOperation();
+                        LogChannel<TraceEvent>.Default.LogEvent(new TraceEvent(TraceEventType.OperationCompleted, String.Format("-{0} : {1}ms",op.Name, op.Duration)));
                     }
+                    /// <summary>
+                    /// Writes an informational message.
+                    /// </summary>
+                    /// <param name="format">Format.</param>
+                    /// <param name="arguments">Arguments.</param>
                     [Conditional("TRACE")]
                     public static void TraceInformation(string format, params object[] arguments) {
                         LogChannel<TraceEvent>.Default.LogEvent(TraceEvent.Create(TraceEventType.Information, format, arguments));
                     }
+                    /// <summary>
+                    /// Writes a warning message.
+                    /// </summary>
+                    /// <param name="format">Format.</param>
+                    /// <param name="arguments">Arguments.</param>
                     [Conditional("TRACE")]
                     public static void TraceWarning(string format, params object[] arguments) {
                         LogChannel<TraceEvent>.Default.LogEvent(TraceEvent.Create(TraceEventType.Warning, format, arguments));

General Comments 3

sergey

|

Auto status change to "Under Review"

sergey

|

ok, latest stable version should be in default

Write
Preview

You need to be logged in to leave comments. Login now

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages