Проверяем входные данные

Все программисты знают, что пришедшие из внешнего источника данные всегда надо проверять. Например в качестве входного параметра для метода (свойства, конструктора), может приходить ссылка, которую нужно проверить на null, число, которое должно быть из определенного диапазона, или определенного вида строка. Несмотря на то, что по этому поводу даже существует методика разработки через Code Contracts, по-прежнему, с высокой вероятностью в проекте можно встретить код проверки на null аналогичный следующему:

class Bar {}

 

class Foo

{

    Bar _bar;

 

    public Foo(Bar bar)

    {

        // bar может быть null

        if (bar == null)

            throw new ArgumentNullException("bar");

 

        _bar = bar;

    }

}

С ростом проекта, подобных мест становиться все больше, и контроллировать создание исключений стоновиться сложнее. Одно из решений проблемы (для тех, кто пока еще не перешел на Code Contracts), сделать процесс создания исключений более централизованным, а именно в определенном классе - Guard (я остановился на названии Guard, но встречаются еще Assert, Check (проект KIGG CheckArgument.cs)):

public static class Guard

{

    public static T AssertNotNull<T>(T paramValue, string paramName) where T : class

    {

        if (paramValue == null)

        {

            throw new ArgumentNullException(paramName);

        }

        return paramValue;

    }

}

Принцип работы Guard следующий: если входной параметр удовлетворяет некому условию, то Guard пропускает параметр дальше, если нет, то будет сгенерированно исключение:

class Foo

{

    Bar _bar;

 

    public Foo(Bar bar)

    {

        // bar может быть null       

        _bar = Guard.AssertNotNull(bar, "bar");

    }

}

Итак, за проверку входных параметров у нас отвечает Guard, поэтому вся логика проверки (в том числе более и сложная) не будет присутствовать в основном классе, а будет вынесена в Guard, что сохраняет компактность кода.
Во-вторых, мы получили удобный механизм контроля создания исключения, например мы легко сможем добавлять свои типы исключений или менять текст исключений и прочее.
И в-третьих, можно сделать так, чтобы Guard сам отдельно сообщал об исключениях (нарушение контракта):

public static class Guard

{

    public static T AssertNotNull<T>(T paramValue, string paramName) where T : class

    {

        if (paramValue == null)

        {

            ArgumentNullException ex = new ArgumentNullException(paramName);

 

            OnAlert(ex); // сообщим об исключении, например сделаем запись во внутренний лог.

 

            throw ex;

        }

        return paramValue;

    }

}

Так же иногда бывает удобно пометить Assert методы специальным атрибутом:

[DebuggerStepThrough]

public static T AssertNotNull<T>(T paramValue, string paramName) where T : class

{

    //...

}

PS: Топик навеян статьей habrahabr: Концепция баррикады.