Click here to Skip to main content
15,867,568 members
Articles / Web Development / ASP.NET

UI Object Connector Implementation of Mediator Pattern

Rate me:
Please Sign up or sign in to vote.
3.42/5 (19 votes)
7 Mar 2014CPOL3 min read 63.2K   232   33   15
UI Object Connector Implementation of Mediator Pattern

Table of Contents

Introduction

When we consume business objects in UI, the logic can become pretty complex for activities like setting the business object value, getting the object value and setting the user interface from the object value. We can minimize the complexity of UI interaction with the business object using mediator pattern.

I have been writing and recording a lot of architecture related videos on design patterns, UML, FPA estimation, C# projects, etc. You can watch my videos here.

The Problem

In almost all projects, we have the basic three tier architecture as shown in the below figure. So the UI creates the business object, sets the values or gets the values and flourishes the UI.

Image 1

The three big things we need to do on the UI are stated below:

  1. Setting the business object values from the user interface:

    C#
    public void setObjectFromUI(clsInvoice objInvoice)
    {
    objInvoice.CustomerName = txtCustomerName.Text;
    objInvoice.CustomerAddress = txtCustomerAddress.Text;
    objInvoice.Amount = Convert.ToDouble(lblTotalAmountToBePaid.Text);
    objInvoice.PaidAmount = Convert.ToDouble(txtAmountPaid.Text);
    objInvoice.InvoiceDate = Convert.ToDateTime(txtInvoiceDate.Text);
    objInvoice.InvoiceComments = txtComments.Text;
    objInvoice.InvoiceReference = txtInvoiceNumber.Text;
    objInvoice.Quantity = Convert.ToInt16(TxtQuantity.Text);
    objInvoice.TaxAmount = Convert.ToDouble(txtTaxAmount.Text);
    }
  2. Getting the values from the objects and displaying the same in the UI:

    C#
    txtCustomerName.Text = objInvoice.CustomerName;
    txtCustomerAddress.Text = objInvoice.CustomerAddress;
    lblTotalAmountToBePaid.Text = objInvoice.Amount.ToString();
    txtAmountPaid.Text = objInvoice.PaidAmount.ToString();
    txtInvoiceDate.Text = objInvoice.InvoiceDate.ToString();
    txtComments.Text = objInvoice.InvoiceComments.ToString();
    txtInvoiceNumber.Text = objInvoice.InvoiceReference.ToString();
    TxtQuantity.Text = objInvoice.Quantity.ToString();
    txtTaxAmount.Text = objInvoice.TaxAmount.ToString();
  3. Clearing the UI values for fresh and new inputs:

    C#
    public void clearText()
    {
    txtInvoiceNumber.Text = "";
    txtComments.Text = "";
    txtInvoiceDate.Text = "";
    TxtQuantity.Text = "";
    lblTotalAmountToBePaid.Text = "";
    txtTaxAmount.Text = "";
    txtAmountPaid.Text = "";
    txtCustomerName.Text = "";
    txtCustomerAddress.Text = "";
    }

All the above things can clutter your UI. The most important thing is that the UI is tied up with the business object for various reasons.

Solution

The answer to this is if we can make a mediator who takes care of which UI objects map which object property that will solve our problem. So what we need to do is implement a simple UI object connector which takes the values from UI and sets to the object. This can be easily implemented by using mediator pattern. In case you are not aware of it, you watch this video to understand the concept.

UI Object Connector Implementation

Below is our simple class which will be used in a simple UI:

C#
public class clsSampleClass
{
private string strProperty1="Default1";
private string strProperty2="Default2";
public string Property1
{
set
{
strProperty1 = value;
}
get
{
return strProperty1;
}
}
public string Property2
{
set
{
strProperty2 = value;
}
get
{
return strProperty2;
}
}
}

For the mediator class, we will have two array lists - one which will have the text box and the other will have the property. Every item of the array, i.e. Text box will have a corresponding item of property where the value will be set:

C#
private ArrayList objtextboxes = new ArrayList();
private ArrayList objPropertyInfo = new ArrayList();

The user interface, i.e. the ASPX page will be exposed a method ‘Add’ which will take the corresponding text box and the property to which this text box is tied up:

C#
public void Add(TextBox objtextBox, string strPropertyName)
{
objtextboxes.Add(objtextBox);
objPropertyInfo.Add(strPropertyName);
}

To set the values from the object to the UI, we will use reflection. So get the text box and the corresponding property and set the same using reflection:

C#
public void setValuesToObject(clsSampleClass objSample)
{
// get the object type
Type objType = objSample.GetType();

// browse through all the UI objects and set the object
// from the UI to the corresponding property

for(int i=0;i<objtextboxes.Count;i++)
{
// get the UI object
PropertyInfo objProperty = objType.GetProperty(objPropertyInfo[i].ToString());

// set the object property from the UI object
objProperty.SetValue(objSample,((TextBox)objtextboxes[i]).Text,null);
}
}

The same holds true when we set the values back to UI:

C#
public void setValuesToUI(clsSampleClass objSample)
{
Type objType = objSample.GetType();
for (int i = 0; i < objtextboxes.Count; i++)
{
PropertyInfo objProperty = objType.GetProperty(objPropertyInfo[i].ToString());
((TextBox)objtextboxes[i]).Text= objProperty.GetValue(objSample, null).ToString();
}
}

If you want to clear the text box, just call all the objects of text boxes in the array list and set the same to nothing:

C#
public void ClearTextBox()
{
Type objType = Type.GetType("clsSampleClass");
for (int i = 0; i < objtextboxes.Count; i++)
{
((TextBox)objtextboxes[i]).Text = "";
}
}

The Neat Client Code

Now we have a one liner client code. If you want to set the values from the UI to the object, just call setValuesToObject:

C#
objMediator.setValuesToObject(objSample);

If you want to set the values of object to the UI, just call setValuesToUI:

C#
objMediator.setValuesToUI(objSample);

If you want to clear all UI, call ClearTextBox:

C#
objMediator.ClearTextBox();

For Further reading do watch  the below interview preparation videos and step by step video series.

License

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


Written By
Architect https://www.questpond.com
India India

Comments and Discussions

 
GeneralGood ... But Pin
Samer Aburabie30-Oct-08 16:12
Samer Aburabie30-Oct-08 16:12 
GeneralRe: Good ... But Pin
Donsw4-Feb-09 16:27
Donsw4-Feb-09 16:27 
GeneralRe: Good ... But Pin
Shivprasad koirala4-Feb-09 17:52
Shivprasad koirala4-Feb-09 17:52 
Thanks for all your encouragement it means a lot for me.

Footprints on the sand are not made by sitting at the shore.

GeneralNice for simple cases... Pin
Olivier_Giulieri30-Oct-08 14:27
Olivier_Giulieri30-Oct-08 14:27 
GeneralGood one...But also state opensources Pin
curlybrownycft30-Oct-08 8:52
curlybrownycft30-Oct-08 8:52 
GeneralMicrosoft posting Pin
Shivprasad koirala30-Oct-08 8:48
Shivprasad koirala30-Oct-08 8:48 
GeneralDatabinding Pin
BAIJUMAX30-Oct-08 6:07
professionalBAIJUMAX30-Oct-08 6:07 
GeneralRe: Databinding Pin
Shivprasad koirala30-Oct-08 8:45
Shivprasad koirala30-Oct-08 8:45 
GeneralRe: Databinding Pin
BAIJUMAX30-Oct-08 17:52
professionalBAIJUMAX30-Oct-08 17:52 
GeneralRe: Databinding Pin
Shivprasad koirala30-Oct-08 20:19
Shivprasad koirala30-Oct-08 20:19 
GeneralAnother Solution Pin
Mark.Whitfeld30-Oct-08 6:01
Mark.Whitfeld30-Oct-08 6:01 
GeneralRe: Another Solution Pin
Shivprasad koirala30-Oct-08 8:47
Shivprasad koirala30-Oct-08 8:47 
GeneralRe: Another Solution Pin
Mark.Whitfeld30-Oct-08 20:49
Mark.Whitfeld30-Oct-08 20:49 
QuestionWhat about Speed ? Pin
sachadev30-Oct-08 4:46
sachadev30-Oct-08 4:46 
AnswerRe: What about Speed ? Pin
Shivprasad koirala30-Oct-08 8:47
Shivprasad koirala30-Oct-08 8:47 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.