cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [DAISY] Created: Cocoon Source Resolving
Date Tue, 20 Sep 2005 14:47:23 GMT
A new document has been created.

Document ID: 707
Branch: main
Language: default
Name: Cocoon Source Resolving
Document Type: Document
Created: 9/20/05 2:47:06 PM
Creator (owner): Helma van der Linden
State: publish


Mime type: text/xml
Size: 1903 bytes

<h1>Differences between Cocoon and Avalon Excalibur Source Resolving</h1>

<p>This story tries to list the changes between the two source resolving
approaches. Originally, the source resolving was developed in the Cocoon
community. As the community recognized that it had a more common value, the
source resolving was donated to the Avalon Excalibur project and there it was
refined and redesigned. Now the way back takes place by reintegrating the Avalon
Excalibur Source Resolving into Cocoon and deprecating the now obsolete Cocoon
Source Resolving.</p>

<h2>The Interfaces</h2>

<p>Besides the package names the main difference is that the Cocoon Source
object is XMLizable, that means it can directly send SAX events. The AE Source
object is not XMLizable, which is more correct as a protocol only describes the
way of transport but not the format of the data which is transfered. Therefore
it provides a getMimeType() method.</p>


<p>The Cocoon Source object returns a last modified time stamp which is very
limiting. For example a source could have an expires date or something like
that. The AE Source returns a validity object which is capable of all these
validity checkings. So the information used for validity checking is provided by
the source object and not maintained by the client of the source as it is
currently in Cocoon.</p>


<p>As we in Cocoonland are dealing a lot with XML, a Source implementation can
still implement the XMLizable Interface (from AE and not from Cocoon!) to
directly provide SAX events. The Cocoon SourceUtil class has a method toSAX()
which gets a Source object and tests if it implements the XMLizable interface.
If not the new AE XMLizer is used which is a component that can convert an input
stream with a given mime-type to SAX events. This component is configurable and


The document belongs to the following collections: legacydocs

View raw message