07第六章迭代3添加任务Task.docx
《07第六章迭代3添加任务Task.docx》由会员分享，可在线阅读，更多相关《07第六章迭代3添加任务Task.docx（53页珍藏版）》请在冰豆网上搜索。
07第六章迭代3添加任务Task
第六章：
迭代3：
添加任务（Task）
在上一个迭代中，我们交付了与项目（Project）实体相关的基本功能。
项目（Project）是TrackStar应用的基础。
但是，项目（Project）本身用处并不是很大。
我们希望使用这个应用来管理问题（Issue），而项目（Project）只是问题（Issue）的基本容器。
由于管理项目（Project）中的问题（Issue）是开发这款应用的主要目的，所以我们将这个迭代主要用于添加一些基本的问题（Issue）管理功能。
迭代计划
我们已经有了创建和列出项目（Project）的功能，但是这些项目（Project）还不能包含任何东西。
在这个迭代结束后，我们希望应用程序能提供所有关于问题（Issue）或者说任务（Task）的CRUD（增删改查）操作（我们会交替使用术语问题（Issue）和任务，但是在我们的数据模型中，一个任务实际上只是问题（Issue）的一种）。
我们还需要将所有对问题（Issue）进行的CRUD操作，限制在一个特定的项目（Project）上下文中进行。
也就是说，问题（Issue）是从属于项目（Project）的。
在进行任何对问题（Issue）的CRUD操作之前，用户必须首先选定一个已经存在的项目（Project）并在该项目（Project）之下进行工作。
为了实现上述目标，我们需要识别出所有要在此迭代中完成的细化工作。
下面的列表是对这些工作的概括：
▪设计数据库结构，创建对象来支持问题（Issue）
▪创建Yii模型类，使应用能够简单地与我们创建的数据库表交互
▪创建控制器类，来容纳我们需要的功能，包括：
o创建新问题（Issue）
o从数据库中取回项目（Project）中问题（Issue）的列表
o更新、编辑问题（Issue）
o删除问题（Issue）
创建试图来为这些动作（上述的）生成用户界面
这些信息已经足够我们开始干活了。
运行完测试后，我们开始做一些必要的数据库修改。
运行测试套件
在深入到开发工作中之前，运行已经存在的测试套件，总是一个非常好的主意。
我们的测试套件在上一个迭代的时候增长了一点。
现在我们已经有了对项目（Project）进行CRUD操作和数据库链接的测试。
把它们一起再运行一次。
打开测试文件夹，/protected/tests/unit，然后运行所有单元测试：
SHELL代码或屏幕回显：
%phpunitunit/
PHPUnit3.3.17bySebastianBergmann.
.....
Time:
0secondsOK（5tests,11assertions）
都通过了。
让我们开始进行修改。
设计数据库结构
回到第3章TrackStar应用，我们提出了一些关于问题（Issue）的初始想法。
我们假设它有类型、所有人、请求人（requester）、状态和描述等自然属性。
还提到了当我们创建了表tbl_project的时候，会给每个表添加基本的审计历史信息，用于跟踪更新了表的用户、日期和时间。
在这个过程中，需求并没有发生改变，所以我们可以继续进行初始的计划。
但是，类型、所有人、请求人和状态这些属性本身就是它们自己的实体。
为了保持模型的弹性和扩展性，我们会对这些属性分别建模。
所有人和请求人都是系统的用户，将会指向tbl_user表中的一行。
在表tbl_project中，我们已经引入了用户的概念，我们添加了create_user_id和update_user_id两列，来跟踪创建了这个项目（Project）和对这个项目（Project）细节最后一次更新负责的用户的标识符。
尽管还没有正式引入用户表，这些域已经被设定成数据库中另一个存储用户的表的外键。
在表tbl_issue中，owner_id和requestor_id也是指向表tbl_user的外键。
我们可以用同样的方式来为类型和状态属性建模。
不过，在需求要求模型具备这些额外的复杂度之前，我们让事情简单一些。
表tbl_issue中的type和status列仍将是整数值类型，映射到命名的类型和状态。
我们把这些属性建模成问题（Issue）实体的AR模型类的常量值，而不是使用分开的表来完善我们的模型。
如果所有的这一切看起来有一点迷惑，请不要担心，在接下来的章节中，这些都会变清楚的。
定义一些关系
因为要引入表tbl_user，我们回过头来定义一下用户和项目（Project）之间的关系。
第三章引入TrackStar应用的时候，我们设定用户（项目成员）可以和一个或者多个项目关联。
还提到项目可以有许多（0个或多个）用户。
因为项目可以有多个用户，而且用户可以被关联到多个项目，我们称之为项目和用户之间的多对多关系。
在关系型数据库中，对一个多对多关系建模的最简单方法是，使用关联或者赋值表（assignmenttable）。
所以，我们也需要将这个表添加到我们的模型中。
下图勾勒出一个基本的实体关系，这个关系就是我们需要在用户，项目（Project），问题（Issue）之间建立的模型关系。
项目可以有0个或者多个用户参与，一个用户至少要被关联到一个项目，但是也可以被关联到多个项目。
问题（Issue）属于且仅属于一个项目，同时项目可以包含0个或者多个问题（Issue）。
最后，一个问题（Issue）只能被分配给一个用户（或者由一个用户提出）。
建立数据库和关系
那么，我们需要创建三张新表：
tbl_issue，tbl_user和我们的关联表tbl_project_user_assignment。
为了让您方便一点，我们提供了基本的数据定义语言（DDL）语句用于创建表和它们之间的关系。
由于基本的用户管理不是这个迭代的一部分，我们还提供了一点种子数据填充到用户表中，以使我们可以立即使用它们。
请像前几个迭代你做的那样，创建下列的表和关系。
下列的语法假设你使用的是MySQL数据库：
SQL代码：
DROPTABLEIFEXISTS`tbl_project`;
CREATETABLE`tbl_project`
（
`id`INTEGERNOTNULLPRIMARYKEYAUTO_INCREMENT,
`name`VARCHAR（128）,
`description`TEXT,
`create_time`DATETIME,
`create_user_id`INTEGER,
`update_time`DATETIME,
`update_user_id`INTEGER
）ENGINE=InnoDB;
CREATETABLEIFNOTEXISTS`tbl_issue`
（
`id`INTEGERNOTNULLPRIMARYKEYAUTO_INCREMENT,
`name`VARCHAR（256）NOTNULL,
`description`VARCHAR（2000）,
`project_id`INTEGER,
`type_id`INTEGER,
`status_id`INTEGER,
`owner_id`INTEGER,
`requester_id`INTEGER,
`create_time`DATETIME,
`create_user_id`INTEGER,
`update_time`DATETIME,
`update_user_id`INTEGER,
INDEX（`project_id`）
）ENGINE=InnoDB;
CREATETABLEIFNOTEXISTS`tbl_user`
（
`id`INTEGERNOTNULLPRIMARYKEYAUTO_INCREMENT,
`email`VARCHAR（256）NOTNULL,
`username`VARCHAR（256）,
`password`VARCHAR（256）,
`last_login_time`DATETIME,
`create_time`DATETIME,
`create_user_id`INTEGER,
`update_time`DATETIME,
`update_user_id`INTEGER
）ENGINE=InnoDB;
CREATETABLEIFNOTEXISTS`tbl_project_user_assignment`
（
`project_id`INT（11）NOTNULL,
`user_id`INT（11）NOTNULL,
`create_time`DATETIME,
`create_user_id`INTEGER,
`update_time`DATETIME,
`update_user_id`INTEGER,
PRIMARYKEY（`project_id`,`user_id`）
）ENGINE=InnoDB;
--TheRelationships
ALTERTABLE`tbl_issue`ADDCONSTRAINT`FK_issue_project`
FOREIGNKEY（`project_id`）REFERENCES`tbl_project`（`id`）
ONDELETECASCADEONUPDATERESTRICT;
ALTERTABLE`tbl_issue`ADDCONSTRAINT`FK_issue_owner`
FOREIGNKEY（`owner_id`）REFERENCES`tbl_user`（`id`）
ONDELETECASCADEONUPDATERESTRICT;
ALTERTABLE`tbl_issue`ADDCONSTRAINT`FK_issue_requester`
FOREIGNKEY（`requester_id`）REFERENCES`tbl_user`（`id`）
ONDELETECASCADEONUPDATERESTRICT;
ALTERTABLE`tbl_project_user_assignment`
ADDCONSTRAINT`FK_project_user`FOREIGNKEY（`project_id`）
REFERENCES`tbl_project`（`id`）
ONDELETECASCADEONUPDATERESTRICT;
ALTERTABLE`tbl_project_user_assignment`
ADDCONSTRAINT`FK_user_project`FOREIGNKEY（`user_id`）
REFERENCES`tbl_user`（`id`）
ONDELETECASCADEONUPDATERESTRICT;
--Insertsomeseeddatasowecanjustbeginusingthedatabase
INSERTINTO`tbl_user`
（`email`,`username`,`password`）
VALUES
（'test1@','Test_User_One',MD5（'test1'））,
（'test2@','Test_User_Two',MD5（'test2'））;
创建ActiveRecord模型类
建立好了这些表后，为了能与它们简单地交互，我们需要创建Yii的AR模型类。
在第5章迭代2：
项目CRUD中，使用Gii代码生成工具创建过Project.php模型类时，我们就做过这件事。
在这里，我们会把步骤再提醒你一次，但是省略了截屏。
用Gii工具的更多细节请参考第5章。
创建问题（Issue）模型类
访问http:
//localhost/trackstar/index.php?
r=gii打开Gii工具页面，选择模型生成器链接。
表前缀保留tbl_。
表名（TableName）填写tbl_issue，模型类（ModelClass）格会自动填上Issue。
填写后，点击预览按钮，会得到一个链接，那个链接会打开一个弹出框，里面将展示所有将要生成的代码。
然后点击生成按钮来真正创建Issue.php模型类文件到/protected/model文件夹。
生成代码的完整列表如下：
PHP代码：
/**
*Thisisthemodelclassfortable"tbl_issue".
*
*Thefollowingsaretheavailablecolumnsintable'tbl_issue':
*@propertyinteger$id
*@propertystring$name
*@propertystring$description
*@propertyinteger$project_id
*@propertyinteger$type_id
*@propertyinteger$status_id
*@propertyinteger$owner_id
*@propertyinteger$requester_id
*@propertystring$create_time
*@propertyinteger$create_user_id
*@propertystring$update_time
*@propertyinteger$update_user_id
*
*Thefollowingsaretheavailablemodelrelations:
*@propertyUser$requester
*@propertyUser$owner
*@propertyProject$project
*/
classIssueextendsCActiveRecord{
/**
*ReturnsthestaticmodelofthespecifiedARclass.
*@returnIssuethestaticmodelclass
*/
publicstaticfunctionmodel（$className=__CLASS__）{
returnparent:
:
model（$className）;
}
/**
*@returnstringtheassociateddatabasetablename
*/
publicfunctiontableName（）{
return'tbl_issue';
}
/**
*@returnarrayvalidationrulesformodelattributes.
*/
publicfunctionrules（）{
//NOTE:
youshouldonlydefinerulesforthoseattributesthat
//willreceiveuserinputs.
returnarray（
array（'name','required'）,
array（'project_id,type_id,status_id,owner_id,requester_id,create_user_id,
update_user_id','numerical','integerOnly'=>true）,
array（'name','length','max'=>256）,
array（'description','length','max'=>2000）,
array（'create_time,update_time','safe'）,
//Thefollowingruleisusedbysearch（）.
//Pleaseremovethoseattributesthatshouldnotbesearched.
array（'id,name,description,project_id,type_id,status_id,owner_id,
requester_id,create_time,create_user_id,update_time,update_user_id',
'safe','on'=>'search'）,
）;
}
/**
*@returnarrayrelationalrules.
*/
publicfunctionrelations（）{
//NOTE:
youmayneedtoadjusttherelationnameandtherelated
//classnamefortherelationsautomaticallygeneratedbelow.
returnarray（
'requester'=>array（self:
:
BELONGS_TO,'User','requester_id'）,
'owner'=>array（self:
:
BELONGS_TO,'User','owner_id'）,
'project'=>array（self:
:
BELONGS_TO,'Project','project_id'）,
）;
}
/**
*@returnarraycustomizedattributelabels（name=>label）
*/
publicfunctionattributeLabels（）{
returnarray（
'id'=>'ID',
'name'=>'Name',
'description'=>'Description',
'project_id'=>'Project',
'type_id'=>'Type',
'status_id'=>'Status',
'owner_id'=>'Owner',
'requester_id'=>'Requester',
'create_time'=>'CreateTime',
'create_user_id'=>'CreateUser',
'update_time'=>'UpdateTime',
'update_user_id'=>'UpdateUser',
）;
}
/**
*Retrievesalistofmodelsbasedonthecurrentsearch/filterconditions.
*@returnCActiveDataProviderthedataproviderthatcanreturnthemodelsbasedon
thesearch/filterconditions.
*/
publicfunctionsearch（）{
//Warning:
Pleasemodifythefollowingcodetoremoveattributesthat
//shouldnotbesearched.
$criteria=newCDbCriteria;
$criteria->compare（'id',$this->id）;
$criteria->compare（'name',$this->name,true）;
$criteria->compare（'description',$this->description,true）;
$criteria->compare（'project_id',$this->project_id）;
$criteria->compare（'type_id',$this->type_id）;
$criteria->compare（'status_id',$this->status_id）;
$criteria->compare（'owner_id',$this->owner_id）;
$criteria->compare（'requester_id',$this->requester_id）;
$criteria->compare（'create_time',$this->create_time,true）;
$criteria->compare（'create_user_id',$this->create_user_id）;
$criteria->compare（'update_time',$this->update_time,true）;
$criteria->compare（'update_user_id',$this->update_user_id）;
returnnewCActiveDataProvider（get_class（$this）,array（
'criteria'=>$criteria,
））;
}
}
创建用户模型类
这对您来说可能已经像是老生常谈了，所以我们把创建用户AR模型类的工作留作练习。
下一章中，讨论用户权限和认证的时候，这个类会变得非常重要。
表tbl_project_user_assignment对应的AR类什么时候创建呢？
虽然可以为这个表创建一个AR类，但是这并没有必要。
AR模型为我们的应用提供了一个对象关系映射（ORM）层，来帮助我们方便地操作我们的领域对象。
然而，ProjectUserAssignment不是一个应用中的领域对象。
它只是在关系型数据库中，构建出来，帮助我们建模和管理项目（Project）和用户之间的多对多关系。
维护一个专门的AR类来管理这个表，增加了额外的复杂性，我们可以避免在这时候做这样的事。
我们可以通过使用Yii的DAO来直接管理这个表的插入、更新和删除来避免额外的维护工作和性能负载。
创建问题（Issue）CRUD操作
现在，AR类已经准备就绪了，我们可以开始创建管理我们项目问题（Issue）必须的功能了。
由于项目问题（Issue）的CRUD操作是我们这个迭代要实现的主要目标，我们还是要依赖Gii代码生成工具来帮助我们这些基本的功能。
这方面的细节，我们在第5章创建项目的时候已经做过了。
在这里，为问题（Issue）创建相关代码的时候，我们会再提醒你一些基本的步骤。
在http:
//localhost/trackstar/index.php?
r=gii打开Gii代码生成器的菜单，选择CrudGenerator链接。
在ModelClass表单域中填写I
升级会员 