Bridge¶
- Bridge
- UML class diagram
- Participants
- Structural code in C# .{10}
- Real-world code in C# .{10}
- .NET Optimized code in C# .{10}
Summary: Decouple an abstraction from its implementation so that the two can vary independently.
Frequency of use: Medium
UML class diagram¶
Participants¶
The classes and objects participating in this pattern are:
- Abstraction (
BusinessObject
) - defines the abstraction's interface.
- maintains a reference to an object of type Implementor.
- RefinedAbstraction (
CustomersBusinessObject
) - extends the interface defined by Abstraction.
- Implementor (
DataObject
) - defines the interface for implementation classes. This interface doesn't have to correspond exactly to Abstraction's interface; in fact the two interfaces can be quite different. Typically the Implementation interface provides only primitive operations, and Abstraction defines higher-level operations based on these primitives.
- ConcreteImplementor (
CustomersDataObject
) - implements the Implementor interface and defines its concrete implementation.
Structural code in C# .{10}¶
This structural code demonstrates the Bridge pattern which separates (decouples) the interface from its implementation. The implementation can evolve without changing clients which use the abstraction of the object.
using System;
namespace DoFactory.GangOfFour.Bridge.Structural
{
/// <summary>
/// MainApp startup class for Structural
/// Bridge Design Pattern.
/// </summary>
class MainApp
{
/// <summary>
/// Entry point into console application.
/// </summary>
static void Main()
{
Abstraction ab = new RefinedAbstraction();
// Set implementation and call
ab.Implementor = new ConcreteImplementorA();
ab.Operation();
// Change implemention and call
ab.Implementor = new ConcreteImplementorB();
ab.Operation();
// Wait for user
Console.ReadKey();
}
}
/// <summary>
/// The 'Abstraction' class
/// </summary>
class Abstraction
{
protected Implementor implementor;
// Property
public Implementor Implementor
{
set { implementor = value; }
}
public virtual void Operation()
{
implementor.Operation();
}
}
/// <summary>
/// The 'Implementor' abstract class
/// </summary>
abstract class Implementor
{
public abstract void Operation();
}
/// <summary>
/// The 'RefinedAbstraction' class
/// </summary>
class RefinedAbstraction : Abstraction
{
public override void Operation()
{
implementor.Operation();
}
}
/// <summary>
/// The 'ConcreteImplementorA' class
/// </summary>
class ConcreteImplementorA : Implementor
{
public override void Operation()
{
Console.WriteLine("ConcreteImplementorA Operation");
}
}
/// <summary>
/// The 'ConcreteImplementorB' class
/// </summary>
class ConcreteImplementorB : Implementor
{
public override void Operation()
{
Console.WriteLine("ConcreteImplementorB Operation");
}
}
}
Output¶
Real-world code in C# .{10}¶
This real-world code demonstrates the Bridge pattern in which a BusinessObject abstraction is decoupled from the implementation in DataObject. The DataObject implementations can evolve dynamically without changing any clients.
using System;
using System.Collections.Generic;
namespace DoFactory.GangOfFour.Bridge.RealWorld
{
/// <summary>
/// MainApp startup class for Real-World
/// Bridge Design Pattern.
/// </summary>
class MainApp
{
/// <summary>
/// Entry point into console application.
/// </summary>
static void Main()
{
// Create RefinedAbstraction
var customers = new Customers();
// Set ConcreteImplementor
customers.Data = new CustomersData("Chicago");
// Exercise the bridge
customers.Show();
customers.Next();
customers.Show();
customers.Next();
customers.Show();
customers.Add("Henry Velasquez");
customers.ShowAll();
// Wait for user
Console.ReadKey();
}
}
/// <summary>
/// The 'Abstraction' class
/// </summary>
class CustomersBase
{
private DataObject _dataObject;
public DataObject Data
{
set { _dataObject = value; }
get { return _dataObject; }
}
public virtual void Next()
{
_dataObject.NextRecord();
}
public virtual void Prior()
{
_dataObject.PriorRecord();
}
public virtual void Add(string customer)
{
_dataObject.AddRecord(customer);
}
public virtual void Delete(string customer)
{
_dataObject.DeleteRecord(customer);
}
public virtual void Show()
{
_dataObject.ShowRecord();
}
public virtual void ShowAll()
{
_dataObject.ShowAllRecords();
}
}
/// <summary>
/// The 'RefinedAbstraction' class
/// </summary>
class Customers : CustomersBase
{
public override void ShowAll()
{
// Add separator lines
Console.WriteLine();
Console.WriteLine("------------------------");
base.ShowAll();
Console.WriteLine("------------------------");
}
}
/// <summary>
/// The 'Implementor' abstract class
/// </summary>
abstract class DataObject
{
public abstract void NextRecord();
public abstract void PriorRecord();
public abstract void AddRecord(string name);
public abstract void DeleteRecord(string name);
public abstract string GetCurrentRecord();
public abstract void ShowRecord();
public abstract void ShowAllRecords();
}
/// <summary>
/// The 'ConcreteImplementor' class
/// </summary>
class CustomersData : DataObject
{
private List<string> _customers = new List<string>();
private int _current = 0;
private string _city;
public CustomersData(string city)
{
_city = city;
// Loaded from a database
_customers.Add("Jim Jones");
_customers.Add("Samual Jackson");
_customers.Add("Allen Good");
_customers.Add("Ann Stills");
_customers.Add("Lisa Giolani");
}
public override void NextRecord()
{
if (_current <= _customers.Count - 1)
{
_current++;
}
}
public override void PriorRecord()
{
if (_current > 0)
{
_current--;
}
}
public override void AddRecord(string customer)
{
_customers.Add(customer);
}
public override void DeleteRecord(string customer)
{
_customers.Remove(customer);
}
public override string GetCurrentRecord()
{
return _customers[_current];
}
public override void ShowRecord()
{
Console.WriteLine(_customers[_current]);
}
public override void ShowAllRecords()
{
Console.WriteLine("Customer City: " + _city);
foreach (string customer in _customers)
{
Console.WriteLine(" " + customer);
}
}
}
}
Output¶
Jim Jones
Samual Jackson
Allen Good
------------------------
Customer Group: Chicago
Jim Jones
Samual Jackson
Allen Good
Ann Stills
Lisa Giolani
Henry Velasquez
------------------------
.NET Optimized code in C# .{10}¶
using System;
using System.Collections.Generic;
namespace DoFactory.GangOfFour.Bridge.NETOptimized
{
/// <summary>
/// MainApp startup class for .NET optimized
/// Bridge Design Pattern.
/// </summary>
class MainApp
{
/// <summary>
/// Entry point into console application.
/// </summary>
static void Main()
{
// Create RefinedAbstraction
var customers = new Customers();
// Set ConcreteImplementor
customers.DataObject = new CustomersData { City = "Chicago" } ;
// Exercise the bridge
customers.Show();
customers.Next();
customers.Show();
customers.Next();
customers.Show();
customers.Add("Henry Velasquez");
customers.ShowAll();
// Wait for user
Console.ReadKey();
}
}
/// <summary>
/// The 'Abstraction' class
/// </summary>
class CustomersBase
{
// Gets or sets data object
public IDataObject<string> DataObject { get; set; }
public virtual void Next()
{
DataObject.NextRecord();
}
public virtual void Prior()
{
DataObject.PriorRecord();
}
public virtual void Add(string name)
{
DataObject.AddRecord(name);
}
public virtual void Delete(string name)
{
DataObject.DeleteRecord(name);
}
public virtual void Show()
{
DataObject.ShowRecord();
}
public virtual void ShowAll()
{
DataObject.ShowAllRecords();
}
}
/// <summary>
/// The 'RefinedAbstraction' class
/// </summary>
class Customers : CustomersBase
{
public override void ShowAll()
{
// Add separator lines
Console.WriteLine();
Console.WriteLine("------------------------");
base.ShowAll();
Console.WriteLine("------------------------");
}
}
/// <summary>
/// The 'Implementor' interface
/// </summary>
interface IDataObject<T>
{
void NextRecord();
void PriorRecord();
void AddRecord(T t);
void DeleteRecord(T t);
T GetCurrentRecord();
void ShowRecord();
void ShowAllRecords();
}
/// <summary>
/// The 'ConcreteImplementor' class
/// </summary>
class CustomersData : IDataObject<string>
{
// Gets or sets city
public string City { get; set; }
private List<string> _customers;
private int _current = 0;
// Constructor
public CustomersData()
{
// Simulate loading from database
_customers = new List<string>
{ "Jim Jones", "Samual Jackson", "Allan Good",
"Ann Stills", "Lisa Giolani" };
}
public void NextRecord()
{
if (_current <= _customers.Count - 1)
{
_current++;
}
}
public void PriorRecord()
{
if (_current > 0)
{
_current--;
}
}
public void AddRecord(string customer)
{
_customers.Add(customer);
}
public void DeleteRecord(string customer)
{
_customers.Remove(customer);
}
public string GetCurrentRecord()
{
return _customers[_current];
}
public void ShowRecord()
{
Console.WriteLine(_customers[_current]);
}
public void ShowAllRecords()
{
Console.WriteLine("Customer Group: " + City);
_customers.ForEach(customer =>
Console.WriteLine(" " + customer));
}
}
}