sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-15 16:38:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Change ID sdo.das.rel to sdodasrel

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@321874 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jakub Vrana 2012-01-07 16:18:34 +00:00
parent a74eda9bce
commit 36a6e2aa5d
11 changed files with 47 additions and 47 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
reference/sdo/reference.xml
View file

@ -29,7 +29,7 @@
</row>
<row>
<entry>
<link linkend="ref.sdo.das.rel">SDO_DAS_Relational</link>
<link linkend="ref.sdodasrel">SDO_DAS_Relational</link>
</entry>
<entry>
A PDO-based Data Access Service supporting reading/writing SDO

2
reference/sdodasrel/book.xml
View file

@ -125,7 +125,7 @@
database without a preliminary call to
<function>executeQuery</function>,
for example. This scenario and others are explored in the
<link linkend="sdo.das.rel.examples">Examples</link>
<link linkend="sdodasrel.examples">Examples</link>
section below.
</para>
</preface>

50
reference/sdodasrel/examples.xml
View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="sdo.das.rel.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xml:id="sdodasrel.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.examples;
<section xml:id="sdo.das.rel.examples-crud">
<section xml:id="sdodasrel.examples-crud">
<title>Creating, retrieving, updating and deleting data</title>
<para>
This section illustrates how the Relational DAS can be used to create,
@ -67,7 +67,7 @@
</para>
</section>
<section xml:id="sdo.das.rel.metadata">
<section xml:id="sdodasrel.metadata">
<title>Specifying the metadata</title>
<para>
This first long section describes in detail how the metadata describing
@ -89,7 +89,7 @@
database is to be normalized into a graph.
</para>
<section xml:id="sdo.das.rel.metadata.database">
<section xml:id="sdodasrel.metadata.database">
<title>Database metadata</title>
<para>
The first argument to the constructor describes the target
@ -314,7 +314,7 @@ create table employee ( \
database, the database metadata should be easy to construct.
</para>
<section xml:id="sdo.das.rel.metadata.database.model">
<section xml:id="sdodasrel.metadata.database.model">
<title>What the Relational DAS does with the metadata</title>
<para>
The Relational DAS uses the database metadata to form most of the
@ -336,14 +336,14 @@ create table employee ( \
metadata in the third argument to the constructor that defines
the SDO containment relationships.
A discussion of this is therefore deferred until the section on
<link linkend="sdo.das.rel.metadata.crels">
<link linkend="sdodasrel.metadata.crels">
SDO containment relationships
</link>
below.
</para>
</section>
<section xml:id="sdo.das.rel.metadata.approottype">
<section xml:id="sdodasrel.metadata.approottype">
<title>Specifying the application root type</title>
<para>
The second argument to the constructor is the application root type.
@ -356,7 +356,7 @@ create table employee ( \
</para>
</section>
<section xml:id="sdo.das.rel.metadata.crels">
<section xml:id="sdodasrel.metadata.crels">
<title>Specifying the SDO containment relationships</title>
<para>
@ -432,10 +432,10 @@ $SDO_containment_metadata = array($department_containment, $employee_containment
below.
</para>
</section>
</section> <!--specifying the metadata sdo.das.rel.metadata.database.model -->
</section> <!-- sdo.das.rel.metadata -->
</section> <!--specifying the metadata sdodasrel.metadata.database.model -->
</section> <!-- sdodasrel.metadata -->
<section xml:id="sdo.das.rel.examples.one-table">
<section xml:id="sdodasrel.examples.one-table">
<title>One-table examples</title>
<para>
The following set of examples all use the Relational DAS to work with
@ -489,7 +489,7 @@ $SDO_containment_metadata = array($department_containment, $employee_containment
object, modify it, and apply the newer changes a second time.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1c-C">
<programlisting role="php" xml:id="sdodasrel.examples.1c-C">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -542,7 +542,7 @@ $das -> applyChanges($dbh, $root);
<varname>id</varname>.
If there were no possible ambiguity it could be omitted.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1c-R">
<programlisting role="php" xml:id="sdodasrel.examples.1c-R">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -601,7 +601,7 @@ foreach ($root['company'] as $company) {
the application. All necessary data is either within the graph itself,
or can be reconstructed from the metadata.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1c-RU">
<programlisting role="php" xml:id="sdodasrel.examples.1c-RU">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -654,7 +654,7 @@ $das->applyChanges($dbh,$root);
containing property (the property defining the containment
relationship). It is also possible to delete them individually.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1c-RD">
<programlisting role="php" xml:id="sdodasrel.examples.1c-RD">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -694,7 +694,7 @@ $das->applyChanges($dbh,$root);
</section> <!-- one-table -->
<section xml:id="sdo.das.rel.examples.two-table">
<section xml:id="sdodasrel.examples.two-table">
<title>Two-table examples</title>
<para>
The following set of examples all use two tables from the company
@ -745,7 +745,7 @@ $das->applyChanges($dbh,$root);
<varname>co_id</varname>
column when inserting the department row.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1cd-C">
<programlisting role="php" xml:id="sdodasrel.examples.1cd-C">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -829,7 +829,7 @@ $das -> applyChanges($dbh, $root);
for multiple companies and multiple departments underneath them.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1cd-RU">
<programlisting role="php" xml:id="sdodasrel.examples.1cd-RU">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -875,7 +875,7 @@ $das -> applyChanges($dbh, $root);
property which in this case is
the company property on the special
root object. You must use:
<programlisting role="php" xml:id="sdo.das.rel.examples.1cd-CRUD.good-delete">
<programlisting role="php" xml:id="sdodasrel.examples.1cd-CRUD.good-delete">
<![CDATA[
<?php
unset($root['company'][0]);
@ -883,7 +883,7 @@ unset($root['company'][0]);
]]>
</programlisting>
and not:
<programlisting role="php" xml:id="sdo.das.rel.examples.1cd-CRUD.bad-delete">
<programlisting role="php" xml:id="sdodasrel.examples.1cd-CRUD.bad-delete">
<![CDATA[
<?php
unset($acme); //WRONG
@ -896,7 +896,7 @@ unset($acme); //WRONG
graph untouched.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1cd-RD">
<programlisting role="php" xml:id="sdodasrel.examples.1cd-RD">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -926,7 +926,7 @@ $das -> applyChanges($dbh, $root);
</para>
</section>
<section xml:id="sdo.das.rel.examples.three-table">
<section xml:id="sdodasrel.examples.three-table">
<title>Three-table example</title>
<para>
The following examples use all three tables from the company database:
@ -982,7 +982,7 @@ $das -> applyChanges($dbh, $root);
primary key known, a final step is performed in which the
company record is updated with the employee's primary key.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1cde-C">
<programlisting role="php" xml:id="sdodasrel.examples.1cde-C">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -1043,7 +1043,7 @@ echo "Wrote back Acme with one department and one employee\n";
Relational DAS will process and apply an arbitrary mixture of
additions, modifications and deletions to and from the data graph.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1cde-RU">
<programlisting role="php" xml:id="sdodasrel.examples.1cde-RU">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
@ -1102,7 +1102,7 @@ echo "Wrote back company with extra department and employee and all the names ch
fields that were retrieved, so that any updates to the data in the
database in the meantime by another process will be detected.
</para>
<programlisting role="php" xml:id="sdo.das.rel.examples.1cde-RD">
<programlisting role="php" xml:id="sdodasrel.examples.1cde-RD">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';

2
reference/sdodasrel/limitations.xml
View file

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="sdo.das.rel.limitations" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xml:id="sdodasrel.limitations" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Limitations</title>
<para>
There are the following limitations in the current release of the

10
reference/sdodasrel/reference.xml
View file

@ -1,13 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<reference xml:id="ref.sdo.das.rel" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<reference xml:id="ref.sdodasrel" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>SDO-DAS-Relational &Functions;</title>
<partintro>
<!-- FIXME: The rest should be reworked to follow our OOskeletons -->
<!-- class definition section -->
<section xml:id="sdo.das.rel.classes">
<section xml:id="sdodasrel.classes">
&reftitle.classes;
<para>
The Relational DAS provides two classes: the Relational DAS itself and
@ -26,7 +26,7 @@
</para>
<section xml:id="sdo.das.rel.sdo-das-relational">
<section xml:id="sdodasrel.sdo-das-relational">
<title>
<classname>SDO_DAS_Relational</classname>
</title>
@ -34,7 +34,7 @@
The only object other than an SDO_DAS_Relational_Exception with which
the application is expected to interact.
</para>
<section xml:id="sdo.das.rel.sdo-das-relational.methods">
<section xml:id="sdodasrel.sdo-das-relational.methods">
&reftitle.methods;
<itemizedlist>
<listitem>
@ -88,7 +88,7 @@
</section>
</section>
<section xml:id="sdo.das.rel.sdo-das-relational-exception">
<section xml:id="sdodasrel.sdo-das-relational-exception">
<title>
<classname>SDO_DAS_Relational_Exception</classname>
</title>

6
reference/sdodasrel/sdo_das_relational/applyChanges.xml
View file

@ -44,7 +44,7 @@
<para>
Constructed using the PDO extension.
A typical line to construct a PDO database handle might look like this:
<programlisting role="php" xml:id="sdo.das.rel.ac.examples.pdo">
<programlisting role="php" xml:id="sdodasrel.ac.examples.pdo">
<![CDATA[
$dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PASSWORD);
]]>
@ -119,11 +119,11 @@ $dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PA
&reftitle.examples;
<para>
Please see the
<link linkend="sdo.das.rel.examples">Examples</link>
<link linkend="sdodasrel.examples">Examples</link>
section in the general information about the Relational DAS
for many examples of calling this method.
Please see also the section on
<link linkend="sdo.das.rel.tracing">Tracing</link>
<link linkend="sdodasrel.tracing">Tracing</link>
to see how you can see what SQL statements are
generated by the Relational DAS.
</para>

6
reference/sdodasrel/sdo_das_relational/construct.xml
View file

@ -50,7 +50,7 @@
<varname>PK</varname>, and optionally,
<varname>FK</varname>.
For a full discussion of the metadata, see the
<link linkend="sdo.das.rel.metadata">metadata</link>
<link linkend="sdodasrel.metadata">metadata</link>
section in the general information about the Relational DAS.
</para>
</listitem>
@ -86,7 +86,7 @@
and there are no containment relations in the model,
this argument can be omitted.
For a full discussion of the metadata, see the
<link linkend="sdo.das.rel.metadata">metadata</link>
<link linkend="sdodasrel.metadata">metadata</link>
section in the general information about the Relational DAS.
</para>
</listitem>
@ -115,7 +115,7 @@
&reftitle.examples;
<para>
For a full discussion of the metadata, see the
<link linkend="sdo.das.rel.metadata">metadata</link>
<link linkend="sdodasrel.metadata">metadata</link>
section in the general information about the Relational DAS.
</para>
</refsect1>

2
reference/sdodasrel/sdo_das_relational/createRootDataObject.xml
View file

@ -67,7 +67,7 @@
&reftitle.examples;
<para>
Please see the
<link linkend="sdo.das.rel.examples">Examples</link>
<link linkend="sdodasrel.examples">Examples</link>
section in the general information about the Relational DAS
for many examples of calling this method.
</para>

6
reference/sdodasrel/sdo_das_relational/executePreparedQuery.xml
View file

@ -71,7 +71,7 @@
Constructed using the PDO extension.
A typical line to construct a PDO database handle might look
like this:
<programlisting role="php" xml:id="sdo.das.rel.epq.examples.pdo">
<programlisting role="php" xml:id="sdodasrel.epq.examples.pdo">
<![CDATA[
$dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PASSWORD);
]]>
@ -144,7 +144,7 @@ $dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PA
<para>
All of the examples in the
<link linkend="sdo.das.rel.examples">Examples</link>
<link linkend="sdodasrel.examples">Examples</link>
use a column specifier.
There is one example in the
<filename>Scenarios</filename>
@ -214,7 +214,7 @@ $dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PA
can be found in the example code supplied in
<filename>sdo/DAS/Relational/Scenarios</filename>.
</para>
<programlisting role="php" xml:id="sdo.das.rel.functions.epq.1c-R">
<programlisting role="php" xml:id="sdodasrel.functions.epq.1c-R">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';

6
reference/sdodasrel/sdo_das_relational/executeQuery.xml
View file

@ -50,7 +50,7 @@
Constructed using the PDO extension.
A typical line to construct a PDO database handle might look
like this:
<programlisting role="php" xml:id="sdo.das.rel.eq.examples.pdo">
<programlisting role="php" xml:id="sdodasrel.eq.examples.pdo">
<![CDATA[
$dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PASSWORD);
]]>
@ -108,7 +108,7 @@ $dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PA
<para>
All of the examples in the
<link linkend="sdo.das.rel.examples">Examples</link>
<link linkend="sdodasrel.examples">Examples</link>
use a column specifier.
There is one example in the
<filename>Scenarios</filename>
@ -161,7 +161,7 @@ $dbh = new PDO("mysql:dbname=COMPANYDB;host=localhost",DATABASE_USER,DATABASE_PA
&reftitle.examples;
<para>
Please see the
<link linkend="sdo.das.rel.examples">Examples</link>
<link linkend="sdodasrel.examples">Examples</link>
section in the general information about the
Relational DAS for many examples of calling this method.
</para>

2
reference/sdodasrel/setup.xml
View file

@ -109,7 +109,7 @@ require_once 'SDO/DAS/Relational.php';
<section xml:id="sdodasrel.configuration">
&reftitle.runtime;
&no.config;
<section xml:id="sdo.das.rel.tracing">
<section xml:id="sdodasrel.tracing">
<title>Tracing</title>
<para>
You may be interested in seeing the SQL statements that are generated