Changeset 1752

Timestamp:

03/09/2007 02:21:01 PM (21 months ago)

Author:

xue

Message:

added TDbUserManager and TDbUser.

Location:

trunk

Files:

• COPYRIGHT (modified) (1 diff)
• HISTORY (modified) (1 diff)
• demos/quickstart/protected/pages/Advanced/Auth.page (modified) (1 diff)
• demos/quickstart/protected/pages/GettingStarted/Introduction.page (modified) (1 diff)
• demos/quickstart/protected/pages/GettingStarted/NewFeatures.page (modified) (1 diff)
• framework/Data/TDataSourceConfig.php (modified) (3 diffs)
• framework/Security/TDbUserManager.php (added)

trunk/COPYRIGHT

@@ -2 +2 @@
 They are released under the terms of the following BSD License.
 
-Copyright 2004-2006, The PRADO Group (http://www.pradosoft.com)
+Copyright 2004-2007, The PRADO Group (http://www.pradosoft.com)
 All rights reserved.
 

trunk/HISTORY

@@ -23 +23 @@
 NEW: TShellApplication (Qiang)
 NEW: TDbCache (Qiang)
+NEW: TDbUserManager and TDbUser (Qiang)
 NEW: Active Record driver for IBM DB2 (Cesar Ramos)
 

trunk/demos/quickstart/protected/pages/Advanced/Auth.page

@@ -90 +90 @@
 where the <tt>roles</tt> attribute in <tt>user</tt> element is optional. User roles can be specified in either the <tt>user</tt> element or in a separate <tt>role</tt> element.
 </p>
+
+<h2 id="5505">Using <tt>TDbUserManager</tt></h2>
+<p id="720563" class="block-content">
+<tt>TDbUserManager</tt> is introduced in v3.1.0. Its main purpose is to simplify the task of managing user accounts that are stored in a database. It requires developers to write a user class that represents the necessary information for a user account. The user class must extend from <tt>TDbUser</tt>.
+</p>
+<p id="720564" class="block-content">
+To use <tt>TDbUserManager</tt>, configure it in the application configuration like following:
+</p>
+<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code4">
+<module id="db"
+     class="System.Data.TDataSourceConfig" ..../>
+<module id="users"
+     class="System.Security.TDbUserManager"
+     UserClass="Path.To.MyUserClass"
+     ConnectionID="db" />
+<module id="auth"
+     class="System.Security.TAuthManager"
+     UserManager="users" LoginPage="Path.To.LoginPage" />
+</com:TTextHighlighter>
+
+</p>
+<p id="720565" class="block-content">
+In the above, <tt>UserClass</tt> specifies what class will be used to create user instance. The class must extend from <tt>TDbUser</tt>. <tt>ConnectionID</tt> refers to the ID of a <tt>TDataSourceConfig</tt> module which specifies how to establish database connection to retrieve user information.
+</p>
+<p id="720566" class="block-content">
+The user class has to implement the two abstract methods in <tt>TDbUser</tt>: <tt>validateUser()</tt> and <tt>createUser()</tt>. Since user account information is stored in a database, the user class may make use of its <tt>DbConnection</tt> property to reach the database.
+</p>
+
 <div class="last-modified">$Id$</div></com:TContent>

trunk/demos/quickstart/protected/pages/GettingStarted/Introduction.page

@@ -5 +5 @@
 This Quickstart tutorial is provided to help you quickly start building your own Web applications based on PRADO version 3.x.
 </p>
+<p>
+If you are an existing PRADO 3.x user and would like to learn what enhancements are available for each new version, please check out the <a href="?page=GettingStarted.NewFeatures">new features</a> page. Otherwise, the following sections are helpful for newbies.
+</p>
 <div class="start-page">
         <div class="concepts start-block">
-        <h2>How Prado Works</h2>
+        <h2>How PRADO Works</h2>
         <p>Concepts and fundamentals</p>
         <ol>
-                <li><a href="#">Building web applications with Prado</a></li>
+                <li><a href="#">Building web applications with PRADO</a></li>
                 <li><a href="#">Web controls and events</a></li>
                 <li><a href="#">Validating user input</a></li>

trunk/demos/quickstart/protected/pages/GettingStarted/NewFeatures.page

@@ -20 +20 @@
 <li>Added support to allow <a href="?page=Configurations.AppConfig">including external application configurations</a>. Enhanced template syntax to facilitate <a href="?page=Configurations.Templates1">subproperty configuration</a>.</li>
 
+<li>Added TDbUserManager and TDbUser to simplify <a href="?page=Advanced.Auth">authentication and authorization</a> with user accounts stored in a database.</li>
+
 </ul>
 

trunk/framework/Data/TDataSourceConfig.php

@@ -10 +10 @@
  * @package System.Data
  */
+
+Prado::using('System.Data.TDbConnection');
 
 /**
@@ -47 +49 @@
 class TDataSourceConfig extends TModule
 {
-        private $_connID;
+        private $_connID='';
         private $_conn;
         private $_connClass='System.Data.TDbConnection';
@@ -92 +94 @@
         public function getDbConnection()
         {
-                if(is_null($this->_conn))
+                if($this->_conn===null)
                 {
-                        if(!is_null($this->_connID))
+                        if($this->_connID!=='')
                                 $this->_conn = $this->findConnectionByID($this->getConnectionID());
                         else