Allows you to connect your applications with SaaS providers such as Facebook and Twitter.
Java Other
Latest commit 1e9fefb Feb 3, 2017 @habuma habuma committed on GitHub Merge pull request #222 from wilkinsona/thymeleaf-spring5
Use thymeleaf-spring5 to align with Spring Framework version
Permalink
Failed to load latest commit information.
.github Add GitHub PR and Issue templates Oct 12, 2016
docs s/approprate/appropriate Feb 9, 2016
gradle/wrapper Merge Spring Social 2.0.0 work Nov 28, 2016
spring-social-config Add Javadoc for PR #113 and polish Nov 23, 2015
spring-social-core/src Fix JavaDoc warning Jan 20, 2017
spring-social-security/src Merge Spring Social 2.0.0 work Nov 28, 2016
spring-social-web-thymeleaf3/src/main/java/org/springframework/social/connect/web/thymeleaf Use thymeleaf-spring5 to align with Spring Framework version Jan 26, 2017
spring-social-web/src Merge PR #123 Jan 19, 2017
src Remove Thymeleaf 2 support. Jan 23, 2017
.gitignore Add extension point to decorate RestTemplate or other parts May 7, 2015
.travis.yml Add .travis.yml Oct 10, 2016
CODE_OF_CONDUCT.adoc Add code of conduct Feb 4, 2016
CONTRIBUTING.adoc Update CONTRIBUTING.adoc Oct 12, 2016
LICENSE Further work on the new submodule-less Gradle build Apr 12, 2012
NOTICE Further work on the new submodule-less Gradle build Apr 12, 2012
README.md Fixed links to Javadoc and reference docs Sep 20, 2016
build.gradle Use thymeleaf-spring5 to align with Spring Framework version Jan 26, 2017
gradle.properties Use thymeleaf-spring5 to align with Spring Framework version Jan 26, 2017
gradlew Update build to use newest dependency management plugin Oct 12, 2016
gradlew.bat Update build to use newest dependency management plugin Oct 12, 2016
publish-maven.gradle Polish and update metadata in publish-maven.gradle Feb 3, 2014
settings.gradle Remove Thymeleaf 2 support. Jan 23, 2017

README.md

Spring Social

Spring Social is an extension of the Spring Framework that helps you connect your applications with Software-as-a-Service (SaaS) providers such as Facebook and Twitter.

Features

  • An extensible service provider framework that greatly simplifies the process of connecting local user accounts to hosted provider accounts.

  • A connect controller that handles the authorization flow between your Java/Spring web application, a service provider, and your users.

  • Java bindings to popular service provider APIs such as Facebook, Twitter, LinkedIn, TripIt, and GitHub.

  • A sign-in controller that enables users to authenticate with your application by signing in through a service provider.

  • Much more...

Download Artifacts

See downloading Spring artifacts for Maven repository information. Unable to use Maven or other transitive dependency management tools? See building a distribution with dependencies.

Dependencies

<dependency>
    <groupId>org.springframework.social</groupId>
    <artifactId>spring-social-core</artifactId>
    <version>${org.springframework.social-version}</version>
</dependency>

<dependency>
    <groupId>org.springframework.social</groupId>
    <artifactId>spring-social-web</artifactId>
    <version>${org.springframework.social-version}</version>
</dependency>

Repositories

<repository>
    <id>spring-repo</id>
    <name>Spring Repository</name>
    <url>http://repo.spring.io/release</url>
</repository>   

<repository>
    <id>spring-milestone</id>
    <name>Spring Milestone Repository</name>
    <url>http://repo.spring.io/milestone</url>
</repository>

<repository>
    <id>spring-snapshot</id>
    <name>Spring Snapshot Repository</name>
    <url>http://repo.spring.io/snapshot</url>
</repository>

Spring Social Modules

The core Spring Social project does not contain provider modules. Each of the provider modules is in its own project. This enables those modules to progress and release on a separate schedule than Spring Social and be able to react more quickly to changes in the provider's API without the need to wait for a Spring Social release. The SaaS provider-specific projects can be cloned from the following GitHub URLs:

Documentation

See the current Javadoc and reference docs. To get up and running quickly using the project, see the Quick Start guide.

Sample Applications

Several example projects are available in the samples repository.

Issue Tracking

Report issues via the Spring Social JIRA. While JIRA is preferred, GitHub issues are also welcome. Understand our issue management process by reading about the lifecycle of an issue.

Build from Source

  1. Clone the repository from GitHub:

    $ git clone https://github.com/spring-projects/spring-social.git
  2. Navigate into the cloned repository directory:

    $ cd spring-social
  3. The project uses Gradle to build:

    $ ./gradlew build
  4. Install jars into your local Maven cache (optional)

    $ ./gradlew install

Import Source into your IDE

Eclipse

  1. To generate Eclipse metadata (.classpath and .project files):

    $ ./gradlew eclipse
  2. Once complete, you may then import the projects into Eclipse as usual:

    File -> Import -> Existing projects into workspace
    

Note: Spring Tool Suite has built in support for Gradle, and you can simply import as Gradle projects.

IDEA

Generate IDEA metadata (.iml and .ipr files):

$ ./gradlew idea

Contributing

Pull requests are welcome. See the contributor guidelines for details.

License

Spring Social is released under version 2.0 of the Apache License.