1 |
<?php |
<?php |
2 |
/** |
/** |
|
* --- @about |
|
|
* |
|
3 |
* This file contains the DataSource::Locator class. |
* This file contains the DataSource::Locator class. |
4 |
|
* |
5 |
* It acts as a container for DataSource connection |
* It acts as a container for DataSource connection |
6 |
* metadata. Think of it as an enhanced dsn. |
* metadata. Think of it as an enhanced dsn. |
7 |
* |
* |
10 |
* has to do. |
* has to do. |
11 |
* |
* |
12 |
* |
* |
|
* @author Andreas Motl <andreas.motl@ilo.de> |
|
13 |
* @package org.netfrag.glib |
* @package org.netfrag.glib |
14 |
* @module DataSource::Locator |
* @module DataSource::Locator |
15 |
* |
* |
19 |
* $Id$ |
* $Id$ |
20 |
* |
* |
21 |
* $Log$ |
* $Log$ |
22 |
|
* Revision 1.2 2003/03/05 15:01:10 joko |
23 |
|
* updated docu |
24 |
|
* |
25 |
* Revision 1.1 2003/03/05 12:04:37 joko |
* Revision 1.1 2003/03/05 12:04:37 joko |
26 |
* + initial commit |
* + initial commit |
27 |
* |
* |
29 |
*/ |
*/ |
30 |
|
|
31 |
/** |
/** |
32 |
* --- @description |
* It helps GenericDataSource working in different "operation modes". |
|
* |
|
|
* --- It helps GenericDataSource working in different "operation modes". |
|
33 |
* |
* |
34 |
* o Pass-Through-Reference: php Object will get passed through all layers |
* o Pass-Through-Reference: php Object will get passed through all layers |
35 |
* o Pass-Through-Memory: reference to a memory area will get used |
* o Pass-Through-Memory: reference to a memory area will get used |
39 |
* o Build-AutoLocator: use global constants making up our metadata |
* o Build-AutoLocator: use global constants making up our metadata |
40 |
* |
* |
41 |
* |
* |
42 |
* --- It can/should contain (flexible, just some parameters are required for each operation mode) |
* It can/should contain (flexible, just some parameters are required for each operation mode) |
43 |
* |
* |
44 |
* o an oldschool "dsn"-string (e.g. for rdbms-connection via PEAR) |
* o an oldschool "dsn"-string (e.g. for rdbms-connection via PEAR) |
45 |
* x name of a Proxy module to use to *wrap/hide* the connection/transport-layer |
* + name of a Proxy module to use to *wrap/hide* the connection/transport-layer |
46 |
* (e.g. DataSource::Proxy::XMLRPC via DesignPattern::RemoteProxy) |
* (e.g. DataSource::Proxy::XMLRPC via DesignPattern::RemoteProxy) |
47 |
* x metadata (a hash) directly describing *where* to connect to (e.g. 'Host', 'Port') |
* + metadata (a hash) directly describing *where* to connect to (e.g. 'Host', 'Port') |
48 |
* o an instance of an already instantiated arbitrary datasource handler (e.g. 'source') |
* o an instance of an already instantiated arbitrary datasource handler (e.g. 'source') |
49 |
* this will get propagated (pass-through-mode) |
* this will get propagated (pass-through-mode) |
50 |
* x a datasource-type (of 'rpc|mysql|csv-file|xml-file') |
* + a datasource-type (of 'rpc|mysql|csv-file|xml-file') |
51 |
* this will be mapped to a module name and used as a *Proxy* |
* this will be mapped to a module name and used as a *Proxy* |
52 |
* by the GenericDataSource at runtime |
* by the GenericDataSource at runtime |
53 |
* x an adapter-type (of 'phpHtmlLib|pear') |
* + an adapter-type (of 'phpHtmlLib|pear') |
54 |
* this will be mapped to a module name and used as an *Adapter* |
* this will be mapped to a module name and used as an *Adapter* |
55 |
* by the GenericDataSource at runtime |
* by the GenericDataSource at runtime |
56 |
* o names of global constants where to find these informations |
* o names of global constants where to find these informations |
57 |
* o datasource-type ('rpc|csv-file|...') <-> datasource-family ('orm|rdbms|odbms') |
* o datasource-type ('rpc|csv-file|...') <-> datasource-family ('orm|rdbms|odbms') |
58 |
* |
* |
59 |
* |
* |
60 |
* --- It can do |
* --- It can do |
89 |
* |
* |
90 |
* |
* |
91 |
* @author Andreas Motl <andreas.motl@ilo.de> |
* @author Andreas Motl <andreas.motl@ilo.de> |
92 |
|
* @link http://www.netfrag.org/~joko/ |
93 |
* @copyright (c) 2003 - All Rights reserved. |
* @copyright (c) 2003 - All Rights reserved. |
|
* @license GNU LGPL (GNU Lesser General Public License) |
|
94 |
* |
* |
95 |
* @author-url http://www.netfrag.org/~joko/ |
* @license GNU LGPL (GNU Lesser General Public License) |
96 |
* @license-url http://www.gnu.org/licenses/lgpl.txt |
* @link http://www.gnu.org/licenses/lgpl.txt |
97 |
* |
* |
98 |
* @author Andreas Motl <andreas.motl@ilo.de> |
* @subpackage DataSource |
99 |
* @package org.netfrag.glib |
* @name DataSource::Locator |
100 |
* @module DataSource::Locator |
* @filesource |
101 |
* |
* |
102 |
*/ |
*/ |
103 |
|
|