You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by cr...@apache.org on 2006/02/15 07:36:23 UTC
svn commit: r377949 [21/21] - in /cocoon/site/site/2.1: ./ developing/
developing/portal/ developing/portal/coplets/ developing/webapps/
developing/webapps/authentication/ faq/ howto/ installing/
plan/documentation/ plan/otherplanning/ plan/overview/ s...
Modified: cocoon/site/site/2.1/userdocs/xsp/xsp-internals.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/xsp/xsp-internals.html?rev=377949&r1=377948&r2=377949&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/xsp/xsp-internals.html (original)
+++ cocoon/site/site/2.1/userdocs/xsp/xsp-internals.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
<!--+
|alternative credits
+-->
-<div id="credit2">
-<a href="http://apachecon.com/"><img border="0" title="ApacheCon US 2005" alt="ApacheCon US 2005 - logo" src="http://apache.org/images/ac2005us_blue_125x125.jpg" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
</div>
<!--+
|end Menu
@@ -1269,7 +1267,7 @@
</ul>
</div>
-<a name="N10047"></a><a name="Markup-to-code+Transformation"></a>
+<a name="N10047"></a><a name="markup-to-code"></a>
<h2 class="h3">Markup-to-code Transformation</h2>
<div class="section">
<p>XSP is based on a general-purpose markup-to-code transformation engine built
@@ -1309,14 +1307,14 @@
environment.</div>
</div>
</div>
-<a name="N1007C"></a><a name="XSP+and+Cocoon+Generators"></a>
+<a name="N1007D"></a><a name="cocoon-generators"></a>
<h2 class="h3">XSP and Cocoon Generators</h2>
<div class="section">
<p>As a rule, XSP pages are translated into Cocoon
<a href="apidocs/org/apache/cocoon/generation/Generator.html">
<tt>Generator</tt>'s. </a>
</p>
-<a name="N10088"></a><a name="Server+Pages+Generator+Proxy"></a>
+<a name="N1008A"></a><a name="Server+Pages+Generator+Proxy"></a>
<h3 class="h4">Server Pages Generator Proxy</h3>
<p>
<tt>Generator</tt>'s created by XSP are invoked exclusively through
@@ -1391,7 +1389,7 @@
respectively.</p>
<p>The complete XSP sitemap configuration is explained
<a href="#sitemap-configuration">below</a>.</p>
-<a name="N100DD"></a><a name="XSP+Generators+and+Compiled+Languages"></a>
+<a name="N100DF"></a><a name="XSP+Generators+and+Compiled+Languages"></a>
<h3 class="h4">XSP Generators and Compiled Languages</h3>
<p>For the Java language (and other compiled languages like
<a class="external" href="http://www.mozilla.org/rhino/"><em>Rhino</em></a> Javascript), XSP
@@ -1435,7 +1433,7 @@
methods used to shorten the generation of SAX events not requiring a namespace.
</p>
</div>
-<a name="N1014B"></a><a name="The+Programming+Language+Processor"></a>
+<a name="N1014D"></a><a name="programming-language"></a>
<h2 class="h3">The Programming Language Processor</h2>
<div class="section">
<p>A Cocoon's
@@ -1475,7 +1473,7 @@
<tt>AbstractProgrammingLanguage</tt> </a>) is provided that extends
<tt>org.apache.arch.named.AbstractNamedComponent</tt> and retrieves
language-related sitemap parameters.</p>
-<a name="N1018B"></a><a name="Filenames+and+Encoding"></a>
+<a name="N1018E"></a><a name="Filenames+and+Encoding"></a>
<h3 class="h4">Filenames and Encoding</h3>
<p>
<tt>load</tt> and <tt>unload</tt> are passed a file/directory pair used to
@@ -1502,7 +1500,7 @@
<p>Finally, the (optional) <tt>encoding</tt> argument specifies the how the
source program file contents are encoded. This argument can be <tt>null</tt> to
specify the platform's default encoding.</p>
-<a name="N101D5"></a><a name="Loading+Programs"></a>
+<a name="N101D8"></a><a name="Loading+Programs"></a>
<h3 class="h4">Loading Programs</h3>
<p>Currently, programs returned by the <tt>load</tt> operation are "plain" Java
<tt>Object</tt>'s and are not required to implement any interface or to extend
@@ -1520,7 +1518,7 @@
</p>
<p>Of course, it is an error for the source program file not to exist as a
readable, regular operating system file.</p>
-<a name="N101F4"></a><a name="Unloading+Programs"></a>
+<a name="N101F8"></a><a name="Unloading+Programs"></a>
<h3 class="h4">Unloading Programs</h3>
<p>When a previously loaded program is no longer needed (or becomes "outdated"
as explained below) the language processor may need to perform cleanup actions,
@@ -1545,7 +1543,7 @@
instantiation should take place through the program object itself, rather than
through the language processor (see <em>Program Instantiation</em> below)</div>
</div>
-<a name="N1022C"></a><a name="Instantiating+Programs"></a>
+<a name="N10231"></a><a name="Instantiating+Programs"></a>
<h3 class="h4">Instantiating Programs</h3>
<p>The <tt>program</tt> object returned by <tt>load</tt> must act as an factory
capable of creating <em>program instance</em> objects on demand.</p>
@@ -1561,12 +1559,12 @@
<tt>prototype</tt> object to <tt>load</tt> as to ensure that created instances
conform to a given Java type expected behavior.</div>
</div>
-<a name="N10254"></a><a name="Source+Extensions"></a>
+<a name="N1025A"></a><a name="Source+Extensions"></a>
<h3 class="h4">Source Extensions</h3>
<p>All languages are required to return a <em>source extension</em>. This
extension is used to locate source files for subsequent interpretation or
compilation.</p>
-<a name="N1025D"></a><a name="Code+Formatting"></a>
+<a name="N10264"></a><a name="Code+Formatting"></a>
<h3 class="h4">Code Formatting</h3>
<p>Programming languages may provide a
<a href="apidocs/org/apache/cocoon/components/language/programming/CodeFormatter.html">
@@ -1590,14 +1588,14 @@
not open-sourced) products like <a class="external" href="http://www.jindent.com/">Jindent</a>.
</div>
</div>
-<a name="N10292"></a><a name="String+Quoting"></a>
+<a name="N1029A"></a><a name="String+Quoting"></a>
<h3 class="h4">String Quoting</h3>
<p>Method <tt>quoteString</tt> applies the programming language string constant
escaping rules to its input argument.</p>
<p>This method exists to assist markup language code generators in escaping
<tt>Text</tt> XML nodes.</p>
</div>
-<a name="N102A0"></a><a name="Compiled+Languages"></a>
+<a name="N102A9"></a><a name="compiled-languages"></a>
<h2 class="h3">Compiled Languages</h2>
<div class="section">
<p>Compiled languages extend the <tt>ProgrammingLanguage</tt> abstraction by
@@ -1641,20 +1639,20 @@
. . .
</component-instance>
</pre>
-<a name="N102EB"></a><a name="Object+Extensions"></a>
+<a name="N102F5"></a><a name="Object+Extensions"></a>
<h3 class="h4">Object Extensions</h3>
<p>All compiled languages are required to return a <em>source extension</em>.
This extension is used to locate object files for subsequent loading.</p>
-<a name="N102F4"></a><a name="Object+Program+Loading"></a>
+<a name="N102FF"></a><a name="Object+Program+Loading"></a>
<h3 class="h4">Object Program Loading</h3>
<p>Concrete compiled programming languages must implement the abstract method
<tt>loadProgram</tt> to actually load an <em>object</em> program resulting from
compilation.</p>
-<a name="N10300"></a><a name="Program+Compilation"></a>
+<a name="N1030C"></a><a name="Program+Compilation"></a>
<h3 class="h4">Program Compilation</h3>
<p>Compilation is delegated to a sitemap-specified <tt>LanguageCompiler</tt>
instance, as explained below.</p>
-<a name="N10309"></a><a name="Compilers"></a>
+<a name="N10316"></a><a name="Compilers"></a>
<h3 class="h4">Compilers</h3>
<p>Interface
<a href="apidocs/org/apache/cocoon/components/language/programming/LanguageCompiler.html">
@@ -1692,7 +1690,7 @@
should compilation fail</li>
</ul>
-<a name="N10340"></a><a name="Compiler+Errors"></a>
+<a name="N1034E"></a><a name="Compiler+Errors"></a>
<h4>Compiler Errors</h4>
<p>Error message producer by the compiler must be collected and massaged by the
<tt>LanguageCompiler</tt> in order to wrap each of them as a
@@ -1727,7 +1725,7 @@
<tt>getMessage</tt>. Returns the actual error message text</li>
</ul>
-<a name="N1037A"></a><a name="Java+Compilers"></a>
+<a name="N10389"></a><a name="Java+Compilers"></a>
<h4>Java Compilers</h4>
<p>For the Java language, 2 pluggable compilers are available:</p>
<ul>
@@ -1743,13 +1741,13 @@
<a href="apidocs/org/apache/cocoon/components/language/programming/java/AbstractJavaCompiler.html">
<tt>AbstractJavaCompiler</tt>. </a>
</p>
-<a name="N10397"></a><a name="Other+Compilers"></a>
+<a name="N103A7"></a><a name="Other+Compilers"></a>
<h4>Other Compilers</h4>
<p>Since <a class="external" href="http://www.mozilla.org/rhino/"><em>Rhino</em></a> Javascript
provides its own, only compiler (<em>jsc</em>), class
<tt>JavascriptLanguage</tt> doesn't use the compiler class initialized by
<tt>CompiledProgrammingLanguage</tt>.</p>
-<a name="N103AB"></a><a name="Object+Program+Unloading"></a>
+<a name="N103BC"></a><a name="Object+Program+Unloading"></a>
<h3 class="h4">Object Program Unloading</h3>
<p>
<tt>CompiledProgrammingLanguage</tt> extends the default implementation
@@ -1767,7 +1765,7 @@
<p>This is a commonly-used workaround for the (somewhat buggy) standard Java
class loader, which doesn't provide for an explicit method for reloading class
files.</p>
-<a name="N103CC"></a><a name="The+Cocoon+Class+Loader"></a>
+<a name="N103DE"></a><a name="The+Cocoon+Class+Loader"></a>
<h3 class="h4">The Cocoon Class Loader</h3>
<p>To circumvent standard Java class loaders limitation, Cocoon provides a
simple customized class loader
@@ -1829,7 +1827,7 @@
class="org.apache.cocoon.components.classloader.ClassLoaderManagerImpl"/>
</pre>
</div>
-<a name="N10428"></a><a name="Interpreted+Languages"></a>
+<a name="N1043B"></a><a name="interpreted-languages"></a>
<h2 class="h3">Interpreted Languages</h2>
<div class="section">
<p>Interpreted languages for which a Java-based interpreter exists are supported
@@ -1881,7 +1879,7 @@
of the given type.</div>
</div>
</div>
-<a name="N10477"></a><a name="The+Markup+Language+Processor"></a>
+<a name="N1048B"></a><a name="markup-language"></a>
<h2 class="h3">The Markup Language Processor</h2>
<div class="section">
<p>A Cocoon's
@@ -1955,7 +1953,7 @@
document nodes. Code generation is being reconsidered, however, to overcome this
and make it possible to reuse Cocoon's SAX-based filtering pipeline.</div>
</div>
-<a name="N104E3"></a><a name="Markup+Encoding"></a>
+<a name="N104F8"></a><a name="Markup+Encoding"></a>
<h3 class="h4">Markup Encoding</h3>
<p>All markup languages must provide a way to declare the XML document's
encoding so that it is preserved during code generation, beautifying and
@@ -1970,7 +1968,7 @@
to provide access to it, thus forcing server pages authors to redundantly
specify it.</div>
</div>
-<a name="N104F9"></a><a name="The+Logicsheet+class"></a>
+<a name="N1050F"></a><a name="The+Logicsheet+class"></a>
<h3 class="h4">The Logicsheet class</h3>
<p>A <em>logicsheet</em> is an XML filter used to translate user-defined dynamic
markup into equivalent code embedding directives for a given markup language.
@@ -2007,9 +2005,9 @@
used to perform the transformation without an intervening stylesheet processor
wrapping abstraction.</div>
</div>
-<a name="N10531"></a><a name="Named+Logicsheets"></a>
+<a name="N10548"></a><a name="Named+Logicsheets"></a>
<h3 class="h4">Named Logicsheets</h3>
-<p>As explained in <a href="../../../2.1/"> Logicsheet Concepts,
+<p>As explained in <a href="../../../2.1/userdocs/xsp/logicsheet-concepts.html#logicsheet-object"> Logicsheet Concepts,
</a> logicsheets are typically associated with a single object type whose
methods it wraps to make them available as <em>markup commands</em>.</p>
<p>Markup commands related to a given object type are grouped under a single
@@ -2045,7 +2043,7 @@
wrongly binds named logicsheets based on their namespace <em>prefix</em>
instead of their URI!</div>
</div>
-<a name="N1057B"></a><a name="Logicsheet+Code+Generators"></a>
+<a name="N10593"></a><a name="Logicsheet+Code+Generators"></a>
<h3 class="h4">Logicsheet Code Generators</h3>
<p>Logicsheets translate dynamic tags to equivalent code-embedding directives
expressed in the markup language at hand. They do not, however, actually emit
@@ -2082,7 +2080,7 @@
generator abstraction from its logicsheet-based implementation. This would allow
for alternative code-generation strategies to be plugged.</div>
</div>
-<a name="N105B7"></a><a name="Markup+Language+Definition"></a>
+<a name="N105D0"></a><a name="Markup+Language+Definition"></a>
<h3 class="h4">Markup Language Definition</h3>
<p>Markup languages are defined in the sitemap as follows:</p>
<pre>
@@ -2122,14 +2120,14 @@
<p>Optionally, each supported programming language may define one or more
namespace-mapped <em>builtin logicsheets</em>.</p>
</div>
-<a name="N105D4"></a><a name="The+XSP+Markup+Language"></a>
+<a name="N105EE"></a><a name="xsp-language"></a>
<h2 class="h3">The XSP Markup Language</h2>
<div class="section">
<p>So far, programming and markup languages have been described in general,
without explicitly referring to the XSP language.</p>
<p>This section describes how the above described framework is used to implement
XSP in particular. For a description of logicsheet authoring requirements for
-XSP in Java, see <a href="../../../2.1/"> XSLT Logicsheets and XSP
+XSP in Java, see <a href="../../../2.1/userdocs/xsp/logicsheet-concepts.html#java-logicsheets"> XSLT Logicsheets and XSP
for Java. </a>
</p>
<div class="frame note">
@@ -2140,7 +2138,7 @@
pages do not need to embed any code. In this case, there should be no need for
the <tt><xsp:page></tt> element.</div>
</div>
-<a name="N105ED"></a><a name="Markup+Encoding-N105ED"></a>
+<a name="N10608"></a><a name="Markup+Encoding-N10608"></a>
<h3 class="h4">Markup Encoding</h3>
<p>Method <tt>getEncoding</tt> is implemented by class
<a href="apidocs/org/apache/cocoon/components/language/markup/xsp/XSPMarkupLanguage.html">
@@ -2152,7 +2150,7 @@
encoding will be retrieved from an attribute named <tt>xsp:encoding</tt>
present in the "user" root element.</div>
</div>
-<a name="N10611"></a><a name="Document+Preprocessing"></a>
+<a name="N1062D"></a><a name="Document+Preprocessing"></a>
<h3 class="h4">Document Preprocessing</h3>
<p>
<tt>XSPMarkupLanguage</tt> preprocesses its input document by:</p>
@@ -2184,7 +2182,7 @@
be output by "reusing" their containing character arrays along with their
corresponding offsets and lengths.</div>
</div>
-<a name="N1064D"></a><a name="Dependency+Tracking"></a>
+<a name="N1066A"></a><a name="Dependency+Tracking"></a>
<h3 class="h4">Dependency Tracking</h3>
<p>File dependencies passed to <tt>XSPMarkupLanguage</tt> by its
<tt>AbstractMarkupLanguage</tt> superclass are stored in top-level
@@ -2192,7 +2190,7 @@
<p>These elements are used by XSP code-generation logicsheets to populate the
<tt>File</tt> array defined by the generated classes'
<tt>AbstractServerPage</tt> superclass.</p>
-<a name="N10664"></a><a name="XSP+Builtin+Logicsheets"></a>
+<a name="N10682"></a><a name="XSP+Builtin+Logicsheets"></a>
<h3 class="h4">XSP Builtin Logicsheets</h3>
<p>XSP for Java currently provides only 2 builtin logicsheets: <tt>request</tt>
and <tt>response</tt>, associated with their corresponding Cocoon counterparts.
@@ -2204,7 +2202,7 @@
servlet objects is a must.</div>
</div>
</div>
-<a name="N10678"></a><a name="The+DOM-XSP+Markup+Language"></a>
+<a name="N10697"></a><a name="dom-xsp"></a>
<h2 class="h3">The DOM-XSP Markup Language</h2>
<div class="section">
<p>The new, SAX-based XSP version for Cocoon is not backwards compatible with
@@ -2220,7 +2218,7 @@
<p>For the long run, though, developers are strongly encouraged to replace their
"legacy" DOM pages and classes with equivalent, faster SAX counterparts.</p>
</div>
-<a name="N1068C"></a><a name="The+Program+Generator"></a>
+<a name="N106AC"></a><a name="program-generator"></a>
<h2 class="h3">The Program Generator</h2>
<div class="section">
<p>The
@@ -2250,7 +2248,7 @@
<a href="apidocs/org/apache/cocoon/components/language/generator/ProgramGeneratorImpl.html">
<tt>ProgramGeneratorImpl</tt>. </a>
</p>
-<a name="N106CE"></a><a name="Program+Repository"></a>
+<a name="N106EF"></a><a name="Program+Repository"></a>
<h3 class="h4">Program Repository</h3>
<p>
<tt>FilesystemStore</tt> is an implementation of the <tt>Store</tt>
@@ -2285,7 +2283,7 @@
<li>All other <tt>Object</tt>'s are serialized</li>
</ul>
-<a name="N10721"></a><a name="Program+Reloading"></a>
+<a name="N10743"></a><a name="Program+Reloading"></a>
<h3 class="h4">Program Reloading</h3>
<p>Unless the <tt>auto-reload</tt> sitemap option is in effect,
<tt>ProgramGeneratorImpl</tt> will check whether program instances implement
@@ -2301,7 +2299,7 @@
instances are used to generate and load a program for which an instance is
created and then returned to the calling environment.</p>
</div>
-<a name="N10750"></a><a name="Named+Components"></a>
+<a name="N10773"></a><a name="named-components"></a>
<h2 class="h3">Named Components</h2>
<div class="section">
<p>In order to support pluggable markup and programming languages, a new
@@ -2362,7 +2360,7 @@
</ul>
</div>
-<a name="N107CB"></a><a name="XSP+Sitemap+Configuration"></a>
+<a name="N107EF"></a><a name="sitemap-configuration"></a>
<h2 class="h3">XSP Sitemap Configuration</h2>
<div class="section">
<div class="frame note">
Modified: cocoon/site/site/2.1/userdocs/ziparchive-serializer.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/ziparchive-serializer.html?rev=377949&r1=377948&r2=377949&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/ziparchive-serializer.html (original)
+++ cocoon/site/site/2.1/userdocs/ziparchive-serializer.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
<!--+
|alternative credits
+-->
-<div id="credit2">
-<a href="http://apachecon.com/"><img border="0" title="ApacheCon US 2005" alt="ApacheCon US 2005 - logo" src="http://apache.org/images/ac2005us_blue_125x125.jpg" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
</div>
<!--+
|end Menu
Modified: cocoon/site/site/2.1/who.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/who.html?rev=377949&r1=377948&r2=377949&view=diff
==============================================================================
--- cocoon/site/site/2.1/who.html (original)
+++ cocoon/site/site/2.1/who.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
<!--+
|alternative credits
+-->
-<div id="credit2">
-<a href="http://apachecon.com/"><img border="0" title="ApacheCon US 2005" alt="ApacheCon US 2005 - logo" src="http://apache.org/images/ac2005us_blue_125x125.jpg" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
</div>
<!--+
|end Menu