Thursday, May 31, 2012

On Not Writting

For the past month I have struggled to finish what I've started. I think too much about what I'm trying to say and nothing comes out. Or my inner critic edits it before I can finish the bloody sentence. It can always be better.

It once was better: I start thinking about something, say on the way home from work, walking through Riverfront Park (doing laundry, driving to nowhere, etc). Regardless of what I was doing, it was brilliant. The kind of thing that changes the world. Everyone would recognize ME as the guru of whatever. So on and you know the rest… Then I get home, open up Word and… The phrases that sounded good in my head look terrible on the screen (if I can even remember them).

As the Improv Gods would say, I am in my head. I am thinking too much about things that are not important, at least not in the present moment. If I can get the words down, I can fix the style later. If I can't get the words down in the first place I have nothing. Ok, Mr. Critic it ain't perfect but it's on virtual paper.

Ok, I let Mr. Critic silence me. The only way I can grow is to put myself out there and risk being the fool. I can’t succeed if I don’t risk failure. This post, like the others, is a disappointment. It had so much promise when I was thinking it over in my mind. .. It may not meet my impossible, I'll post it anyway.

Saturday, May 12, 2012

Log4Net: Minimalist demo using config settings

The other day, it was decided at work that we will be using Log4Net, Apache’s logging tool for the .NET Framwork. It was left to me to investigate this tool. This post is the beginning of this investigation. For my first post, I present a minimal demo of Log4Net using Config settings. So here are the steps I’ve come up with using Microsoft C# Express 2010:

  1. Create a Console Application Project
  2. Make sure that Target Framework is .NET Framework 4, (select the project in Solution Explorer and press Alt+Enter, Look at Target Framework), the default is .NET Framework 4 Client Profile.
  3. Add a reference to log4net.dll
  4. Add the following attribute outside of any class or namespace (in my project I put it in Program.cs between the using and namespace statements, in a real project I would probably put it in AssemblyInfo.cs):
    [assembly: log4net.Config.XmlConfigurator]
    
    In this case XmlConfigurator tells the Framework to look in my application's .config file for configuration information.
  5. In app.config:

    <configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/> </configSections>

    This tells the framework about Log4Net’s custom configuration section below.

    <log4net> <appender name="MyAppender" type="log4net.Appender.FileAppender"> <file value="TestLog.txt"/> <layout type="log4net.Layout.SimpleLayout" /> </appender>


    log4net is the configuration section we described configSections above.


    This creates an appender; an appender is an object that is writes the logged data to somewhere. A FileAppender will write it to a text file. The name is used below to tell log4net to actually use this appender;


    The file element declares the name of the file. Here we will be logging to TestLog.txt in the same directory as the program.


    The layout tells log4net how to write the data. SimpleLayout is as simple as they get, In the real world, I’d use a more flexible layout. the PatternLayout is popular.

    <root>
    <appender-ref ref="MyAppender"/>
    </root>
    </log4net>

    Declaring an appender is good, but log4net won’t use it unless you tell it to.  The appender-ref element tells log4net to use my appender. You can specify as many appenders as you want.


  6. Create an instance of Log
    log4net.ILog log = log4net.LogManager.GetLogger("Some String");
    

  7. And Log away.
    log.Info("For Your Information");
    log.Warn("Danger Will Robinson");
    log.Debug("Debug Message");
    try
    {
    throw new Exception("Deliberate Exception");
    }
    catch (Exception ex)
    {
    log.Error(ex.Message, ex);
    }
    log.Fatal("Die. Die. Die!", new ApplicationException("Fatal Exception"));

    Running the code above, my log looks like this (note that there are not time stamps):

    INFO - For Your Information
    WARN - Danger Will Robinson
    DEBUG - Debug Message
    ERROR - Deliberate Exception
    System.Exception: Deliberate Exception
    at Log4NetConsole001.Program.Main(String[] args) in C:\Users\jack\documents\visual studio 2010\Projects\Log4NetConsole001\Log4NetConsole001\Program.cs:line 20
    FATAL - Die. Die. Die!
    System.ApplicationException: Fatal Exception
    
    


 

That is my minimalist implementation of Log4Net; it is probably too simple to be useful, but is is a start. If my ambition holds, I hope to expand on this.

Complete Sample

program.cs

using System;

[assembly: log4net.Config.XmlConfigurator]

namespace Log4NetConsole001
{
class Program
{
static void Main(string[] args)
{
log4net.ILog log = log4net.LogManager.GetLogger("Some String");
log.Info("For Your Information");
log.Warn("Danger Will Robinson");
log.Debug("Debug Message");
try
{
throw new Exception("Deliberate Exception");
}
catch (Exception ex)
{
log.Error(ex.Message, ex);
}
log.Fatal("Die. Die. Die!", new ApplicationException("Fatal Exception"));
Console.WriteLine("======================= End ========================");
Console.ReadKey();
}
}
}

app.config

<?xml version="1.0"?>
<configuration>
<configSections>
<section name="log4net" 
     type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
</configSections>

<log4net>
  <appender name="MyAppender" type="log4net.Appender.FileAppender">
<file value="TestLog.txt"/>
<layout type="log4net.Layout.SimpleLayout" />
  </appender>

<root>
<appender-ref ref="MyAppender"/>
</root>
</log4net>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
</startup>
</configuration>