46 lines
2.3 KiB
Plaintext
46 lines
2.3 KiB
Plaintext
|
===============================================================================
|
||
|
|
ACEGI SECURITY SYSTEM FOR SPRING - EXTRACTOR
|
||
|
|
===============================================================================
|
||
|
|
|
||
|
|
*** OVERVIEW ***
|
||
|
|
|
||
|
|
To compile container adapters, it is necessary to have classes from each
|
||
|
|
container on the classpath. Because container JAR files are usually quite
|
||
|
|
large, including them in the "with dependencies" release ZIPs would rapidly
|
||
|
|
bloat the file size.
|
||
|
|
|
||
|
|
Under this solution, the extractor Ant build file takes a container JAR file
|
||
|
|
and extracts only those classes required by the Acegi Security System for
|
||
|
|
Spring. The full container JARs will be provided by the relevant container at
|
||
|
|
deployment time.
|
||
|
|
|
||
|
|
Of course, the classes are extracted from specific versions of the container
|
||
|
|
JAR files. The resulting "extracted" JAR files (named in the format
|
||
|
|
container-extracted.jar), include in their manifest file various information
|
||
|
|
about the source JAR. A copy of the container license is also provided.
|
||
|
|
|
||
|
|
If you run a different container version than those the extracted JARs were
|
||
|
|
built from, you can create a build.properties that specifies your
|
||
|
|
source.dir.container. Running "ant extract-container" will then cause your
|
||
|
|
exact container JAR file to be used to build the extracted JAR, which will be
|
||
|
|
written to the Acegi Security System for Spring main lib directory. You can
|
||
|
|
then recompile the Acegi Security System for Spring and you should end up
|
||
|
|
with compatible versions.
|
||
|
|
|
||
|
|
Two unavoidable issues from doing this include your version might package
|
||
|
|
required classes differently (so the files referred to by the Ant build file
|
||
|
|
are incorrect) or your container JAR might implement different inheritance
|
||
|
|
orders, interface requirements or method signatures than those the Acegi
|
||
|
|
Security System for Spring was coded for. In such cases, please let us know or
|
||
|
|
contribute a patch that supports your container version.
|
||
|
|
|
||
|
|
*** THE "SOURCE" DIRECTORY ***
|
||
|
|
|
||
|
|
The "source" directory contains the full container JAR files that the
|
||
|
|
container-extracted.jar files are created from. We do not include these in the
|
||
|
|
"with dependencies" releases. If you need these files, please download them
|
||
|
|
from the container vendor sites (refer to project.properties for URLs) or
|
||
|
|
checkout the project from CVS.
|
||
|
|
|
||
|
|
$Id$
|