65.9K
CodeProject 正在变化。 阅读更多。
Home

Catharsis 教程 01 - 安装 Catharsis

David O'Sullivan
starIconstarIconstarIconstarIconstarIcon

5.00/5 (1投票)

2009 年 6 月 28 日

CPOL

6分钟阅读

viewsIcon

24381

downloadIcon

45

安装 Catharsis 和设置 Catharsis 解决方案的详细指南。

引言

本文档概述了一个简单的分步过程，包含在计算机上安装 Catharsis 框架并创建 Catharsis 解决方案所需了解的一切。

附加信息

Catharsis 的作者 Radim Köhler 在 CodeProject 上发布了许多关于 Catharsis ASP.NET MVS 框架的文档，可以在 此处找到。

Catharsis 的源代码可以在 此处找到。

本系列的其他教程可以在 此处找到。

本文档的可打印 Word 版本可在 此处下载。

必备组件

将需要以下先决条件

  • .NET Framework 3.5 SP1
  • Visual Studio 2008
    • Team System 2008
    • 支持 C# 和 VB.NET (用于 LinqToXML)
  • Microsoft SQL Server 2005
    • 以及 SQL Server Management Studio
  • GuidanceAutomationExtensions
    • 从 Microsoft 下载
  • Catharsis ProjectBase

ASP.NET MVC

这不是先决条件，但如果您已安装最新版本，它将正常工作。如有疑问，并且您不需要 ASP.NET MVC 用于任何其他项目，请使用 ControlPanel 在安装 Catharsis 之前将其从计算机中删除。Catharsis 框架包含 ASP.NET MVC 程序集，因此您实际上不需要安装它。

catharsis_tutorial_01_001.png

GuidanceAutomationToolkit

如果您打算扩展 Guidance 的功能，则需要此项。

教程中使用的操作系统

本教程中使用的操作系统是 Windows Server 2003 SP1。

安装完所需软件后，您就可以开始创建新应用程序了。

以下步骤将指导您完成整个过程

  1. 创建新的 Catharsis 项目
  2. 创建数据库
  3. 运行数据库向导
  4. 创建数据库表
  5. 设置启动项目
  6. 检查 config.files
  7. 运行 Catharsis

创建新的 Catharsis 项目

点击 文件 -> 新建 -> 项目

catharsis_tutorial_01_002.png

选择 ProjectBase.Guidance。

catharsis_tutorial_01_003.png

给您的应用程序命名，并为其指定文件位置。使用命名约定，例如 MyCompany.MyApplication，是一个好习惯。

在 Catharsis 的旧版本中，安装位置的文件路径不允许包含空格。例如，C:\Documents and Settings 将无法工作，但现在已修复。

在继续进行设置的下一步之前，最好先创建应用程序将使用的数据库。

创建数据库

打开 Microsoft SQL Server Management Studio。安装 Microsoft SQL Server 2005 时，会询问您是否要将服务器安装为命名实例。使用命名实例是一个好习惯，因为它允许多个服务器在同一台计算机上运行。在下面的示例中，计算机名称为 AP325373 ，命名实例的名称为 MSSQL2005。使用 Windows 身份验证是我们目的的最佳选择。选择命名实例（如果存在，否则选择默认实例），然后点击连接。

catharsis_tutorial_01_004.png

现在右键单击“数据库”并选择“添加数据库”。

catharsis_tutorial_01_005.png

给数据库命名，在本例中我们将使用 MyApplicationDB 。

catharsis_tutorial_01_006.png

现在点击“选项”选项卡。

选择兼容性级别：简单。

catharsis_tutorial_01_007.png

点击“确定”，您的新数据库将出现在右侧的列表中。

catharsis_tutorial_01_008.png

运行数据库向导

现在回到 VS2008。当您在“新建项目”对话框中点击“确定”后，将出现一个新的对话框，询问有关数据库的信息。将数据库名称更改为与您在上一步中创建的数据库匹配。

catharsis_tutorial_01_009.png

现在点击“完成”，然后等待框架为您的项目创建骨架架构。

