#1 jake

从前面的留言本例子,我们可以看到使用sp框架进行开发,在查找和新建数据库记录的时候是不需要使用SQL语句的,而且非常的简单易用。下面我们就来详细地介绍一下在sp框架中简便的数据表操作。使用数据库,首先是需要应用程序配置,留言本中使用了以下的配置:

"db" => array( // 数据库设置
                'host' => 'localhost',  // 数据库地址,一般都可以是localhost
                'login' => 'root', // 数据库用户名
                'password' => '123456', // 数据库密码
                'database' => 'test', // 数据库的库名称
        ),
如果您是使用虚拟主机,上面的数据库设置请咨询您的主机服务商。如果您是使用SpeedAMP进行开发的话,默认的配置就是上面所写的。
配置好了我们的应用程序后,就可以对每一个数据表,都在model目录下新建一个数据模型类文件。如留言本中的guestbook文件一样。数据模型类文件可以很简单:

class guestbook extends spModel
{
  var $pk = "id"; // 数据表的主键
  var $table = "guestbook"; // 数据表的名称
}

这里要注意的是文件名需要和类名相同,然后设置主键和表名即可。

接下来我们就可以在我们的controller程序里面直接使用find/findAll,create之类的函数来替代mysql函数和SQL语句了。这里我们介绍几个常用的函数:

findAll

按条件查找记录,返回数组

findAll($conditions)的$conditions是条件,可以为空,也可以是数组或者字符串。比如留言本中:

$guestbook = spClass("guestbook");
if( $result = $guestbook->findAll() ){

$conditions留空代表着查出表中的全部记录。

$conditions为字符串,那么字符串代表的就是查询条件,如$conditions = " name = 'jake' ";那么将查找“留言者名称是jake”的全部记录。如$conditions = " name = 'jake'  AND title = '我是标题"; 将查找“留言者名称是jake,同时留言标题是‘我是标题’”的全部留言。

$conditions为数组,那么每项分别是一个条件,比如:

$conditions = array("name" => 'jake' , "title" => '我是标题");和$conditions = " name = 'jake'  AND title = '我是标题";是一样的。

改写后的main.php就是:

...
        function index(){ // 这里是首页
                $posturl = spUrl("main", "write"); // 用spUrl制造写留言的地址
                echo "

我的留言本

";
                // 下面做一个表单来提交留言,请注意这些输入框的name属性,它们都对应了数据表guestbook的字段名!
                echo "

请写下您的留言:

您的名字:

留言标题:

留言内容:

";
                $guestbook = spClass("guestbook"); // 用spClass来初始化留言本数据表对象(模型类对象)       
                $conditions = array("name" => 'jake' , "title" => '我是标题');
                if( $result = $guestbook->findAll($conditions) ){ // 用findAll将“留言者名称是jake,同时留言标题是‘我是标题’”的留言查出来
                        foreach($result as $value){ // 循环输出留言信息
                                $contentsurl = spUrl("main", "show", array('id'=>$value['id'])); // 用spUrl制造查看留言内容页面地址,请注意array('id'=>$value['id'])将传递ID到查看页面,由spArgs来接收。
                                echo "

这里是第{$value['id']}条留言:{$value['title']}  {$value['name']}

";
                        }
                }
        }
...       
发几条留言,其中有的是符合条件而有的不是,那么我们就可以看出结果来了。

guestbookfindall[1].jpg

find

查找符合条件的第一条记录

和findAll不同,find仅是查找并返回第一条符合条件的记录。在留言本中:

...
        }
        function show(){ // 这里是查看留言内容
                $id = $this->spArgs("id"); // 用spArgs接收spUrl传过来的ID
                $guestbook = spClass("guestbook");  // 还是用spClass
                $conditions = array('id'=>$id); // 制造查找条件,这里是使用ID来查找属于ID的那条留言记录
                $result = $guestbook->find($conditions);  // 这次是用find来查找,我们把$condition(条件)放了进去
                // 下面输出了该条留言内容
                echo "

留言标题:{$result['title']}

";
                echo "

留言者:{$result['name']}

";
                echo "

留言内容:{$result['contents']}

";
        }
        function write(){ // 这里是留言
...       

使用了find($condition)来查找ID符合条件的记录,然后显示出来。我们可以看到,find获得的结果数组,也与findAll不同。find的结果是一个由字段名组成的数组,而findAll是每个数组项都像一个find的结果。

create

新增一条记录

create用起来很容易,只要我们把一个有着“字段名对应数值”的数组放到create里面,那么就可以在数据表中新建一条记录了。在留言本中,我们是直接将表单提交的数据,也就是spArgs获取到的数据放到create里面的:

...
        function write(){ // 这里是留言
                $guestbook = spClass("guestbook");
                $guestbook->create($this->spArgs()); // 这里用$this->spArgs()取得了表单的全部内容,然后增加了一条留言记录
                echo "留言成功,返回";
        }
...       
我们可以更详细点写以上的代码:
...
        function write(){ // 这里是留言
                $guestbook = spClass("guestbook");
                $newrow = array(
                        'name' => $this->spArgs('name'),
                        'title' => $this->spArgs('title'),
                        'contents' => $this->spArgs('contents'),
                );
                $guestbook->create($newrow);
                echo "留言成功,返回";
        }
...       
这个和前面的效果是一样的。我们就可以清晰地看到,create($newrow)的$newrow里面是字段名和值的对应了。为什么没有id这个字段呢?是因为id本身是自增量,所以不需要出现在这里,它是会自动赋值的。
这里我们介绍一下spArgs,在表单中提交的数据,(还有