ORM, ловкость рук и никакого мошенничества

dmi3 — Fri, 04 Apr 2008 23:09:38 +0300

Думаю не стоит рассказывать, что такое ORM и с чем его едят на завтрак (если кто не знает почитать можно здесь). Я хотел с вами поделится довольно интересным, с моей точки зрения, обзором ORM Framework. А что тут собственно рассматривать? – скажите, вы – все знают про Hibernate и его версию под .NET NHibernate. Да не могу не согласится, довольно известной и скажем прямо, заслуженный продукт. Но все же, можете меня осуждать но, что то мне в нем не нравится, когда дело касается не очень больших задач связанным с БД. Все эти файлы .xml с мапингом соответствий, да и тот факт, что таблицы все равно должны уже быть. Ну не нравится мне это.

Поэтому, когда я случайно познакомился с довольно интересным решением под названием ODX ORM Framework, не скрою, что я заинтересовался. Не сказать, что он какой-то там сверх технологичный, но для своих задач лучший вариант, как по мне. И так давайте посмотрим, что же это за зверь.

Как и в любой другой ORM работа строится на представлении сущностей БД (таблиц) в виде объектов со свойствами, а наборы кортежей, чаще всего, в виде коллекций таких объектов. Связи между сущностями тоже довольно просто реализовать с точки зрения объектной парадигмы. Если это простая связь, то достаточно просто хранить ссылку на объект, если же один ко многих или многие ко многим, то можно представить в качестве коллекций объектов.

Теперь давайте посмотрим, как это реализовано в рассматриваемом Framework:

[Table("Human", Versioned = true)]

[HierarchyRoot]

[TypeDef("H" )]
public abstract class Human : Entity
{

      public abstract string Name { get; set; }

      public abstract Gender Sex { get; set; }

      public abstract DateTime DateOfBirth { get; set; }

      public int Age
      {

              get { return (int)((DateTime.Now - DateOfBirth).Days / 365.25); }

      }

      public abstract float Weight { get; set; }

      public abstract short Salary { get; set; }

