home *** CD-ROM | disk | FTP | other *** search
/ PC World 2000 November / PCWorld_2000-11_cd.bin / Komunik / sambar444 / _SETUP.1 / javaeng.jar / javax / README < prev   
Text File  |  2000-08-09  |  2KB  |  48 lines
  1. This is a LGPL'ed implementation of sun's java servlet api version 2.0
  2. and version 2.1.
  3. They were originally made by me (Paul Siegmann) and Mark Wielaard has made
  4. them version 2.1 compliant.
  5. Then I added a dirty hack to enable the creation of both 2.0 and 2.1 source
  6. code from a single source tree.
  7. See *How can you implement two api versions with a single source tree?*
  8.  
  9. Look for updates on: http://www.euronet.nl/~pauls/java/
  10.  
  11. Status of the classes
  12. =====================
  13. Feature complete and fully functional as a drop-in replacement on _my_ system.
  14. Not yet stress-tested.
  15. I have serious doubts about the thread-safeness and the "weird-input robustness"
  16. of the library.
  17. On the bright side: the documentation covers nearly 100% of the functionality.
  18.  
  19. I want to use the classes
  20. =========================
  21. Not a good idea, see *Status of the classes*.
  22.  
  23. I want to test the classes
  24. ==========================
  25. Great! that's wat this release is intended for.
  26. Could you tell me whether they work and if so on what kind of system.
  27. If they do not behave as they should then please provide as much detail
  28. as possible.
  29. Patches are very welcome, but see *I want to send a patch*
  30.  
  31. I want to send a patch
  32. ======================
  33. Great idea. But !!!:
  34. Really Important(tm): if you've _ever_ taken a look at the source code of
  35. sun's servlet developement kit, then please _don't_ send me a patch.
  36. If you do then I'd be violating sun's copyright, which could get both me
  37. and this library in big trouble.
  38.  
  39. How can you implement two api versions with a single source tree?
  40. =================================================================
  41. I added #ifdef VERSION_2_1 ... #endif tags to the code and wrote a class to generate the source code on the basis of these tags.
  42. This is a really dirty hack which I feel really guilty about, but I saw no
  43. other way.
  44. The two api versions are nearly identical, neither of them have been seriously tested so they might change radically and almost equally in the near future.
  45. This would require lots of updates on 2 almost identical source trees.
  46. So I added the tag system, which seems to work OK for now.
  47. When the implementations have stabilized and proven themselves I might split the source tree again.
  48.