From 5f05818c8dc7d27ae32c86a44f2c22154b95956a Mon Sep 17 00:00:00 2001 From: zYne Date: Mon, 21 Aug 2006 22:55:11 +0000 Subject: [PATCH] Docs updated Session -> Connection --- ...omponents - Eventlisteners - Creating new listener.php | 2 +- ... components - Validators - Validating transactions.php | 2 +- ...asic Components - Collection - Fetching strategies.php | 2 +- manual/docs/Basic Components - Manager - Introduction.php | 2 +- .../Basic Components - Manager - Managing sessions.php | 6 +++--- ...Basic Components - Manager - Opening a new session.php | 4 ++-- manual/docs/Basic Components - Query - Introduction.php | 2 +- .../Basic Components - Record - Accessing properties.php | 4 ++-- .../Basic Components - Record - Creating new records.php | 2 +- .../docs/Basic Components - Record - Deleting records.php | 2 +- ... Components - Record - Retrieving existing records.php | 2 +- .../docs/Basic Components - Record - Updating records.php | 2 +- .../Basic Components - Session - Flushing the session.php | 2 +- ...asic Components - Session - Getting a table object.php | 2 +- ...Basic Components - Session - Getting session state.php | 4 ++-- manual/docs/Basic Components - Table - Custom finders.php | 2 +- manual/docs/Basic Components - Table - Finder methods.php | 2 +- ...Basic components - Exceptions - List of exceptions.php | 4 ++-- manual/docs/Configuration - Levels of configuration.php | 8 ++++---- ... Dealing with relations - Updating related records.php | 2 +- manual/docs/Runtime classes - Doctrine_Manager.php | 4 ++-- manual/docs/Runtime classes - Doctrine_Session.php | 4 ++-- manual/docs/Technology - Design patterns used.php | 6 +++--- manual/docs/Technology - Speed.php | 2 +- 24 files changed, 37 insertions(+), 37 deletions(-) diff --git a/manual/docs/Advanced components - Eventlisteners - Creating new listener.php b/manual/docs/Advanced components - Eventlisteners - Creating new listener.php index 57f733cc0..1137b8917 100644 --- a/manual/docs/Advanced components - Eventlisteners - Creating new listener.php +++ b/manual/docs/Advanced components - Eventlisteners - Creating new listener.php @@ -1 +1 @@ -Creating a new listener is very easy. You can set the listener in global, session or factory level. +Creating a new listener is very easy. You can set the listener in global, connection or factory level. diff --git a/manual/docs/Advanced components - Validators - Validating transactions.php b/manual/docs/Advanced components - Validators - Validating transactions.php index f93b361d5..e8c448553 100644 --- a/manual/docs/Advanced components - Validators - Validating transactions.php +++ b/manual/docs/Advanced components - Validators - Validating transactions.php @@ -1,5 +1,5 @@ When the validation attribute is set as true all transactions will be validated, so whenever Doctrine_Record::save(), -Doctrine_Session::flush() or any other saving method is used all the properties of all records in that transaction will have their values +Doctrine_Connection::flush() or any other saving method is used all the properties of all records in that transaction will have their values validated.

Validation errors are being stacked into Doctrine_Validator_Exception. diff --git a/manual/docs/Basic Components - Collection - Fetching strategies.php b/manual/docs/Basic Components - Collection - Fetching strategies.php index 2b0423b60..a03c5b11d 100644 --- a/manual/docs/Basic Components - Collection - Fetching strategies.php +++ b/manual/docs/Basic Components - Collection - Fetching strategies.php @@ -1,4 +1,4 @@ -Whenever you fetch records with eg. Doctrine_Table::findAll or Doctrine_Session::query methods an instance of +Whenever you fetch records with eg. Doctrine_Table::findAll or Doctrine_Connection::query methods an instance of Doctrine_Collection is returned. There are many types of collections in Doctrine and it is crucial to understand the differences of these collections. Remember choosing the right fetching strategy (collection type) is one of the most influental things when it comes to boosting application performance. diff --git a/manual/docs/Basic Components - Manager - Introduction.php b/manual/docs/Basic Components - Manager - Introduction.php index 199e55816..18ebaf169 100644 --- a/manual/docs/Basic Components - Manager - Introduction.php +++ b/manual/docs/Basic Components - Manager - Introduction.php @@ -1 +1 @@ -Doctrine_Manager is the heart of every Doctrine based application. Doctrine_Manager handles all sessions (database connections). +Doctrine_Manager is the heart of every Doctrine based application. Doctrine_Manager handles all connections (database connections). diff --git a/manual/docs/Basic Components - Manager - Managing sessions.php b/manual/docs/Basic Components - Manager - Managing sessions.php index 54455e382..9c40720ab 100644 --- a/manual/docs/Basic Components - Manager - Managing sessions.php +++ b/manual/docs/Basic Components - Manager - Managing sessions.php @@ -1,3 +1,3 @@ -Switching between sessions in Doctrine is very easy, you just call Doctrine_Manager::setCurrentSession() method. -You can access the session by calling Doctrine_Manager::getSession() or Doctrine_Manager::getCurrentSession() if you only -want to get the current session. +Switching between connections in Doctrine is very easy, you just call Doctrine_Manager::setCurrentConnection() method. +You can access the connection by calling Doctrine_Manager::getConnection() or Doctrine_Manager::getCurrentConnection() if you only +want to get the current connection. diff --git a/manual/docs/Basic Components - Manager - Opening a new session.php b/manual/docs/Basic Components - Manager - Opening a new session.php index 239e736fe..cdc125e62 100644 --- a/manual/docs/Basic Components - Manager - Opening a new session.php +++ b/manual/docs/Basic Components - Manager - Opening a new session.php @@ -1,3 +1,3 @@ In order to get your first application started you first -need to get an instance of Doctrine_Manager which handles all the sessions (database connections). -The second thing to do is to open a new session. +need to get an instance of Doctrine_Manager which handles all the connections (database connections). +The second thing to do is to open a new connection. diff --git a/manual/docs/Basic Components - Query - Introduction.php b/manual/docs/Basic Components - Query - Introduction.php index 2a80f0189..20315cd01 100644 --- a/manual/docs/Basic Components - Query - Introduction.php +++ b/manual/docs/Basic Components - Query - Introduction.php @@ -5,4 +5,4 @@ inheritance (including column aggregation inheritance). So instead of writing lots of SQL inner and outer joins, unions and subselects yourself, you can write simple DQL queries where relationships are being referenced with dot-notation.

