README.adoc 2.5 KB
Newer Older
S
shaehnel 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
= Spring Security

Spring Security provides security services for the http://docs.spring.io[Spring IO Platform]. Spring Security 3.1 requires Spring 3.0.3 as
a minimum and also requires Java 5.

For a detailed list of features and access to the latest release, please visit http://spring.io/projects[Spring projects].

== Downloading Artifacts
See https://github.com/spring-projects/spring-framework/wiki/Downloading-Spring-artifacts[downloading Spring artifacts] for Maven repository information.

== Documentation
Be sure to read the http://docs.spring.io/spring-security/site/docs/current/reference/htmlsingle/[Spring Security Reference].
Extensive JavaDoc for the Spring Security code is also available in the http://docs.spring.io/spring-security/site/docs/current/apidocs/[Spring Security API Documentation].

== Quick Start
We recommend you visit http://docs.spring.io/spring-security/site/docs/current/reference/htmlsingle/[Spring Security Reference] and read the "Getting Started" page.

== Building from Source
R
Rob Winch 已提交
19
Spring Security uses a http://gradle.org[Gradle]-based build system.
S
shaehnel 已提交
20 21 22 23
In the instructions below, http://vimeo.com/34436402[`./gradlew`] is invoked from the root of the source tree and serves as
a cross-platform, self-contained bootstrap mechanism for the build.

=== Prerequisites
R
Rob Winch 已提交
24
http://help.github.com/set-up-git-redirect[Git] and the http://www.oracle.com/technetwork/java/javase/downloads[JDK7 build].
S
shaehnel 已提交
25

R
Rob Winch 已提交
26
Be sure that your `JAVA_HOME` environment variable points to the `jdk1.7.0` folder extracted from the JDK download.
S
shaehnel 已提交
27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45

=== Check out sources
[indent=0]
----
git clone git@github.com:spring-projects/spring-security.git
----

=== Install all spring-\* jars into your local Maven cache
[indent=0]
----
./gradlew install
----

=== Compile and test; build all jars, distribution zips, and docs
[indent=0]
----
./gradlew build
----

R
Rob Winch 已提交
46
Discover more commands with `./gradlew tasks`.
S
shaehnel 已提交
47 48 49
See also the https://github.com/spring-projects/spring-framework/wiki/Gradle-build-and-release-FAQ[Gradle build and release FAQ].

== Getting Support
R
Rob Winch 已提交
50
Check out the http://stackoverflow.com/questions/tagged/spring-security[Spring Security tags on Stack Overflow].
S
shaehnel 已提交
51 52 53 54 55 56
http://spring.io/services[Commercial support] is available too.

== Contributing
http://help.github.com/send-pull-requests[Pull requests] are welcome; see the https://github.com/spring-projects/spring-security/blob/master/CONTRIBUTING.md[contributor guidelines] for details.

== License
R
Rob Winch 已提交
57
Spring Security is Open Source software released under the
S
shaehnel 已提交
58
http://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 license].