XCode之第一次亲密接触

首先得说明，本教程仅用于让第一次接触XCode的朋友了解XCode，不具有任何别的实际意义，真正的项目也不会采取这种开发方式，而采用更先进、快速而强大的开发方式。

NewLife.XCode是一个数据映射框架，包括但大于ORM的范围。XCode意为未知的代码的意思，是整个X系列组件很重要的一员。实际项目开发，会根据项目类型不同，应用场合不同，由多个不同的组件配合发力，这就导致了几乎无法发现XCode在其中的用处，而XCode的学习，也就无从做起。按某朋友的说法：“想看看这个页面怎么工作，结果页面后面一行代码也没有，深入一点发现全是接口！”

所以，本教程从最最最通俗的做法谈起，先使用纯XCode实现，然后一步步的引入其它组件，让大伙明明白白最终项目是如何工作的！

这次我们做一个最简单的CMS，只有管理员、栏目、文章三张表，字段也是最精简的。后面会针对这个例子，一步步展开，介绍XCode的各个主要功能。

关于XCode的层次介绍参看《ORM组件XCode（简介）》

作为入门的更有深度的姐妹篇《ORM组件XCode（动手）》

一、数据库

最原始的做法，我们先到MSSQL里面建立好数据表，我这里是MSSQL2008，你用别的版本或者别的数据库也没有关系。

管理员表，只要用户名和密码，我们弄一个自增ID的字段作为主键。用别的比如GUID作为主键也行，最好有一个单一主键，那样会方便一些，后面会讲到。

栏目表，我们先不考虑多级，只要一级，那样子只需要一个名称字段就足够了。注意设置ID字段为主键和标识。

文章表，需要跟栏目表建立管理关系，然后有标题和内容。注意设置ID字段为主键和标识。

这样子就建好了最简单的三张表。

二、生成实体类

很多ORM都有配套的代码生成器，下面我们请出我们的代码生成器XCoder，注意，这里是XCoder，意为未知编码者，而前面是XCode。这个刚解压后的样子，一个主程序，三个类库，一个配置文件。

启动主程序。这里也许它会自动升级，不用担心，升级会自动完成。

很土的界面，不过没关系啦，这个XCoder就是一个很简单的空壳子（开放源码），真正的使用者会用自己的修改版，或者使用更先进的魔方开发平台。

我们看看“连接”右边的下来菜单，看看都有哪些连接：

这是配置文件里面内置的一些连接，每一种数据库的都有，其实是连接字符串的样板，省得用到时找不到。XCoder在这里有自动探测功能，能够探测本机的MSSQL，本目录的Access和SQLite。

可以看到mssql_CMS那个就是我们刚才建立的库，为了加深理解，我们手工去配置一下。

关闭XCoder，打开配置文件“XCoder.exe.config”：

这里是最常用的一些设置，我们重点看连接字符串部分，增加一个名为CMS的连接：

这个name就是在连接名，将会在前面代码生成器界面的“连接”下拉里面列出。重新打开代码生成器看看：

我们刚添加的CMS在第一位，后面也多了好些，我们不用去管它。

点击“连接”按钮吧，下面的数据表选择就激活了：

这里可以见到我们刚才添加的三张表。右边的两个生成按钮也亮了，也就是说可以生成了。不过先别着急，我们看看下面的各个设置框，重点是右边的模版：

先看右边的模版，有六个带星号开头的模版，星号表示内置模版，如果感兴趣，可以点右边的“释放内置模版”按钮，把它们释放出来到文件中，学习一下怎么写模版也行，这里就不多说了。

这次我们主要是想生成实体类代码，要用到实体数据和实体业务两个模版，因为一个实体类由两个文件采用分部类的方式组成，如果修改了数据库表结构，下次只需要生成实体数据那个文件即可，而开发者自己写的代码都写在实体业务那个文件里面。

我们修改一下左边的设置：

命名空间就是要生成的实体类的命名空间，连接名也是实体类里面的一个模版变量，输出目录自然就是实体类文件要存放的目录啦，相对于代码生成器根目录。

一切准备就绪，选择实体数据模版，点击“生成所有表”按钮，然后换成实体业务模版，再生成所有一次。

下面我们去看看MyCMS目录，我们生成的东西在那：

