Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles / Languages / XML

XMLFileWatcher

4.70/5 (18 votes)
7 Aug 2005CPOL2 min read 1   606  
A Windows service which monitors the directory changes, writes an entry in the event log about the change, notifies the change to the users by sending a mail, and also converts the input XML file into a DataSet.

Introduction

When I was reading the MSDN, I found an interesting topic on Windows services and FileSystemWatcher. So I tried to write a Windows service which monitors the directory changes, writes an entry in the event log about the change, notifies the changes to the users by sending mail, and also converts the input XML file into a DataSet.

This service is useful in scenarios where the clients upload the files (say XML files) on the server and the server will take care of processing the uploaded files and update them in the database if they are valid.

Building the Application

Start by creating a new Windows service project:

Image 1

Change the service1.cs name to XMLWatcher.cs by editing the service1.cs properties in the Solution Explorer and also change service1 to XMLWatcher in the generated view code window.

Image 2

This application uses FileSystemWatcher to observe the directory changes and SmtpMail to send the mails. To access FileSystemWatcher and MailMessage (in SmtpMail), we need to add references to System.IO and System.Web.dll to this project using Project->Add Reference. We should also add a reference to System.Data.dll to access ADO.NET objects.

Image 3

Image 4

Include System.IO, System.Web.Mail and System.Data.SqlClient namespaces to this project.

C#
using System.IO;
using System.Web.Mail;
using System.Data.SqlClient;

Image 5

Now write the code to initialize the Event Log, FileSystemWatcher and mail server in InitializEventLog(), IntializeFileSystemWatcher() and InitializeMailServer() respectively, and call them from OnStart();

C#
/// <summary> 
/// Initialize the Event Log
/// 
/// </summary>
private void InitializEventLog()
{
   //Check whether " XMLWatcherSource " exist or not
   if(!System.Diagnostics.EventLog.SourceExists("XMLWatcherSource"))
   {
     //Create "XMLWatcherSource" and "XMLWatcherLog"
    System.Diagnostics.EventLog.CreateEventSource("XMLWatcherSource","XMLWatcherLog");
   }
   //Create Event Log
   el=new EventLog();
    //Assign Event Log Name
   el.Log="XMLWatcherLog";
   //Assign Event Source Name
   el.Source="XMLWatcherSource";
}
/// <summary> 
/// Initialize File System Watcher
/// 
/// </summary>
private void IntializeFileSystemWatcher()
{
  //Create File System Watcher for XML files
   fsWatcher=new System.IO.FileSystemWatcher("c:\\temp","*.xml");
  // Add event handlers for new XML files and change of existing XML files.
   fsWatcher.Changed += new FileSystemEventHandler(OnXMLFileChanged);
   fsWatcher.Created += new FileSystemEventHandler(OnXMLFileCreated);
   // Begin watching.
   fsWatcher.EnableRaisingEvents = true;

}

/// <summary> 
/// Initalize Mail Server
/// 
/// </summary>
private void InitializeMailServer()
{
    mailMsg=new System.Web.Mail.MailMessage();
}

/// <summary>
/// Set things in motion so your service can do its work.
/// </summary>
protected override void OnStart(string[] args)
{
    // TODO: Add code here to start your service.

    //Initialize Event Log
    InitializEventLog();
    //Initialize File System Watcher
    IntializeFileSystemWatcher();
    //Initliaze Mail Server
    InitializeMailServer();        

}

Now provide Event Handlers for FileSystemWatcher. These Event Handlers get called when a file is changed or created. Event Handlers will write the entry into Event Log and notify the required people by sending a mail and also converts the XML data into a DataSet. This DataSet can be used to update the database.

C#
/// <summary> 
/// Event Handler for File Changed 
/// 
</summary>
private void OnXMLFileChanged(object source, FileSystemEventArgs e)
{
    //Write entry into the Event Log
    el.WriteEntry("XML File :" + e.FullPath + " changed");

    //Send mail 
    SendMail(e.FullPath);

    //Get the Dataset from XML
    GetDataSetFromXML(e.FullPath);
            
}

/// <summary> 
/// Event Handler for File Created 
/// 
/// </summary>
private void OnXMLFileCreated(object source, FileSystemEventArgs e)
{
    //Write entry into the Event Log
    el.WriteEntry("XML File :" + e.FullPath + " created");

    //Send mail 
    SendMail(e.FullPath);

//Get the Dataset from XML
    GetDataSetFromXML(e.FullPath);

}


/// <summary> 
/// Notify the users by sendig mail
/// 
/// </summary>
private void SendMail(string XMLFileName)
{
    string fileName=XMLFileName;
    //Message From 
    mailMsg.From="admin@xxx.com";
    //Message To
    mailMsg.To="dev@xxx.com";
    //Message Subject
    mailMsg.Subject="New File Uploaded to the server ";
    //Message Body
    mailMsg.Body="XML File :" + fileName + " is uploaded ";
    //Everything set..now send the mail
    SmtpMail.Send(mailMsg);

}

/// <summary> 
/// Get Dataset from XML 
/// 
/// </summary>
private DataSet GetDataSetFromXML(string XMLFileName)
{
    string uploadedXMLfile = XMLFileName;
    //Create the Dataset
    DataSet ds = new DataSet();
    // Create new FileStream with which to read the schema.
    System.IO.FileStream fsReadXml = new System.IO.FileStream
                (uploadedXMLfile, System.IO.FileMode.Open);
    try
    {
        ds.ReadXml(fsReadXml);
                
    }
    catch (Exception ex)
    {
        //Write entry into the Event Log
        fsReadXml.Close();
        el.WriteEntry("Error in readig XML File : " 
                               + uploadedXMLfile );
    }
    
    return ds;

}

We have done with the coding. Now this service needs to be installed under the services. To install this service, we need to add installers to this project.

To add installers to the project, open XMLWatcher.cs in design mode and right click on the form and click Add Installer.

Visual Studio will add ServiceProcessInsatller1 and ServiceInsatller1 to the project.

Image 6

Right click on the ServiceProcessInsatller1 properties and change the Account to Local System to avoid user name, password entry while installing the service.

Image 7

Now build the project. After build succeeds, open Visual Studio .NET 2003 Command Prompt. Using installutil command, install the service.

Image 8

Now the service is installed under the Services. To start the service, go to Administrative Tools->Services, and look for XMLWatcherservice and start the service.

Now the service is up and running. It's time to test the service.

To test the service, create an XML file in c:\temp. Service will monitor the directory change and write an entry in the Event Log under XMLWatcherLog. It will also send a mail to the required users about the directory change.

This application can be further extended to insert the DataSet (which is retrieved from GetDataSetFromXML) into the database.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)