From 3b7453d243901d8378fc8fd97b09ee17a763f09b Mon Sep 17 00:00:00 2001 From: Ben Alex Date: Sun, 21 Nov 2004 21:48:31 +0000 Subject: [PATCH] Move upgrade help files to xdocs/upgrade. --- .../xdocs/upgrade/upgrade-03-04.html | 48 ++++++----- .../xdocs/upgrade/upgrade-04-05.html | 46 ++++++----- doc/xdocs/upgrade/upgrade-05-06.html | 81 +++++++++++++++++++ .../xdocs/upgrade/upgrade-06-07.html | 29 ++++--- upgrade-05-06.txt | 70 ---------------- 5 files changed, 152 insertions(+), 122 deletions(-) rename upgrade-03-04.txt => doc/xdocs/upgrade/upgrade-03-04.html (58%) rename upgrade-04-05.txt => doc/xdocs/upgrade/upgrade-04-05.html (64%) create mode 100644 doc/xdocs/upgrade/upgrade-05-06.html rename upgrade-06-07.txt => doc/xdocs/upgrade/upgrade-06-07.html (77%) delete mode 100644 upgrade-05-06.txt diff --git a/upgrade-03-04.txt b/doc/xdocs/upgrade/upgrade-03-04.html similarity index 58% rename from upgrade-03-04.txt rename to doc/xdocs/upgrade/upgrade-03-04.html index 028489eabe..ceb66fe29d 100644 --- a/upgrade-03-04.txt +++ b/doc/xdocs/upgrade/upgrade-03-04.html @@ -1,47 +1,53 @@ -=============================================================================== - ACEGI SECURITY SYSTEM FOR SPRING - UPGRADING FROM 0.3 TO 0.4 -=============================================================================== + + +Acegi Security - Upgrading from version 0.3 to 0.4 + + +

Upgrading from 0.3 to 0.4

-Several changes were made between version 0.3 and 0.4 of the project. +

Several changes were made between version 0.3 and 0.4 of the project. These changes increased the modularity of the code, enhanced unit testing, made package roles clearer, and added compelling alternatives to container adapters and using web.xml security constraints to protect HTTP resources. -Unfortunately, changes to the API and package locations were required. The +

Unfortunately, changes to the API and package locations were required. The following should help most casual users of the project update their applications: -- All references to net.sf.acegisecurity.SecurityInterceptor become - net.sf.acegisecurity.intercept.method.MethodSecurityInterceptor. +

+

We hope you find the new features useful in your projects. - -$Id$ + + diff --git a/upgrade-04-05.txt b/doc/xdocs/upgrade/upgrade-04-05.html similarity index 64% rename from upgrade-04-05.txt rename to doc/xdocs/upgrade/upgrade-04-05.html index de67f658b0..38c698d8d1 100644 --- a/upgrade-04-05.txt +++ b/doc/xdocs/upgrade/upgrade-04-05.html @@ -1,51 +1,59 @@ -=============================================================================== - ACEGI SECURITY SYSTEM FOR SPRING - UPGRADING FROM 0.4 TO 0.5 -=============================================================================== + + +Acegi Security - Upgrading from version 0.4 to 0.5 + + +

Upgrading from 0.4 to 0.5

-The following should help most casual users of the project update their +

The following should help most casual users of the project update their applications: +

+

There are also lots of new features you might wish to consider for your projects. These include CAS integration, pluggable password encoders (such as MD5 and SHA), along with pluggable salt sources. We hope you find the new features useful in your projects. -$Id$ + + + diff --git a/doc/xdocs/upgrade/upgrade-05-06.html b/doc/xdocs/upgrade/upgrade-05-06.html new file mode 100644 index 0000000000..d372ef4331 --- /dev/null +++ b/doc/xdocs/upgrade/upgrade-05-06.html @@ -0,0 +1,81 @@ + + +Acegi Security - Upgrading from version 0.3 to 0.4 + + +

Upgrading from 0.5 to 0.6

+ +

+The following should help most casual users of the project update their +applications: +

+ + diff --git a/upgrade-06-07.txt b/doc/xdocs/upgrade/upgrade-06-07.html similarity index 77% rename from upgrade-06-07.txt rename to doc/xdocs/upgrade/upgrade-06-07.html index 5175f99501..0cb0b9b9e5 100644 --- a/upgrade-06-07.txt +++ b/doc/xdocs/upgrade/upgrade-06-07.html @@ -1,11 +1,15 @@ -=============================================================================== - ACEGI SECURITY SYSTEM FOR SPRING - UPGRADING FROM 0.6 TO 0.7 -=============================================================================== + + +Acegi Security - Upgrading from version 0.6 to 0.7 + + +

Upgrading from 0.6 to 0.7

+

The following should help most casual users of the project update their applications: - -- MethodDefinitionMap, which is usually used by MethodSecurityInterceptor +

+ + diff --git a/upgrade-05-06.txt b/upgrade-05-06.txt deleted file mode 100644 index 0c04bf1d5e..0000000000 --- a/upgrade-05-06.txt +++ /dev/null @@ -1,70 +0,0 @@ -=============================================================================== - ACEGI SECURITY SYSTEM FOR SPRING - UPGRADING FROM 0.5 TO 0.6 -=============================================================================== - -The following should help most casual users of the project update their -applications: - -- Locate and remove all property references to - DaoAuthenticationProvider.key and - DaoAuthenticationProvider.refreshTokenInterval. - -- If you are using DaoAuthenticationProvider and either (i) you are using - container adapters or (ii) your code relies on the Authentication object - having its getPrincipal() return a String, you must set the new - DaoAuthenticationProvider property, forcePrincipalAsString, to true. - By default DaoAuthenticationProvider returns an Authentication object - containing the relevant User, which allows access to additional properties. - Where possible, we recommend you change your code to something like this, - so that you can leave forcePrincipalAsString to the false default: - - String username = authentication.getPrincipal(); - if (authentication.getPrincipal() instanceof User) { - username = ((User) authentication.getPrincipal()).getUsername(); - } - -- The signature of AuthenticationDaos have changed. In concrete - implementations, modify the User to UserDetails, as shown below: - - public User loadUserByUsername(String username) - throws UsernameNotFoundException, DataAccessException { - - to: - - public UserDetails loadUserByUsername(String username) - throws UsernameNotFoundException, DataAccessException { - - Existing concrete implementations would be returning User, which implements - UserDetails, so no further code changes should be required. - -- Similar signature changes (User -> UserDetails) are also required to any - custom implementations of UserCache and SaltSource. - -- Any custom event listeners relying on AuthenticationEvent should note a - UserDetails is now provided in the AuthenticationEvent (not a User). - -- CAS users should note the CasAuthoritiesPopulator interface signature has - changed. Most CAS users will be using DaoCasAuthoritiesPopulator, so this - change is unlikely to require any action. - -- Please check your web.xml for whether you are using AutoIntegrationFilter. - Previously this class was loaded directly by web.xml as a filter. It is - now recommended to load it via FilterToBeanProxy and define it as a - bean in your application context. This usually involves making the entry - in web.xml match the following: - - - Acegi Security System for Spring Auto Integration Filter - net.sf.acegisecurity.util.FilterToBeanProxy - - targetClass - net.sf.acegisecurity.ui.AutoIntegrationFilter - - - - Then add the following to applicationContext.xml: - - - - -$Id$