      [Column("MasterID"]
      public abstract IEntityList<Pet> Pets { get; }

}

Как видите, реализовано с помощью двух механизмов: наследования базового класса для всех сущностей Entity и с помощью ключевых атрибутов.

С классом познакомимся позже, а с помощью атрибутов можно осуществлять контроль над представлением сущности в БД. Например, в выше указаном примере мы указавыем имя таблицы с помощью директивы Table, которая кстати обязтельна для всех сущностей, если не указать имя по умолчанию будет использовано имя класса. Также мы указываем, что сущность является корневой в иерархии HierarchyRoot, для сохранения иерархии Framework создает специальные колонки в талицах. Атрибут TypeDef, насколько я понял, служит сокращенной формой типа для фабрики объектов.

Существуют также атрибуты для свойств объекта, например, опять же можем задать имя колонки, вместо по умолчанию имя свойства. В данном примере представлена связь один-ко-многим, для этого у объекта Human есть свойство хранящее ссылку на коллекцию связанных сущностей.

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

[TypeDef("M"]
public abstract class Man : Human
{

       protected override void OnCreated()
       {

              Sex = Gender.Male;
              Weight = 123.1f;
              Salary = 121;
              base.OnCreated();
       }

}

Также довольно интересный момент, авторы предоставляют нам механизм событий (тригеров), с помощью которых можно осуществлять необходимые нам действия.

[Table]
public abstract class Transaction : Entity
{

      public abstract decimal Amount { get; set; }

      public abstract Account DebitAccount { get; set; }

      public abstract Account CreditAccount { get; set; }

      protected override void OnChanging

       (DataColumnChangeEventArgs e)
      {

             if (e.Column.ColumnName == "Amount" )
            {
                    if (DebitAccount != null)
                        DebitAccount.UpdateBalance(+Amount);
                    if (CreditAccount != null)
                        CreditAccount.UpdateBalance(-Amount);
            }

           if (e.Column.ColumnName == "DebitAccountID")
                 if (DebitAccount != null)
                        DebitAccount.UpdateBalance(+Amount);
                ....

      }
}

Довольно интересно, не так ли? Ну да ладно, это все мелочи. Давайте же теперь посмотрим, как огранизована работа с нашими сущностями и БД:

DbDataProvider provider =

new DbDataProvider(OleDbFactory.Instance,
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=sql.mdb;");
Session session = new

Session(provider,Assembly.GetExecutingAssembly());

Основной объект, с которым нам предстоит работать это Session. Естественно, что для работы с базой данных нам нужен DataProvider. Тут можно использовать все, на что способна ваша фантазия. От OLEDB провайдеров (лично я их не люблю бяка )) до обычного XmlDataProvider(как вам перспектива работать с обычным XML с тем же кодом для и для БД ?). Если вас не устаивает стандартные, пожалуйста, пишите свой, достаточно наследовать базовый класс DbProviderFactory (лично так я и делал для Postgresql).

Дальше все проще, чем можно представить:

DbDataProvider provider =

new DbDataProvider(new PGDataFactory(),

PGDataFactory.getConnectionStr("localhost", "snms", "dmi3", "dmi3"));

Session session = new Session(provider, Assembly.GetExecutingAssembly());

provider.CreateDatabase(session.Schema);

Man oledbJohn = session.Create<Man>();
oledbJohn.Name = "John";
oledbJohn.DateOfBirth = new DateTime(1977, 04, 06);

session.Save();

Man odbcSmith = session.Create<Man>();
odbcSmith.Name = "Smith";
odbcSmith.DateOfBirth = new DateTime(1953, 11, 1;
session.Save();

Никак предварительных таблиц не надо. Достаточно provider.CreateDatabase(session.Schema);

Framework сам создаст за вас все таблицы, исходя из имеющихся сущностей.
Ну ладно, БД создали, таблицы есть, что дальше? А дальше опять же все просто. Хотим получить все кортежи определенного типа? – пожалуйста:

ICollection<Man> list= session.All<Man>();

Ну а если запрос с условием? – ничего сложного:

Man odbcJohn = odbcSession.SelectOne<Man>("Name = ?", "DateOfBirth DESC", "John");

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

Man[] men = session.Select<Man>("'Age= ?'", "Name", 20);

Также можно использовать SQL в чистом виде:

Pager<Human> p = new Pager<Human>(session, @"
select h.* from Human h inner join Pet p on p.MasterID = h.ID
where p.Name like 'M%' and <PagerWhere>",
"Name", 1, PagerFilterType.Select);

Также есть разнообразные механизмы проверки про добавлени, например:

try
{
    session.Save(SaveMode.Concurrent);
}
catch ( DBConcurrencyException e )
{
    Console.WriteLine("Concurrent access violation");
    Console.WriteLine("Conflicted table: " + e.Row.Table.TableName);
            foreach (DataColumn dc in e.Row.Table.Columns)
              if (dc.ColumnName.ToUpper() != "ID"

               && dc.ColumnName.ToUpper() != "ROWVERSION")
               Console.WriteLine("\t{0}\t{1}", dc.ColumnName, e.Row[dc.ColumnName]);
    // reject the violated changes to be able to save other work
    Entity violatedEntity = oledbSession.FindEntity(e.Row["ID"].ToString());
    violatedEntity.RejectChanges();
    Console.WriteLine("Conflicted changes rejected.");
}

Еще довольно интересный момент, не обязательно мы должны быть подключены в БД! Все выполненные изменения можно сохранить в файл, и потом про подключении произвести «merge» (не хочу переводить, так как слияние вроде не оч. подходит):

xx-small">static void Main()
{
     const string fileName = "pets.xml";
     const string offlineFileName = "pets.bin";
/>      Init(fileName);
     CreateReplica(fileName, offlineFileName);
     ModifyReplica(offlineFileName);
     ModifyOnline(fileName);
     MergeReplica(fileName, offlineFileName);
/>      Session session = new Session(
                new XmlDataProvider(fileName),
                Assembly.GetExecutingAssembly());
/>      Person john = session.SelectOne<Person>("Name = ?", null, "John");
/>      session.Combine(session);
}
/> style="font-size: xx-small">private static void MergeReplica(string fileName, string offlineFileName)
{
     // Create "connected" session.
     Session session = new Session(
     new XmlDataProvider(fileName),
           Assembly.GetExecutingAssembly());
/>     // Load offline data in connected session.
    session.LoadFromFile(offlineFileName);
/>    // Save replica to the online data source.
   session.Save();
}

private static void ModifyReplica(string offlineFileName)
{

    // Create "disconnected" session.
    Session offlineSession = new Session(Assembly.GetExecutingAssembly());

   // Load Replica data into the session.
   offlineSession.LoadFromFile(offlineFileName);

   // Select John
   Person offlineJohn = offlineSession.SelectOne<Person>(
                             "Name = ?", null, "John");
   // Perform data modifications
  offlineJohn.Age++;

  Pet dog = offlineSession.Create<Pet>();

  dog.Name = "Beethoven";

  dog.Master = offlineJohn;

  offlineSession.SaveToFile(offlineFileName);

}

private static void Init(string fileName)
{

     if (File.Exists(fileName))
         File.Delete(fileName);

     // Create "connected" session
    Session session = new Session(new XmlDataProvider(fileName));

    session.RegisterAssembly(Assembly.GetExecutingAssembly());

    session.Prepare();

    // Populate connected sesson with some data
    Person john = session.Create<Person>();

C# pointer hell или как не попасть впросак

dmi3 — Fri, 28 Mar 2008 23:34:27 +0200

Старый добрый Си, сколько хороших воспоминаний. Бессонный ночи, красные глаза). Все помнят кошмар при работе с указателями, кто-то конечно может возразить, да есть свои плюсы и и не меньше минусов и головной боли. Можно ведь прекрасно без них обходится, Java тому пример (хотя по правде говоря там все указатели, просто не дают явно работать с ними). А руки иногда почесываются поставить *? Нет, значит вы на правильном пути, нечего шаловливым ручонкам к памяти давать доступ. Вот и я думал, что не придется, а все же…

Бывают ситуации, хотя и очень редко, когда надо использовать библиотеку (*.dll) написанную скажем на Delphi. И если для использования этой библиотеки нету промежуточного COM объекта или иных достижений цивилизации, да если еще «коллеги» написали в качестве параметров указатели (передаю им привет ), то тогда эта заметка будет вам в помощь. Конечно, надеюсь, что вы с таким не столкнетесь, но всякое бывает.
Итак, как использовать экспортируемые библиотеки из *.dll я сильно расписывать не буду, скажу, что в моем случае я использовал DllImport, вот пример:

using System.Runtime.InteropServices;

namespace DllHell
{

       public static class Test{
              [DllImport("MyLib.dll" )]
              private static extern int SomeFunction();
       }
}

Обязательным параметром является extern, что указывает компилятору но то, что функция экспортируется из библиотеки, которая в данном случае будет искатся в каталоге с приложением, так как не указан полный путь.
Все хорошо, но если мы имеет что-то вроде этого:

[DllImport("MyLib.dll"]
private extern int SomeFunction(byte* pData, char* oid, int size);

Паниковать не надо, все решаемо. Для начала стоит разрешить в проекту использование unsafe («небезопасного», вот какого мнения об указателях Microsoft =|) кода. Зделать это можно здесь:

Данная опция позволяет использовать в проектк директиву unsafe, без нее компилятор будет очень громко ругатся на какие том там непонятные звездочки и амперсанты. Если следующие варианты использования:

Объявить класс как unsafe:

         unsafe public class Test
         {
         }

Только метод:

          unsafe public void SomeMethod()
          {
          }

Или же участок кода:

        unsafe
        {
                //Some cod here
        }

Опять же не все так просто, как казалось. Мы можем в таком участке кода объявлять указатели и брать адресса через оператор «&». Но если нам надо использовать указатель на byte[] или же char[]. На конструкцию следующего типа:

unsafe
{
char[] buf = new char[10];
char* pBuf = h;
}

компилятор вам деликатно скажет, что он не может взять адреса, использовать sizeof(), и объявлять укаазтели на managed types, к коим относится, в частности, char[].
Решение этой проблемы в использовании директивы fixed. Проще говоря, данная директива исключает то, что ваша переменная будет выброшена в мусор GC (garbage collector). Пример использования:

unsafe
{
        byte[] buf = new byte[10] { 1,2,3,4,5,6,7,8,9,10};
        fixed (byte* pBuf = buf)
        {
                pBuf[2] = 0; // в buf элемент с индексом 2 будет равен 0
        }
}

Также директива fixed в C# 2.0 и выше может использоваться еще в одном контексте. Например если нам надо в структуре использовать массив заданной величины (как вы знаете проинициализировать свойства структуры до ее создания мы не можем), поэтому решение опять же в использование fixed:

unsafe public struct SomeStruct
{
public fixed char arr[200];
}

Вот и все, чем я хотел с вами поделится. Данная заметка не предентует на оригинальность, но надеюсь кому-то будет полезно.

Краткий обзор Must-have утилит для .NET разработчика

dmi3 — Sun, 23 Mar 2008 22:19:06 +0200

В этой статье я хочу поделится списком «Must-Have Tools», то есть небольшие бесплатные утилиты, направленные на облегчение жизни нам и нашим коллегам, team-members и товарищам. Возможно не все из нижеперечисленного вам пригодится, до думаю каждый для себя найдет что-то по вкусу.

Snippet Compiler

Никогда не сталкивались с ситуаций, когда надо проверить небольшой кусок кода, но открывать Студию, создавать для этого проект так лень? Если ответ «да», то следующая утилита именно для вас. Миниатюрная программка позволит вам откомпилировать и запустить код.

Скачать - Snippet Compiler

Regulator and Regulazy

Две утилиты одного автора предназначенные для создания и проверки регулярных выражений (Regex, Regular expressions). Первая, более серьезная и предназначена для опытных и закаленных в боях разработчиков ):

Вот некоторые возможности:

Supported Regex actions

Find multiple Matches
Replace text according to expression
Split text according to expression

Regexlib.com integration

Search and import expressions and examples from RegexLib.comג€™s database
Post your own regular expressions into regexlib's database, direct from The regulator using a graphical wizard
Full Proxy support for secure connections

Text Editing

Syntax highlighting
Multiple document tabbed interface
Quick menus allow you to easily select syntax operations to insert
Quick Menus are fully customizable simply by changing a simple XML file in the program directory
Brace matching support
Make selected text "escaped" to match a specific string exactly without needing to manually write those \s,\n and other escape sequences
Collapse/expand selection: you can create collapsible regions in your regex code for easy reading
Select only a portion of the expression in the editor and only that selection will be executed as a match\replace

Вторая, судя из названия, предназначена для «ленивых» разработчиков (то есть для нас ), которые не привыкли ломать голову над выражениями, а предпочитают интерактивную генерацию их же:

Скачать - Regulator

Скачать - Regulazy

FxCop

FxCop предоставляет средства автоматической проверки .NET-сборок на предмет соответствия правилам Microsoft .NET Framework Design Guidelines. Откомпилированный код проверяется с помощью механизмов Reflection, парсинга MSIL и анализа графа вызовов. В результате FxCop способен обнаружить более 200 недочетов (или ошибок) в следующих областях:

Архитектура библиотеки
Локализация
Правила именования
Производительность
Безопасность

NUnit

Думаю, кто знаком с Java или вообще с тестированием не готового продукта, а отдельных классов и модулей, тот сразу поймет, что это. Про написание тестов, в часности NUnit написано тонна литературы и статей, поэтому здесь я этого касатся не буду, возможно будут отдельные статьи

NUnit это Open Source проект, домашняя страница находится здесь - http://www.nunit.org.

Также есть неплохие плагины для Студии - http://sourceforge.net/projects/nunitaddin.

Lutz Roeder's .NET Reflector

Следующая утилита с помощью механизма Reflection расскажет вам все «секреты» интересующей вас сборки: структура классов, подробная информация ко каждому классу (методы, поля, описание и тд.).

Скачать можно здесь - Reflector for .NET

NDoc

Часто ли вы комментируете свой код и вошло ли у вас это в привычку? Нет?! Тогда вам стоит начать прямо сейчас. Данная же утилита позволит сгенерировать, например, из той же сборки, документацию в виду XML структурированного согласно иерархии классов. Это в том случае, если вы применяли в своем коду документирование в стиле XML.

/// <summary>
/// This test adds a number of values to the Hashtable collection
/// and then retrieves those values and checks if they match.
/// </summary>
[Test]
public void HashtableAddTest()
{
//Method Body Here
}

<member name="M:NUnitExample.HashtableTest.HashtableAddTest">
<summary>This test adds a number of values to the Hashtable collection

and then retrieves those values and checks if they match.

</summary>
</member>

NAnt

Опять же знакомая утилита Java разработчикам, которая позволяет «собрать» проект без использование любых IDE. Главное, чтоб стоял .NET Framework. Очень напоминает Си-шный ЮНИКС аналог make, только в нашем случае скрипт описание последовательности создается в виде XML документа.

<csc target="library" output=".\bin\debug\NUnitExample.dll"
                            debug="${debug}">
<references>
       <includes name="C:\program files\NUnit V2.1\bin\NUnit.Framework.dll"/>
</references>
<sources>
       <includes name="HashtableTest.cs"/>
</sources>
</csc>

Скачать можно здесь - NAnt.

XML Data Editor

Данная программка позволяет легко и удобно редактировать XML файлы, представленные в виде таблицы атрибутов.

Скачать - XML Data Editor

Вот и все о чем я хотел вам поведать. Если у вас есть на примете утилиты, которые реально помогают вам в работе, то буду только рад дополнить список.

Альтернатива Visual Studio есть.

dmi3 — Sun, 23 Mar 2008 04:24:57 +0200

Если честно, до не давних пор даже и мысли не было о возможности альтернативы Visual Studio. Да, тут конечно не сравнишь с разработкой на Java, где можно выбрать себе IDE по вкусу, еще и поспорить с другим, где удобнее писать за бутылкой пива. Но оказывается нашлись альтруисты, которые не пожалели сил и времени на разработку IDE, которая вполне может стать заменой продукту от Microsoft, а в некоторых моментах даже лучше (личное мнение). Называется проект SharpDevelop. Первое мнение, которое может сложится исходя из названия – это то, что студия исключительно для C#. Хочу вас обрадовать, это не так, скорей всего название исходит из того, что написана она на том же C#.

Итак, что же мы имеем.

Сразу же бросается в глаза небольшой объем, всего то 12мб, хотя это свойственно всем исполняемым файлам под .NET Framework, но согласитесь, после Студии разница разимая. Можно спокойно хранить на флешке, вдруг вам приспичит покодить у девушки дома .

Самое важное то, что проект Open Source и вы спокойно можете скачать исходники с сайта авторов для изучения, или же присоединится к доработке и исправлению багов.

Что же нам может предоставить эта темная лошадка, спросите вы. Вот список возможностей:

Forms designer for C#, VB.NET and Boo
Code completion for C#, VB.NET and Boo (including Ctrl+Space support)
Integrated NUnit support plus code coverage (NCover)
Integrated debugger
Code Analysis with FxCop
Refactoring support
Multi-framework support (.NET 1.1 and 2.0, Mono, Compact Framework)
XML Editing (source and tree view) with XPath search
Parser-based code converter (C# to VB.NET / Boo and more)
Compile C#, VB.NET & Boo code in the IDE out-of-the-box
Code AutoInsert (Alt+Ins)
Xml documentation preview
Setup projects supported with Windows Installer XML (WiX)
Subversion integration
Open source, LGPL licensed

..and much more

Также присутствует обратная поддержка проектов Visual Studio.

С первого взгляда напоминает немного упрощенный интерфейс студии, кому то может даже больше понравится, все лаконично, можно сказать «ничего лишнего»:

Как видите ничего кардинального и экстравагантного нету. Тот же Toolbox в визуальном редакторе, но, например, есть сразу две закладки «Source» и «Design», мелочь, а приятно . В режиме редактирования кода на Toolbox доступны макросы заготовки:

На данный момент стабильная версия 2.2, но также доступна для скачивания 3.0 бета. Ничего страшного в бете нету, по заявлением разработчиков, это та же 2.2 только с новыми возможностями. Я и сам использую 3.0. Вот список нововведений в третьей версии:

* Parallel build support for multi-core machines
* IronPython language support has been added
* F# language support has been added (F# must be installed separately)
* C# 3.0 code completion is implemented (NOTE: VB9 is *not* as of Beta 1)
* The debugger infrastructure has been rewritten, more features to come in Beta 2
* Performance and stability work (i.e. VB <-> C# conversion)
NDoc has been replaced with Sandcastle
NCover has been replaced with PartCover
WiX 3.0 has been integrated
Mono and NAnt support no longer shipping in setup (still supported though)

Все конечно прекрасно и ребята конечно молодцы (большое им спасибо за это!) но все же на бочку меда найдется ложка дегтя. К сожалению, когда дело дошло до веб разработки (ASP) оказалось, что в SharpDevelop нету визального редактора для ASP страниц. Не критично – согласен, но не удобно (возможно я не нашел, кто знает). Так что не спешите удалять Студию, но я уверен, что в ближайшем будущем и это исправят.

На этом пока все, будем следить за развитием проекта и уж точно возьмем на заметку. Авторам естественно удачи в их благородных начинаниях.

Офф. сайт

Форум разработчиков

Экспорт кода с сохранением стилизации

dmi3 — Sun, 23 Mar 2008 01:56:36 +0200

Наверно каждый рано или поздно сталкивался c проблемой экспортирование исходного кода в разного рода документацию (будь то отчет или же проектная документация, а может для публикации в виде html страницы). Я тоже как то не сильно об этом задумывался, но случайно наткнулся на довольно полезную тулзу.

C# Code Export. Сие маленькое творение наших зарубежных коллег (а весит всего 1,8мб) может экспортировать ваш исходный текст с сохранением красивой и читаемой разметки в следующие форматы:

HTML
PDF
RTF
BMP
PNG
JPG
Lotus
SVG
QUATTRO Pro
Excel

Не плохо, те так ли? На сайте разработчиков можно также найти аналогичные версии для Java и С++. Пользуйтесь и пусть ваша жизнь станет немного легче . Скрины:

Скачать

.NET Developer notes

ПадонФфская почта от Microsoft

ORM, ловкость рук и никакого мошенничества

C# pointer hell или как не попасть впросак

Краткий обзор Must-have утилит для .NET разработчика

Альтернатива Visual Studio есть.

Экспорт кода с сохранением стилизации