完成后，将显示一个弹出窗口，概述接下来需要做什么。

catharsis_tutorial_01_010.png

屏幕上可能还会显示一个关于骨架代码创建信息的窗口。现在不用管它，只需关闭该窗口即可。

catharsis_tutorial_01_011.png

创建数据库表

因此，根据弹出窗口中的说明，我们将运行一些 SQL 脚本来创建框架所需的表。

在 VS2008 中，找到 DB_SQLServer 文件夹并打开第一个脚本。

catharsis_tutorial_01_012.png

选择所有文本并将其复制到剪贴板。

回到 Microsoft SQL Server Management Studio。右键单击您的数据库并选择“新建查询”。

catharsis_tutorial_01_013.png

现在将 SQL 脚本中的文本粘贴到窗口中。将脚本将运行的数据库名称从默认的“Product”更改为您数据库的名称，在本例中为 MyApplicationDB 。点击“执行”按钮，脚本将运行以创建您需要的数据库表。

catharsis_tutorial_01_014.png

(注意：在尝试运行脚本时，可能会出现一条错误消息，指出“找不到存储过程 MyApplicationDB”。如果关闭 Microsoft SQL Server Management Studio 并重新打开它，则有助于解决此问题）。

现在以相同的方式运行第二个脚本。此脚本将用一些数据填充表。再次记住更改数据库名称。

catharsis_tutorial_01_015.png

还有一个包含可选 create table 语句以进行跟踪的数据的第三个表。如果您想使用框架内置的实体更改跟踪功能，也应运行此脚本。跟踪将在后续文档中进行介绍。

catharsis_tutorial_01_016.png

请注意 SQL 脚本中的警告消息。

/*
To use tracking also uncomment 
1) Nhibernate.config ProjectBase.Data mapping
2) Data.hbm.TrackedBase.hbm.xml
*/

我们将在后续教程中处理此问题。

设置启动项目

现在我们需要处理 Catharsis 显示的“待办事项”列表弹出窗口中剩余的项目。

右键单击 Web 项目，然后选择“设置为启动项目”。

catharsis_tutorial_01_017.png

同样，对该项目中的 Default.aspx 文件也这样做。

检查配置文件

现在我们需要进行一些更改，以便框架知道如何访问我们的数据库。打开 web.config 文件。

catharsis_tutorial_01_018.png

找到连接字符串的代码。

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

检查数据库名称是否正确。如果按照上述步骤在运行 Guidance 之前创建了数据库，则此项应自动处理。

在测试项目的 App.config 文件中也需要执行相同的操作。

catharsis_tutorial_01_019.png

运行 Catharsis

现在我们可以测试新的解决方案 MyCompany.MyApplication 了。

点击菜单 窗口 -> 关闭所有文档。

现在尝试调试解决方案。通过在 VS2008 中选择底部窗格中的“输出”选项卡来点击输出窗口（这是一个好习惯，因为它允许您在生成过程中查看正在发生的事情），然后选择“重新生成解决方案”，如下图所示。我们使用重新生成而不是生成，因为这确保了应用程序的每个部分都将被生成。

catharsis_tutorial_01_020.png

在执行重新生成之前，某些引用可能显示为损坏，但重新生成将解决此问题。

现在点击“调试”或按 F5 运行应用程序。

catharsis_tutorial_01_021.png

摘要

如果没有发生任何问题，则应能在十分钟内完成。结果是您拥有了一个完整的、多层架构，可以以此为基础来构建您的应用程序，而无需花费大量精力进行规划和从头编写架构。

如果任何用户在安装时遇到问题，请告知我，我们将共同找到解决方案，提供有关您的系统以及上述所有先决条件状态的信息显然很重要。

下一步

现在您已经安装了 Catharsis，是时候看看您可以如何使用它了。在下一个教程中，我们将介绍 Catharsis 示例解决方案，您将在此处看到 Catharsis 框架如何处理实体。

本系列的其他教程可以在 此处找到。

历史

  • 2009年6月28日：初始发布
© . All rights reserved.