2011-12-20 17:36:59 +08:00
|
|
|
## Spring Framework
|
|
|
|
|
The Spring Framework provides a comprehensive programming and configuration model for modern
|
|
|
|
|
Java-based enterprise applications - on any kind of deployment platform. A key element of Spring is
|
|
|
|
|
infrastructural support at the application level: Spring focuses on the "plumbing" of enterprise
|
|
|
|
|
applications so that teams can focus on application-level business logic, without unnecessary ties
|
|
|
|
|
to specific deployment environments.
|
|
|
|
|
|
|
|
|
|
The framework also serves as the foundation for
|
|
|
|
|
[Spring Integration](https://github.com/SpringSource/spring-integration),
|
2011-12-21 03:23:25 +08:00
|
|
|
[Spring Batch](https://github.com/SpringSource/spring-batch) and the rest of the Spring
|
|
|
|
|
[family of projects](http://springsource.org/projects). Browse the repositories under the
|
2011-12-20 17:36:59 +08:00
|
|
|
[SpringSource organization](https://github.com/SpringSource) on GitHub for a full list.
|
|
|
|
|
|
|
|
|
|
[.NET](https://github.com/SpringSource/spring-net) and
|
|
|
|
|
[Python](https://github.com/SpringSource/spring-python) variants are available as well.
|
|
|
|
|
|
|
|
|
|
## Downloading artifacts
|
|
|
|
|
Instructions on
|
|
|
|
|
[downloading Spring artifacts](https://github.com/SpringSource/spring-framework/wiki/Downloading-Spring-artifacts)
|
|
|
|
|
via Maven and other build systems are available via the project wiki.
|
|
|
|
|
|
|
|
|
|
## Documentation
|
2012-01-17 05:16:43 +08:00
|
|
|
See the current [Javadoc](http://static.springsource.org/spring-framework/docs/current/api)
|
|
|
|
|
and [Reference docs](http://static.springsource.org/spring-framework/docs/current/reference).
|
2011-12-20 17:36:59 +08:00
|
|
|
|
|
|
|
|
## Getting support
|
|
|
|
|
Check out the [Spring forums](http://forum.springsource.org) and the
|
|
|
|
|
[Spring tag](http://stackoverflow.com/questions/tagged/spring) on StackOverflow.
|
|
|
|
|
[Commercial support](http://springsource.com/support/springsupport) is available too.
|
|
|
|
|
|
|
|
|
|
## Issue Tracking
|
|
|
|
|
Spring's JIRA issue tracker can be found [here](http://jira.springsource.org/browse/SPR). Think
|
|
|
|
|
you've found a bug? Please consider submitting a reproduction project via the
|
2012-01-20 21:53:56 +08:00
|
|
|
[spring-framework-issues](https://github.com/SpringSource/spring-framework-issues) repository. The
|
|
|
|
|
[readme](https://github.com/SpringSource/spring-framework-issues#readme) provides simple
|
|
|
|
|
step-by-step instructions. <a name="building_from_source"/>
|
|
|
|
|
|
2011-12-20 17:36:59 +08:00
|
|
|
|
|
|
|
|
## Building from source
|
2012-01-20 21:53:56 +08:00
|
|
|
The Spring Framework uses a [Gradle](http://gradle.org)-based build system. In the instructions
|
|
|
|
|
below, [`./gradlew`](http://vimeo.com/34436402) is invoked from the root of the source tree and
|
|
|
|
|
serves as a cross-platform, self-contained bootstrap mechanism for the build. The only
|
|
|
|
|
prerequisites are [git](http://help.github.com/set-up-git-redirect) and JDK 1.6+.
|
|
|
|
|
|
|
|
|
|
### check out sources
|
|
|
|
|
`git clone git://github.com/SpringSource/spring-framework.git`
|
|
|
|
|
|
|
|
|
|
### compile and test, build all jars, distribution zips and docs
|
|
|
|
|
`./gradlew build`
|
|
|
|
|
|
|
|
|
|
### install all spring-\* jars into your local Maven cache
|
|
|
|
|
`./gradlew install`
|
|
|
|
|
|
|
|
|
|
### import sources into your IDE
|
|
|
|
|
Run `./import-into-eclipse.sh` or read `import-into-idea.md` as appropriate.
|
|
|
|
|
|
|
|
|
|
... and discover more commands with `./gradlew tasks`. See also the
|
|
|
|
|
[Gradle build and release FAQ](https://github.com/SpringSource/spring-framework/wiki/Gradle-build-and-release-FAQ).
|
2011-12-20 17:36:59 +08:00
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
[Pull requests](http://help.github.com/send-pull-requests) are welcome; you'll be asked to sign our
|
|
|
|
|
contributor license agreement ([CLA](https://support.springsource.com/spring_committer_signup)).
|
|
|
|
|
Trivial changes like typo fixes are especially appreciated (just
|
|
|
|
|
[fork and edit!](https://github.com/blog/844-forking-with-the-edit-button)). For larger changes,
|
2011-12-21 03:23:25 +08:00
|
|
|
please search through JIRA for similiar issues, creating a new one if necessary, and discuss your
|
|
|
|
|
ideas with the Spring team.
|
2011-12-20 17:36:59 +08:00
|
|
|
|
|
|
|
|
## Staying in touch
|
|
|
|
|
Follow [@springframework](http://twitter.com/springframework) and its
|
|
|
|
|
[team members](http://twitter.com/springframework/team/members) on Twitter. In-depth articles can be
|
|
|
|
|
found at the SpringSource [team blog](http://blog.springsource.org), and releases are announced via
|
|
|
|
|
our [news feed](http://www.springsource.org/news-events).
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
The Spring Framework is released under version 2.0 of the
|
|
|
|
|
[Apache License](http://www.apache.org/licenses/LICENSE-2.0).
|