-You can execute DQL queries with Doctrine_Session::query() method. +You can execute DQL queries with Doctrine_Connection::query() method. diff --git a/manual/docs/Basic Components - Record - Accessing properties.php b/manual/docs/Basic Components - Record - Accessing properties.php index a56f41558..1ac201eb1 100644 --- a/manual/docs/Basic Components - Record - Accessing properties.php +++ b/manual/docs/Basic Components - Record - Accessing properties.php @@ -1,3 +1,3 @@ -You can retrieve existing objects (database rows) with Doctrine_Table or Doctrine_Session. +You can retrieve existing objects (database rows) with Doctrine_Table or Doctrine_Connection. Doctrine_Table provides simple methods like findBySql, findAll and find for finding objects whereas -Doctrine_Session provides complete OQL API for retrieving objects (see chapter 9). +Doctrine_Connection provides complete OQL API for retrieving objects (see chapter 9). diff --git a/manual/docs/Basic Components - Record - Creating new records.php b/manual/docs/Basic Components - Record - Creating new records.php index d4843ba8f..efd35dc19 100644 --- a/manual/docs/Basic Components - Record - Creating new records.php +++ b/manual/docs/Basic Components - Record - Creating new records.php @@ -1,3 +1,3 @@ There are couple of ways for creating new records. Propably the easiest is using -native php new -operator. The other ways are calling Doctrine_Table::create() or Doctrine_Session::create(). +native php new -operator. The other ways are calling Doctrine_Table::create() or Doctrine_Connection::create(). The last two exists only for backward compatibility. The recommended way of creating new objects is the new operator. diff --git a/manual/docs/Basic Components - Record - Deleting records.php b/manual/docs/Basic Components - Record - Deleting records.php index cc8b3883e..f70a095e3 100644 --- a/manual/docs/Basic Components - Record - Deleting records.php +++ b/manual/docs/Basic Components - Record - Deleting records.php @@ -1,2 +1,2 @@ Deleting records in Doctrine is handled by Doctrine_Record::delete(), Doctrine_Collection::delete() and -Doctrine_Session::delete() methods. +Doctrine_Connection::delete() methods. diff --git a/manual/docs/Basic Components - Record - Retrieving existing records.php b/manual/docs/Basic Components - Record - Retrieving existing records.php index ca7639fa7..0a7afdda4 100644 --- a/manual/docs/Basic Components - Record - Retrieving existing records.php +++ b/manual/docs/Basic Components - Record - Retrieving existing records.php @@ -1,3 +1,3 @@ Doctrine provides many ways for record retrieval. The fastest ways for retrieving existing records are the finder methods provided by Doctrine_Table. If you need to use more complex queries take a look at -DQL API and Doctrine_Session::query method. +DQL API and Doctrine_Connection::query method. diff --git a/manual/docs/Basic Components - Record - Updating records.php b/manual/docs/Basic Components - Record - Updating records.php index f9415397f..5194632e3 100644 --- a/manual/docs/Basic Components - Record - Updating records.php +++ b/manual/docs/Basic Components - Record - Updating records.php @@ -1,3 +1,3 @@ Updating objects is very easy, you just call the Doctrine_Record::save() method. The other way -(perhaps even easier) is to call Doctrine_Session::flush() which saves all objects. It should be noted though +(perhaps even easier) is to call Doctrine_Connection::flush() which saves all objects. It should be noted though that flushing is a much heavier operation than just calling save method. diff --git a/manual/docs/Basic Components - Session - Flushing the session.php b/manual/docs/Basic Components - Session - Flushing the session.php index c3888aada..12f1b8e42 100644 --- a/manual/docs/Basic Components - Session - Flushing the session.php +++ b/manual/docs/Basic Components - Session - Flushing the session.php @@ -1,2 +1,2 @@ -Creating new record (database row) is very easy. You can either use the Doctrine_Session::create() or Doctrine_Table::create() +Creating new record (database row) is very easy. You can either use the Doctrine_Connection::create() or Doctrine_Table::create() method to do this or just simple use the new operator. diff --git a/manual/docs/Basic Components - Session - Getting a table object.php b/manual/docs/Basic Components - Session - Getting a table object.php index 0795c7d9b..5a557e304 100644 --- a/manual/docs/Basic Components - Session - Getting a table object.php +++ b/manual/docs/Basic Components - Session - Getting a table object.php @@ -1 +1 @@ -In order to get table object for specified record just call Doctrine_Record::getTable() or Doctrine_Session::getTable(). +In order to get table object for specified record just call Doctrine_Record::getTable() or Doctrine_Connection::getTable(). diff --git a/manual/docs/Basic Components - Session - Getting session state.php b/manual/docs/Basic Components - Session - Getting session state.php index f6ae741b9..5d5ebcbe7 100644 --- a/manual/docs/Basic Components - Session - Getting session state.php +++ b/manual/docs/Basic Components - Session - Getting session state.php @@ -1,2 +1,2 @@ -Session state gives you information about how active session currently is. You can get the current state -by calling Doctrine_Session::getState(). +Connection state gives you information about how active connection currently is. You can get the current state +by calling Doctrine_Connection::getState(). diff --git a/manual/docs/Basic Components - Table - Custom finders.php b/manual/docs/Basic Components - Table - Custom finders.php index fb595a24e..000badb0b 100644 --- a/manual/docs/Basic Components - Table - Custom finders.php +++ b/manual/docs/Basic Components - Table - Custom finders.php @@ -1,2 +1,2 @@ You can add custom finder methods to your custom table object. These finder methods may use fast -Doctrine_Table finder methods or DQL API (Doctrine_Session::query()). +Doctrine_Table finder methods or DQL API (Doctrine_Connection::query()). diff --git a/manual/docs/Basic Components - Table - Finder methods.php b/manual/docs/Basic Components - Table - Finder methods.php index a93e45cd9..b3198484e 100644 --- a/manual/docs/Basic Components - Table - Finder methods.php +++ b/manual/docs/Basic Components - Table - Finder methods.php @@ -1,2 +1,2 @@ Doctrine_Table provides basic finder methods. These finder methods are very fast and should be used if you only need to fetch -data from one database table. If you need queries that use several components (database tables) use Doctrine_Session::query(). +data from one database table. If you need queries that use several components (database tables) use Doctrine_Connection::query(). diff --git a/manual/docs/Basic components - Exceptions - List of exceptions.php b/manual/docs/Basic components - Exceptions - List of exceptions.php index a3a7b55fa..f0d55afd2 100644 --- a/manual/docs/Basic components - Exceptions - List of exceptions.php +++ b/manual/docs/Basic components - Exceptions - List of exceptions.php @@ -14,8 +14,8 @@ Doctrine_Find_Exception thrown when user tries to find a Doctrine Doctrine_Naming_Exception thrown when user defined Doctrine_Table is badly named -Doctrine_Session_Exception thrown when user tries to get the current - session and there are no open sessions +Doctrine_Connection_Exception thrown when user tries to get the current + connection and there are no open connections Doctrine_Table_Exception thrown when user tries to initialize a new instance of Doctrine_Table, while there already exists an instance of that factory diff --git a/manual/docs/Configuration - Levels of configuration.php b/manual/docs/Configuration - Levels of configuration.php index 6b8bc07a2..bead615b7 100644 --- a/manual/docs/Configuration - Levels of configuration.php +++ b/manual/docs/Configuration - Levels of configuration.php @@ -1,4 +1,4 @@ -Doctrine has a three-level configuration structure. You can set configuration attributes in global, session and table level. +Doctrine has a three-level configuration structure. You can set configuration attributes in global, connection and table level. If the same attribute is set on both lower level and upper level, the uppermost attribute will always be used. So for example if user first sets default fetchmode in global level to Doctrine::FETCH_BATCH and then sets 'example' table fetchmode to Doctrine::FETCH_LAZY, the lazy fetching strategy will be used whenever the records of 'example' table are being fetched. @@ -6,11 +6,11 @@ the lazy fetching strategy will be used whenever the records of 'example' table

  • Global level -
  • Session level +
  • Connection level
  • Table level