upgrade-03-04.xml 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <document><properties><title>Acegi Security - Upgrading from version 0.3 to 0.4</title></properties><body><section name="Upgrading from 0.3 to 0.4"><p>Several changes were made between version 0.3 and 0.4 of the project.
  3. These changes increased the modularity of the code, enhanced unit testing,
  4. made package roles clearer, and added compelling alternatives to container
  5. adapters and using web.xml security constraints to protect HTTP resources.
  6. </p><p>Unfortunately, changes to the API and package locations were required. The
  7. following should help most casual users of the project update their
  8. applications:
  9. <ul>
  10. <li>All references to net.sf.acegisecurity.SecurityInterceptor become
  11. net.sf.acegisecurity.intercept.method.MethodSecurityInterceptor.</li>
  12. <li>All references to net.sf.acegisecurity.MethodDefinitionAttributes become
  13. net.sf.acegisecurity.intercept.method.MethodDefinitionAttributes.</li>
  14. <li>All references to net.sf.acegisecurity.adapters.AutoIntegrationFilter become
  15. net.sf.acegisecurity.ui.AutoIntegrationFilter (see your web.xml).</li>
  16. <li>If you're using container adapters (extremely likely), consider replacing
  17. them with the net.sf.acegisecurity.ui.webapp package. This will avoid
  18. the need to have JARs in your container classloader, and is a lot cleaner.
  19. Refer to the reference documentation or Contacts sample application.</li>
  20. <li>If you're using web.xml <security-constraint>s for securing HTTP URLs
  21. (extremely likely), consider replacing it with the
  22. net.sf.acegisecurity.intercept.web package. This will give you considerably
  23. more flexibility, and reuse the same concepts as you'd be familiar with
  24. via the method security interception system. Refer to the reference
  25. documentation or Contacts sample application.</security-constraint></li>
  26. <li>The Contacts sample application now builds two distributions: contacts.war
  27. can be instantly deployed without configuring any container adapters,
  28. whilst contacts-container-adapter.war still uses container adapters. The
  29. contacts.war uses the net.sf.acegisecurity.intercept.web package to
  30. protect HTTP URLs, rather than web.xml <security-constraint>s.</security-constraint></li>
  31. <li>If you're using the Jetty container adapter, please check the jetty.xml
  32. requirements in the reference documentation. There has been a minor change.</li>
  33. </ul>
  34. </p><p>
  35. We hope you find the new features useful in your projects.
  36. </p></section></body></document>