upgrade-03-04.html 2.3 KB

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