javaeye博客的收藏管理页面,收藏分类是通过下拉列表选择来录入已有分类标签的,这个功能非常方便实用,因为不用死记旧标签,还提高了标签的录入效率,于是决定自己模仿也搞一个。
在开始之前,先说明一下,以下的模仿过程全部处于FleaPHP框架之下,数据库为MySQL。
以下为功能实现的整个过程。
第一步:相关数据表准备
先创建一个文章管理数据表articles,该表含有一个自增量字段art_id。
接着创建一个分类标签数据表tags,其表结构如下图所示:
再创建一个中间表articles_tags,其表结构如下图所示:
第二步:编写数据表对象代码
1、编写文章数据表对象代码。如下所示:
<?php
FLEA::loadClass('FLEA_Db_TableDataGateway');
/**
* 文章数据表对象
*/
class Table_Articles extends FLEA_Db_TableDataGateway
{
var $tableName = 'articles';
var $primaryKey = 'art_id';
/**
* 定义多对多关系
*
*/
var $manyToMany = array(
array(
'tableClass' => 'Table_Tags',
'joinTable' => 'articles_tags',
'foreignKey' => 'art_id',
'assocforeignKey' => 'tag_id',
'mappingName' => 'tags',
'enabled' => false
)
);
}
?>
2、编写分类标签数据表对象代码。如下所示:
<?php
FLEA::loadClass('FLEA_Db_TableDataGateway');
/**
* 分类标签数据表对象
*/
class Table_Tags extends FLEA_Db_TableDataGateway
{
var $tableName = 'tags';
var $primaryKey = 'tag_id';
}
?>
第三步:编写模型对象类代码
1、编写分类标签模型对象类代码。如下所示:
<?php
/**
* 分类标签模型对象类
*/
class Model_Tags
{
var $_tblTags;
/**
* 构造函数
*
*/
function Model_Tags()
{
$this->_tblTags = & FLEA::getSingleton('Table_Tags');
}
/**
* 生成标签下拉列表HTML代码
*/
function makeTagsDropdownlist()
{
$ui = & FLEA::initWebControls();
FLEA::loadFile('FLEA_Helper_Array.php');
$rows = $this->_tblTags->findAll();
// 增加一个下拉选择项在最前面
array_unshift($rows, array('tag_id' => 0, 'label' => '选择已有分类'));
$items = array_to_hashmap($rows, 'label', 'tag_id');
return $ui->control(
'dropdownlist',
'tagsel', // 下拉列表ID
array(
'items' => $items,
//'selected' => null,
),
true // 指示返回html代码,如果为false,则不返回
);
}
}
?>
2、编写文章模型对象代码。如下所示:
<?php
/**
* 文章模型对象
*/
class Model_Articles
{
var $_tblArt;
/**
* 构造函数
*
*/
function Model_Articles()
{
$this->_tblArt = & FLEA::getSingleton('Table_Articles');
}
/**
* 完成对文章条目所关联的 tags 的处理
*
* @param array $row
*/
function _processTags(& $row) {
// 读出数据库现有的所有 tags
$tblTags = & FLEA::getSingleton('Table_Tags');
$rows = $tblTags->findAll(null);
FLEA::loadFile('FLEA_Helper_Array.php');
$existsTags = array_to_hashmap($rows, 'label', 'tag_id');
// 处理用户输入的 tags
$labels = explode(',', $row['tags']);
//$labels = explode(',', $tags);
$tagsIdList = array();
foreach ($labels as $label) {
$label = strtolower(trim($label));
if ($label == '') {
continue;
}
if (isset($existsTags[$label])) {
// 将文档登记到现有 tag
$tagsIdList[] = $existsTags[$label];
} else {
// 创建新 tag,并登记文档
$tag = array('label' => $label);
$tagsIdList[] = $tblTags->create($tag);
}
}
$row['tags'] = $tagsIdList;
//return $tagsIdList;
}
/**
* 新增文章
*
* @param array $row
* @return int
*/
function create(& $row) {
$this->_processTags($row);
$this->_tblArt->enableLink('tags');
return $this->_tblArt->create($row);
}
/**
* 更新文章
*
* @param array $row
* @return int
*/
function update(& $row) {
$this->_processTags($row);
$this->_tblArt->enableLink('tags');
return $this->_tblArt->update($row);
}
}
?>
第四步、编写HTML模板代码
因为要利用到jQuery,所以模板文件要引入jQuery库文件。如下所示:
<!-- // 引入 jQuery 库文件 -->
<script type="text/javascript" src="jquery-1.4.2.min.js"></script>
模板文件中与标签相关的HTML代码:
<tr>
<td>分类标签:</td>
<td><input name="tags" type="text" id="tags" size="30" />
{{ $art.taglist }}*多个标签之间用半角逗号分隔</td>
</tr>
编写选择录入已有标签的JavaScript代码:
<script type="text/javascript">
$(function() {
$("#tagsel").change(function(){
var txt = $("option:selected", this).text();
if (txt == '选择已有分类') {
txt = '';
} else {
var label = $("#tags").val();
if (label) {
txt = label + ', ' + txt;
}
}
$("#tags").val(txt);
});
});
</script>
第五步:编写后台文章控制器类代码
<?php
/**
* 办公网站后台管理——文章管理控制器类
*
* 文 件 名:Admin/Controller/Article.php
* 作 者:hegz
* 更新时间:2010/05/07
*
*/
/**
* 装入后台管理控制器基类
*/
//{{
FLEA::loadClass('Controller_AdminBase');
//}}
class Controller_Article extends Controller_AdminBase
{
var $_modelArt;
/**
* 构造函数
*
*/
function Controller_Article()
{
parent::Controller_AdminBase();
$this->_modelArt = & FLEA::getSingleton('Model_Articles');
}
/**
* 显示新增文档界面操作
*
*/
function actionAdd()
{
......
$tags = & FLEA::getSingleton('Model_Tags');
$data = array(
'header' => '攒写文档',
'action' => $this->_url('Save'),
'taglist' => $tags->makeTagsDropdownlist() // 注意此句代码,生成下拉列表HTML代码
);
......
$this->tpl->assign('art', $data); // Smarty模板引擎变量替换
......
}
/**
* 保存文档操作
*
*/
function actionSave()
{
$data = $_POST;
......
if ($data['art_id']) {
$this->_modelArt->update($data);
$art_id = $data['art_id'];
} else {
$art_id = $this->_modelArt->create($data);
}
......
}
}
结束语
上面的实现过程由于要考虑新标签的保存及旧标签的处理,以及文章表与标签表的多对多关联,所以看上去有些复杂。如果不考虑这些实现,就只是下面几行处理标签录入的JavaScript代码的事。
<script type="text/javascript">
$(function() {
$("#tagsel").change(function(){
var txt = $("option:selected", this).text();
if (txt == '选择已有分类') {
txt = '';
} else {
var label = $("#tags").val();
if (label) {
txt = label + ', ' + txt;
}
}
$("#tags").val(txt);
});
});
</script>
最后,实现的效果如下图所示: