home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-cocoon-addon-1.4.9-installer.exe / source.xml < prev    next >
Encoding:
Extensible Markup Language  |  2004-07-12  |  2.8 KB  |  66 lines
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!--
  3.   Copyright 1999-2004 The Apache Software Foundation
  4.  
  5.   Licensed under the Apache License, Version 2.0 (the "License");
  6.   you may not use this file except in compliance with the License.
  7.   You may obtain a copy of the License at
  8.  
  9.       http://www.apache.org/licenses/LICENSE-2.0
  10.  
  11.   Unless required by applicable law or agreed to in writing, software
  12.   distributed under the License is distributed on an "AS IS" BASIS,
  13.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.   See the License for the specific language governing permissions and
  15.   limitations under the License.
  16. -->
  17. <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
  18. <document>
  19. <header>
  20. <title>Cocoon Source Resolving</title>
  21.     <authors>
  22.       <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
  23.     </authors>
  24. </header>
  25. <body>
  26. <section>
  27. <title>Differences between Cocoon and Avalon Excalibur Source Resolving</title>
  28. <p>
  29. This story tries to list the changes between the two source resolving approaches. 
  30. Originally, the source resolving was developed in the Cocoon community. As the 
  31. community recognized that it had a more common value, the source resolving was 
  32. donated to the Avalon Excalibur project and there it was refined and redesigned.
  33. Now the way back takes place by reintegrating the Avalon Excalibur Source Resolving 
  34. into Cocoon and deprecating the now obsolete Cocoon Source Resolving.</p>
  35. <section>
  36. <title>The Interfaces</title>
  37. <p>
  38. Besides the package names the main difference is that the Cocoon Source object is 
  39. XMLizable, that means it can directly send SAX events.
  40. The AE Source object is not XMLizable, which is more correct as a protocol only 
  41. describes the way of transport but not the format of the data which is transfered. 
  42. Therefore it provides a getMimeType() method.</p>
  43. </section>
  44. <section>
  45. <title>Caching</title>
  46. <p>
  47. The Cocoon Source object returns a last modified time stamp which is very limiting. 
  48. For example a source could have an expires date or something like that.
  49. The AE Source returns a validity object which is capable of all these validity 
  50. checkings. So the information used for validity checking is provided by the source 
  51. object and not maintained by the client of the source as it is currently in Cocoon.</p>
  52. </section>
  53. <section>
  54. <title>XMLizable</title>
  55. <p>
  56. As we in Cocoonland are dealing a lot with XML, a Source implementation can still implement 
  57. the XMLizable Interface (from AE and not from Cocoon!) to directly provide SAX events. 
  58. The Cocoon SourceUtil class has a method toSAX() which gets a Source object and tests if 
  59. it implements the XMLizable interface. If not the new AE XMLizer is used which is a 
  60. component that can convert an input stream with a given mime-type to SAX events. 
  61. This component is configurable and extensible.</p>
  62. </section>
  63. </section>
  64. </body>
  65. </document>
  66.