upgrade-090-100.html 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. <html>
  2. <head>
  3. <title>Acegi Security - Upgrading from version 0.8.0 to 1.0.0</title>
  4. </head>
  5. <body>
  6. <h1>Upgrading from 0.9.0 to 1.0.0</h1>
  7. <p>
  8. The following should help most casual users of the project update their
  9. applications:
  10. <ul>
  11. <h1>Changes 0.9.0 to RC1</h1>
  12. <li>The top level package name has changed. Simply find "net.sf.acegisecurity" and replace with
  13. "org.acegisecurity".</li>
  14. <li>
  15. DaoAuthenticationProvider has a property, authenticationDao. This property should now be renamed to
  16. userDetailsService.
  17. </li>
  18. <li>
  19. In JSPs, each "authz" taglib prefix must be changed from uri="http://acegisecurity.sf.net/authz"
  20. to uri="http://acegisecurity.org/authz".
  21. </li>
  22. <li>net.sf.acegisecurity.providers.dao.AuthenticationDao is now org.acegisecurity.userdetails.UserDetailsService.
  23. The interface signature has not changed. Similarly, User and UserDetails have moved into the latter's package as well.
  24. If you've implemented your own AuthenticationDao, you'll need to change the class it's implementing and quite likely
  25. the import packages for User and UserDetails. In addition, if using JdbcDaoImpl or InMemoryDaoImpl please
  26. note they have moved to this new package.</li>
  27. <li>Acegi Security is now localised. In net.sf.acegisecurity you will find a messages.properties. It is
  28. suggested to register this in your application context, perhaps using ReloadableResourceBundleMessageSource.
  29. If you do not do this, the default messages included in the source code will be used so this change is
  30. not critical. The Spring LocaleContextHolder class is used to determine the locale of messages included in
  31. exceptions. At present only the default messages.properties is included (which is in English). If
  32. you localise this file to another language, please consider attaching it to a
  33. <a href="http://opensource2.atlassian.com/projects/spring/secure/BrowseProject.jspa?id=10040">new JIRA task</a>
  34. so that we can include it in future Acegi Security releases.</li>
  35. <h1>Changes RC1 to RC2</h1>
  36. <li>
  37. org.acegisecurity.ui.rememberme.RememberMeProcessingFilter now requires an authenticationManager property. This will generally
  38. point to an implementation of org.acegisecurity.providers.ProviderManager.
  39. </li>
  40. <li>
  41. org.acegisecurity.intercept.web.AuthenticationEntryPoint has moved to a new location,
  42. org.acegisecurity.ui.AuthenticationEntryPoint.
  43. </li>
  44. <li>
  45. org.acegisecurity.intercept.web.SecurityEnforcementFilter has moved to a new location and name,
  46. org.acegisecurity.ui.ExceptionTranslationFilter. In addition, the "filterSecurityInterceptor"
  47. property on the old SecurityEnforcementFilter class has been removed. This is because
  48. SecurityEnforcementFilter will no longer delegate to FilterSecurityInterceptor as it has in the
  49. past. Because this delegation feature has been removed (see SEC-144 for a background as to why),
  50. please add a new filter definition for FilterSecurityInterceptor to the end of your
  51. FilterChainProxy. Generally you'll also rename the old SecurityEnforcementFilter entry in your
  52. FilterChainProxy to ExceptionTranslationFilter, more accurately reflecting its purpose.
  53. If you are not using FilterChainProxy (although we recommend that you do), you will need to add
  54. an additional filter entry to web.xml and use FilterToBeanProxy to access the FilterSecurityInterceptor.
  55. </li>
  56. </ul>
  57. </body>
  58. </html>