xerces.properties 2.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. #
  2. # Copyright 2003,2004 The Apache Software Foundation.
  3. #
  4. # Licensed under the Apache License, Version 2.0 (the "License");
  5. # you may not use this file except in compliance with the License.
  6. # You may obtain a copy of the License at
  7. #
  8. # http://www.apache.org/licenses/LICENSE-2.0
  9. #
  10. # Unless required by applicable law or agreed to in writing, software
  11. # distributed under the License is distributed on an "AS IS" BASIS,
  12. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. # See the License for the specific language governing permissions and
  14. # limitations under the License.
  15. #
  16. # @author Neil Graham
  17. # @version $Id$
  18. ##########################################
  19. # When you create a Xerces parser, either directly using a native
  20. # class like org.apache.xerces.parsers.DOMParser, or via a
  21. # standard API like JAXP, Xerces provides a dynamic means of
  22. # dynamically selecting a "configuration" for that parser.
  23. # Configurations are the basic mechanism Xerces uses to decide
  24. # exactly how it will treat an XML document (e.g., whether it
  25. # needs to know about Schema validation, whether it needs to be
  26. # cognizant of potential denial-of-service attacks launched via
  27. # malicious XML documents, etc.) The steps are threefold:
  28. #
  29. # * first, Xerces will examine the system property
  30. # org.apache.xerces.xni.parser.XMLParserConfiguration;
  31. # * next, it will try and find a file called xerces.properties in
  32. # the lib subdirectory of your JRE installation;
  33. # * next, it will examine all the jars on your classpath to try
  34. # and find one with the appropriate entry in its
  35. # META-INF/services directory.
  36. # * if all else fails, it will use a hardcoded default.
  37. #
  38. # The third step can be quite time-consuming, especially if you
  39. # have a lot of jars on your classpath and run applications which
  40. # require the creation of lots of parsers. If you know you're
  41. # only using applications which require "standard" API's (that
  42. # is, don't need some special Xerces property), or you want to
  43. # try and force applications to use only certain Xerces
  44. # configurations, then you may wish to copy this file into your
  45. # JRE's lib directory and uncomment the entry below. We try and
  46. # ensure that this file contains the currently-recommended default
  47. # configuration; if you know which configuration you want, you may
  48. # substitute that class name for what we've provided here.
  49. # org.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.parsers.XIncludeAwareParserConfiguration