DbEntry 开发实践：Wiki 系统（一）

有人在网站给我发短消息，希望我多写一些 DbEntry 开发的文章，我想，关于细节问题，还是看 DbEntry 的主页的文档比较好，如果真的要写，我倒觉得，以一个真实系统的开发实践作为题目更有意义些。

　　所以，这里我将会介绍一个真实的，非常小的，用 DbEntry 开发的 Wiki 系统的流程，其中不止涉及 DbEntry，还会包括其它一些开发流程中的问题、方法、工具等。

　　在开始项目前，先介绍几个我目前使用的 Visual Studio 2008 集成工具：

Resharper，这个工具目前对我几乎是必不可少了，它提供了很多方便的功能、直观的提示、重构能力以及对于单元测试的支持。因为它提供了对单元测试的支持，我也放弃了另外一个很好的的单元测试工具 TestDriven.Net。不过，TestDriven.Net 提供更强大的单元测试支持，比如覆盖率工具，所以也是一个值得安装的工具。
VisualSVN，是的，我使用 SVN，所以可以用 VisualSVN Server 在 Windows 上方便的安装一个 SVN 服务器，而且，codeplex也支持SVN客户端，相比之下，TFS 的安装可谓繁琐、资源占用也多得多。对于单机用户，TortoiseGit 也许是个不错的选择，不过，我的测试发现，其成熟度还有待提高，比如在 Git Bash 里可以输入用户名和密码的地方，TortoiseGit 的 GUI 却直接显示失败，另外，对于中文文件名的支持也不好。
在 DbEntry 的源码目录内，有一些 snippet 文件，建议安装到 Visual Studio 里，之后，可以输入 dbmodel 然后按 tab 键生成 Model 的基础架构，输入 aprop 然后按 tab 键生成抽象属性，输入 test 然后按 tab 键生成单元测试函数框架等。

　　好的，这个 Wiki 系统的需求如下：

要是一个可视化编辑的系统；
要有历史浏览功能；
它的 Url 必须是可以被加入收藏夹的；
它应该有一个导航条；
它需要有一个登录管理系统。

　　关于可视化编辑，我认为是必需的，因为我实在不愿意去记忆那些 Wiki 语法，相信其他人也一样。但是，见到的很多 Wiki 系统都使用 Wiki 的特殊语法，所以我称这个 Wiki 系统为 Visual Wiki。SharePoint 倒是提供了一个可视化编辑的 Wiki，只是如果只想要一个 Wiki 而去安装 SharePoint 的话，有点儿小题大作了。可视化编辑部分，使用 FckEditor 来实现，它有 .net 控件版本，所以我们不需要太关心它是怎么实现的。

　　好，基础的准备工作做完了，我们开始建立 VisualWiki 解决方案，其中有 3 个项目，VisualWiki 是 WebSite，VisualWiki.Models 是 Models 和一些辅助类，VisualWiki.UnitTests 是单元测试，3个项目都基于.Net Framework 3.5，3个项目都引用4个DbEntry.Net 的 DLL，另外，VisualWiki需要添加FredCK.FCKeditorV2.dll以及VisualWiki.Models的引用，VisualWiki.Models需要添加System.Web的引用，VisualWiki.UnitTests需要添加nunit.framework.dll以及VisualWiki.Models的引用，建好的项目目录如下：

　　我在以前的留言里说过，DbEntry鼓励使用Sqlite作为开发数据库，而部署使用其他大型数据库，这里我们就使用Sqlite。打开web.config，Visual Studio已经为我们生成了一大堆垃圾代码，在开始的configSections段里，添加：

　　然后在configSections段后，添加Lephone.Settings段，其中，我希望可以在Debug窗口看到生成的SQL，希望数据库表名使用复数形式，希望使用自动生成表功能，希望可以简单的切换Sqlite和Sql Server，所以，设置如下：

<Lephone.Settings>

　　这里使用的是Sqlite .net provider 的1.0.60.0版本，你需要先安装它，另外，你的版本如果不同，修改其中的版本号部分。

　　为了方便，同时找到pages段，修改它，这个修改可以为以后节省一些页面里的声明：

　　首先在VisualWiki.Models里建立Article类，它应该有标题，内容和保存时间，并且为它添加一个静态的FindByTitle方法：

namespace VisualWiki.Models

{
    public abstract class Article : LinqObjectModel<Article>
    {
        [Length(1, 255), Index(UNIQUE = true)]
        public abstract string Title { get; set; }

        public abstract string Content { get; set; }

        [SpecialName]
        public abstract DateTime SavedOn { get; set; }

        public abstract Article Init(string title, string content);

        public static Article FindByTitle(string title)
        {
            return FindOne(p => p.Title == title);
        }
    }
}

　　然后删除WebSite里的Default.aspx，增加一个Global.asax，并修改其中的Application_Start函数，用来初始化一篇Article：

void Application_Start(object sender, EventArgs e)

{
    if(Article.GetCount(null) == 0)
    {
        Article.New.Init("Hello", "this is home page of whole world.").Save();
    }
}

　　然后添加一个不使用代码分离的母板页Main.master，添加一个使用它，而且不使用分离代码的页面Show.aspx，这个aspx页面接受一个title参数，用以取得相应的Article，其中需要添加一个Label用于显示Wiki的内容，所以修改此aspx的代码如下：

<%@ Page Title="" Language="C#" MasterPageFile="~/Main.master" %>

　　现在，运行程序，Show.aspx页面将会显示一个异常：The Parameter title can't be empty。所以，我们在url后面添加参数?title=Home，然后回车，页面显示：The wiki page does not exist. The page will be created the first time you edit it。修改参数为Hello，回车，则显示：this is home page of whole world。在Visual Studio的View菜单里打开Output窗口，可以在其中看到ORM系统生成的SQL语句。VisualWiki的App_Data目录下也已经生成了Sqlite的数据库wiki.db，我们可以用SqlQuerier打开此数据库，检查articles表中的记录。

　　至此，我们的程序第一次可以运行，而且自动建立了数据库及表articles，并生成了一条记录，我们的Show.aspx也可以初步的根据title参数显示相应的wiki内容了。当然，后续还有很多工作要做，我们将会不断的强化和重构这个程序，最终达到需求中的各项要求。目前的代码可以在这里下载：VisualWiki.zip

　　未完待续……

posted @ 2009-12-01 10:56 梁利锋阅读(3346) 评论(17) 编辑收藏举报

刷新页面返回顶部

梁利锋

DbEntry 开发实践：Wiki 系统（一）

公告