都在这！每个表两个文件，带Biz的是业务文件，供手写代码的，另一个就是数据文件，方便数据表结构变更时重新生成覆盖。

先看看实体数据文件：

上面这个命名空间，就是刚才代码生成器那里填写的；下面这个ConnName就是代码生成器那里填写的连接名。

再看看实体业务文件：

命名空间和类型，跟数据实体是一样的，注意那个partial关键字，表示分部类的意思，一个类分成两个文件存放。绝大部分ORM的实体类都这么干。

这个类继承自Entity<Admin>，其中Entity<>是泛型基类，也就是XCode实体层的核心，实体类的绝大部分功能都由它提供。这个对应于代码生成器上的“实体基类”，有些时候可能需要使用自己的实体基类。

下面有很多代码段，里面几乎都是一些注释，告诉用户最常用的一些功能怎么用怎么写。

三、建立站点

实体类都生成好了，我们开始建立项目吧。一个CMS解决方案，包括一个CMS类库和一个Web站点（Website）。

把那个Class1.cs删了，把上面生成的实体类文件放进去，设置站点Web引用类库CMS。

开始编译一下看看。

真是壮观呀！原来是我们忘记引用XCode了。把我们准备好的DLL放进来，跟Web和CMS目录并排。（XCode.dll依赖于核心库NewLife.Core.dll）

类库CMS引用这两个DLL，网站就不需要引用了，因为网站引用了类库，XCode那些会跟着过来的。再编译！

这回编译通过了！

给web.config设置一些常用设置，当然最重要的就是数据库连接字符串；

打开全局调试开关和XCode调试开关，主要是为了看到完整的XCode工作日志。

我们先在默认页Default.aspx写一段测试代码看看，同时也是给系统增加一个管理员帐号：

这段代码很简单，调用实体类的静态方法Find去查找UserName为admin的对象，如果没找到，就实例化一个，然后分别给两个属性赋值，再保存Save回去，这样子就往数据库插入了一条记录。

不要忘了引用实体类的命名空间“NewLife.CMS”，这样才能使用实体类Admin。

这算是第一段使用XCode的代码，赶紧的预览页面看看效果：

执行成功！到这里，一个只有实体类的空白站点就建立了。

四、后台登录

建立一个后台目录Admin，包括后台首页Default.aspx和登录页Login.aspx。

设计登录页，登录成功后跳转到后台首页。后台首页如果发现没有登录就跳转到登录页。

这里也不要忘了引用实体类命名空间“NewLife.CMS”。预览页面看看效果！

关于XCode里面添删改查等完整代码操作参看《ORM组件XCode（速览）》

五、建立后台

我们在后台目录Admin中增加一个用来管理管理员的页面Admin.aspx，然后调整一下后台首页Default.aspx，让它作为后台导航页，通过菜单链接到其它管理页面Admin.aspx和AdminForm.aspx。

下面开始设计Admin.aspx，这个作为一个列表页，把该表所有数据列出来。我们采用经典的GridView+ObjectDataSource来实现。

如果你是第一次使用ObjectDataSource，这里可要看好了。ObjectDataSource的右边有个智能标记，一个小箭头，可以点开。我们选择“配置数据源”，看看神奇的一幕。

ObjectDataSource的设计界面列出来我们的所有实体类，Select那里列出来一个Search方法（XCode的Entity<>基类内置），还有Update、Insert和Delete也有（也是内置）。我们先默认，一路下去。（在这里，各个DLL的版本一定要对应，重点是XCode.dll和NewLife.Core.dll，否则ObjectDataSource将可能无法列出实体类）

选择GridView，打开智能标记，选择数据源为下面这个ObjectDataSource。

预览看看效果：

出来了！没有写一行代码，数据就列出来了。

我们修改一下根目录的Default.aspx，往数据库里面添加50个管理员数据。

（Admin.Meta.Count是返回Admin实体对应的数据表的总记录数）

现在再来看看前面的管理员列表

全都列出来了，但是没有分页呀。

现在开始设置一下ObjectDataSource

EnablePaging设为true，表示支持分页，SelectCountMethod设为SearchCount，这个也是实体基类内置方法，它跟前面的Search方法是一对，具有完全相同的参数列表，startRowIndex和maximumRows就是其中的两个。SortParameterName设为orderClause，表示排序的那一个参数，也是Search的参数之一。