Руководство по Catharsis - часть 1: установка

Written on 07 Мая 2011. Posted in ASP.NET

Предварительные условия

Вам необходимы следующие инструменты:

     • .NET Framework 3.5 SP1

     • Visual Studio 2008
             Team System 2008
             Support for C# and VB.NET (For LinqToXML)

     • MS SQL Server 2005
             With SQL Server Management Studio

     • GuidanceAutomationExtensions
             Можно загрузить с веб-сайта Microsoft

     • Catharsis ProjectBase
            Можно загрузить с веб-сайта http://www.codeplex.com/Catharsis/

ASP.NET MVC

Хотя данный инструмент не входит в список предварительных условий, но все будет работать, даже если он у вас уже установлен, однако необходимо, чтобы он был последней версии. Если вас одолевают сомнения, вы можете не использовать ASP.NET MVC в проектах и, используя ControlPanel, удалить его с вашего компьютера до установки Catharsis. Структура Catharsis содержит сборки ASP.NET MVC, поэтому вам не нужно устанавливать его заранее.

GuidanceAutomationToolkit

Если вам необходимо расширить функциональность Guidance, то данный инструментарий вам понадобится.

Операционная система, используемая при составлении руководства

При составлении руководства была использована операционная система Windows Server 2003 SP1.

После того, как требуемое ПО будет установлено, вы можете приступить к созданию нового приложения.

Вам следует пройти через следующие шаги:

Создание нового проекта
Создание базы данных
Запуск мастера настройки базы данных
Создание таблиц базы данных
Установка проекта StartUp
Проверка файлов конфигурации config.files
Запуск Catharsis

Создание нового проекта Catharsis

Щелкните по File -> New -> Project

Select ProjectBase.Guidance.

Задайте название своему приложению и выберите для него место расположения. Стоит следовать конвенции об именах типа MyCompany.MyApplication.

В старых версиях Catharsis не разрешалось использовать пробелы в названиях и путях к файлу при задании места установки. К примеру C:\Documents and Settings не сработало бы, но теперь все работает.

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

Создание базы данных

Откройте Microsoft SQL Server Management Studio. При установке MS SQL Server 2005 вас спросят о том, хотите ли вы установить сервер в качестве именованного экземпляра. Использование именованного экземпляра является хорошей практикой потому, что вы сможете запускать множество серверов на одной станции. В следующем примере имя компьютера равно AP325373 , а название именованного экземпляра сервера - MSSQL2005. Использование авторизации Windows будет наилучшим решением в таких случаях. Выберите именованный экземпляр, если он есть в наличии (в противном случае, выберите стандартное значение) и щелкните Connect (Соединиться):

Теперь щелкнете по опции "Databases" (базы данных) и выберите опцию добавления базы данных "Add Database":

Дайте базе данных название MyApplicationDB:

Теперь щелкните по закладке опций (Options):

Выберите простой уровень совместимости - Compatibility Level: Simple.

Щелкните по кнопке Ok и ваша база данных появится в списке справа:

Запуск мастера настройки базы данных

Теперь вернитесь в VS2008. Когда вы нажмете Ok в диалоговом окне создания нового проекта (New Project), откроется новое диалоговое окно с информацией о базе данных. Измените название базы данных на то, которое вы дали базе, созданной на прошлом этапе

Теперь щелкните по Finish и дождитесь завершения создания скелетной архитектуры для вашего проекта.

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

Окно с некоторой информацией по созданию скелетного кода может все еще находиться на экране, но это не так важно, поэтому вы можете его закрыть.

Создание таблиц базы данных

Согласно инструкциям в появившемся окне, нам теперь необходимо выполнить некоторые SQL-скрипты для создания таблиц, необходимых для структуры.

В VS2008 вам стоит найти каталог the DB_SQLServer и открыть первый скрипт:

Выберите весь текст и скопируйте его в буфер обмена.

Вернитесь обратно в MS SQL Server Management Studio. Щелкните правой кнопкой мыши по вашей базе данных и выберите опцию создания нового запроса ("New Query").

Теперь вставьте скопированный текст скрипта в данное окно. Измените имя базы данных, которую будет использовать скрипт со стандартного значения ‘Product’ на название вашей базы данных, в данном случае MyApplicationDB. Щелкните по кнопке Execute (Выполнить) - и скрипт, запустившись создаст необходимые таблицы базы данных

(Стоит заметить, что может появиться сообщение об ошибке о том, что невозможно найти хранимую процедуру MyApplicationDB (‘Could not find the stored procedure MyApplicationDB’) при попытке запуска скрипта. Если вы закроете MS SQL Server Management Studio и откроете его заново, то ошибка исчезнет).

Теперь запустите второй скрипт аналогичным образом. Данный скрипт заполнит таблицы данными. Не забудьте изменить имя базы данных.

Существует и третья таблица, которая содержит данные опциональных выражений создания таблицы для трекинга. Если вы хотите использовать встроенную функциональность структуры, отслеживающую изменения сущностей, то вам стоит также запустить и этот скрипт. Но этому стоит уделить отдельную статью.

Позаботьтесь о сообщении с предупреждением в SQL-скрипте:

/*
Для использования трекинга, разкомментируйте
1) Nhibernate.config ProjectBase.Data mapping
2) Data.hbm.TrackedBase.hbm.xml
*/

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

Установка начального проекта (StartUp)

Теперь нам необходимо выполнить остальные шаги из указанного в начале статьи списка.

Щелкните правой кнопкой по веб-проекту и выберите опцию установки стартового проекта (‘Set as Startup Project’).

Также вам стоит сделать это для файла Default.aspx внутри этого проекта.

Проверка файлов конфигурации

Теперь нам необходимо выполнить некоторые изменения, тем самым структура будет знать, как ей стоит осуществлять доступ к базе данных. Откройте файл web.config:

Найдите код для строки соединения:

  <connectionStrings>
    <add name="ProjectDB" connectionString="Data Source=.\SQL2005;Database=MyApplicationDB;Trusted_Connection=yes;"/>
  </connectionStrings>

Проверьте правильность названия базы данных. Все должно быть исполнено автоматически в случае, если вы создали базу данных до запуска, как было указано выше.

То же самое вам стоит выполнить в файле App.config тестового проекта.

Запуск Catharsis

Теперь мы готовы протестировать новое решение MyCompany.MyApplication.

Щелкните по меню Window -> Close All Documents

На данном этапе мы можем попробовать выполнить отладку решения. Щелкните по окну вывода, выбрав закладку Output в нижней панели VS2008 (Это стоит того, потому что вы можете увидеть, что происходит во время сборки ), и затем выберите ‘Rebuild Solution’ (Повторная сборка), как показано ниже. Мы используем повторную сборку решения вместо простой сборки потому, что это обеспечивает сборку каждой части приложения.

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

Теперь вам стоит щелкнуть по кнопке отладки (Debug) или нажать F5 и запустить приложения.

Вывод

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

Следующие шаги

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

Автор: David O'Sullivan

Дополнительная информация

Исходный код для Catharsis вы можете загрузить по данной ссылке:
http://www.codeplex.com/Catharsis

форум c# asp net