Author: lou
Date: 2007-11-19 13:20:23 -0800 (Mon, 19 Nov 2007)
New Revision: 7321
Modified:
openlaszlo/trunk/docs/src/developers/data-structures.dbk
openlaszlo/trunk/docs/src/developers/index.dbk
openlaszlo/trunk/docs/src/developers/tutorials/data_app.dbk
Log:
Change 20071119-lou-9 by [EMAIL PROTECTED] on 2007-11-19 17:10:48 AST
in /Users/lou/src/svn/openlaszlo/trunk
for http://svn.openlaszlo.org/openlaszlo/trunk
Summary: Back out new data binding chapters that are not ready to be published
in the dguide
Bugs Fixed: LPP-5131
Technical Reviewer: (pending)
QA Reviewer: (pending)
Doc Reviewer: (pending)
Tests: build and view doc
Modified: openlaszlo/trunk/docs/src/developers/data-structures.dbk
===================================================================
--- openlaszlo/trunk/docs/src/developers/data-structures.dbk 2007-11-19
21:19:21 UTC (rev 7320)
+++ openlaszlo/trunk/docs/src/developers/data-structures.dbk 2007-11-19
21:20:23 UTC (rev 7321)
@@ -3,88 +3,7 @@
<title>Data, XML, and XPath</title>
<!-- change link for language-preliminaries per LPP-4923, IORIO 17 oct 2007 -->
-<title>Introduction to Data and Data-Driven Applications</title>
<para>
-Summary: In this chapter we introduce key concepts at a high level. There is
little code, but a fair amount of diagramware to illustrate databinding and
replication.
-</para>
-<para>
- Databinding marries the content of an XML datastructure with the
OpenLaszlo objects (such as nodes, or views).
-
- Allows separation of content from presentation
- Datapaths are objects that connect views to data.
- Attribute values update automatically when the data changes.
-</para>
-<para>
-We give a conceptual overview of the logical differences between the DOM-based
and datapointer/datapath-based ways of manipulating data, with a preview of how
these approaches will be reconciled in later chapters.
-</para>
-<para>
-Datareplication is introduced, and the difference between implicit and
explicit replication.
-</para>
-<para>
-We then explain some useful design patterns involving datasets, both locally
on the client, and between client and server.
-</para>
-<para>
-Finally, we introduce the abstract concept of the dataprovider.
-</para>
-<para>
-Outline:
-
-Data
--- XML
-<ul>
- <li>Definition and specification</li>
- <li>White space</li>
- <li>Character sets</li>
- <li>Namespaces</li>
-</ul>
-
--- Xpath
-------Notation
-------Supported subset in LZX
-Databinding -- conceptual overview
--- Datasets - in-memory representation of XML data
------ The LzDataNode type
------ The LzDataElement type
------ The LzDataText type
--- Updating views by data (data determines behaviour of LZX object)
--- Updating data by object (object updates dataset)
-Databinding APIs
--- Datapointer (tag) APIs
--- DOM (prodedural) APIs
-Replication
--- Explicit Replication with <replicator> tag
----Implicit replication without <replicator> tag
-Client-Server Data patterns
---- REST and HTTP
------ Query types
------ Request and response headers
------ Query Paremeters
---- Ajax and the HttpRequest() object
------ This is "syntactic sugar"; same functionality as with datasets
---- Master-Detail
--- Reconciling Server and Client data models (updating databases on server)
-The dataprovider object
-</para>
-<para>
- Any subclass of LzNode can be data-bound.
- All data-bound objects have a datapath.
- The XPath may be absolute or relative.
- <view datapath="ds:/path/to/data/text()" />
- Individual attributes of nodes can be data-bound.
- Attributes must be settable.
- The object must have a datapath.
- You must use relative XPaths for the attribute bindings.
- Multiple attributes of the same object can be databound to
different locations.
- <view datapath="ds:/path/to/data"
- x="$path{'@xposition'}" />
- Datapaths cascade through the view hierarchy
-<view datapath="ds:/path/to/data">
- <view name="unboundView">
- <text datapath="text()" />
- </view>
-</view>
-</para>
-<para>
The term <indexterm
significance="preferred"><primary>data</primary></indexterm><glossterm>data</glossterm>
refers to numbers, characters, or text
in a form that can be displayed or manipulated by
a Laszlo application. The specific form that data takes in a Laszlo
application
@@ -344,4 +263,4 @@
-<para/></section></section></chapter>
+<para/></section></section></chapter>
\ No newline at end of file
Modified: openlaszlo/trunk/docs/src/developers/index.dbk
===================================================================
--- openlaszlo/trunk/docs/src/developers/index.dbk 2007-11-19 21:19:21 UTC
(rev 7320)
+++ openlaszlo/trunk/docs/src/developers/index.dbk 2007-11-19 21:20:23 UTC
(rev 7321)
@@ -73,16 +73,16 @@
<part id="developers.data">
<title>Data and Databinding</title>
- <!--xi:include href="data-structures.dbk"/-->
- <xi:include href="data-overview.dbk"/>
- <!--xi:include href="databinding.dbk"/-->
+ <xi:include href="data-structures.dbk"/>
+ <!-- xi:include href="data-overview.dbk"/-->
+ <xi:include href="databinding.dbk"/>
<xi:include href="tutorials/data_app.dbk"/>
- <xi:include href="static-databinding.dbk"/>
- <xi:include href="dynamic-databinding.dbk"/>
- <xi:include href="two-way-databinding.dbk"/>
- <xi:include href="data-replication.dbk"/>
- <xi:include href="data-patterns-and-best-practices.dbk"/>
- <xi:include href="dataprovider.dbk"/>
+ <!-- xi:include href="static-databinding.dbk"/ -->
+ <!-- xi:include href="dynamic-databinding.dbk"/ -->
+ <!-- xi:include href="two-way-databinding.dbk"/ -->
+ <!-- xi:include href="data-replication.dbk"/ -->
+ <!-- xi:include href="data-patterns-and-best-practices.dbk"/ -->
+ <!-- xi:include href="dataprovider.dbk"/ -->
</part>
<part id="developers.media">
Modified: openlaszlo/trunk/docs/src/developers/tutorials/data_app.dbk
===================================================================
--- openlaszlo/trunk/docs/src/developers/tutorials/data_app.dbk 2007-11-19
21:19:21 UTC (rev 7320)
+++ openlaszlo/trunk/docs/src/developers/tutorials/data_app.dbk 2007-11-19
21:20:23 UTC (rev 7321)
@@ -10,7 +10,6 @@
<itemizedlist spacing="compact"><listitem><para>In the first part of this
tutorial, you use a static XML document as the data
source.</para></listitem><listitem><para>In the second part of this tutorial,
you use a relational database as the data
source.</para></listitem></itemizedlist>
-<informalfigure><mediaobject><imageobject><imagedata
fileref="img/d_t_datapp_1.gif"/></imageobject></mediaobject></informalfigure>
<para/></section><section><title>Retrieving Data</title>
_______________________________________________
Laszlo-checkins mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-checkins