upgrade-03-04.txt 2.3 KB

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