Spring Social Facebook 项目技术文档

1. 安装指南

由于 spring-social-facebook 项目已不再由 VMware, Inc. 主动维护，建议用户在安装和使用时注意以下几点：

1. 依赖管理：确保你的项目中已经引入了 Spring Social 的相关依赖。
2. 版本选择：由于项目不再维护，建议使用较旧的稳定版本，避免使用最新的不稳定版本。
3. 替代方案：如果需要使用 Facebook 的社交功能，建议考虑其他活跃维护的库或直接使用 Facebook 提供的官方 SDK。

2. 项目的使用说明

2.1 配置 Facebook 应用

在使用 spring-social-facebook 之前，你需要在 Facebook 开发者平台上创建一个应用，并获取以下信息：

• App ID
• App Secret

2.2 配置 Spring Social

在你的 Spring 项目中，配置 SocialConfigurer 以连接 Facebook：

@Configuration
@EnableSocial
public class SocialConfig extends SocialConfigurerAdapter {

    @Override
    public void addConnectionFactories(ConnectionFactoryConfigurer configurer, Environment environment) {
        configurer.addConnectionFactory(new FacebookConnectionFactory(
            "your-app-id",
            "your-app-secret"
        ));
    }
}

2.3 用户认证

通过 Spring Security 或其他认证机制，确保用户能够通过 Facebook 进行登录。

3. 项目 API 使用文档

3.1 获取用户信息

使用 Facebook 对象获取当前登录用户的基本信息：

Facebook facebook = connectionRepository.getPrimaryConnection(Facebook.class).getApi();
User userProfile = facebook.userOperations().getUserProfile();
System.out.println("User ID: " + userProfile.getId());
System.out.println("User Name: " + userProfile.getName());

3.2 发布动态

通过 Facebook 对象发布动态到用户的 Facebook 墙：

facebook.feedOperations().updateStatus("Hello Facebook!");

3.3 获取好友列表

获取当前登录用户的好友列表：

List<Reference> friends = facebook.friendOperations().getFriendProfiles();
for (Reference friend : friends) {
    System.out.println("Friend ID: " + friend.getId());
    System.out.println("Friend Name: " + friend.getName());
}

4. 项目安装方式

由于项目不再维护，建议通过以下方式安装旧版本：

1. Maven：

   <dependency>
       <groupId>org.springframework.social</groupId>
       <artifactId>spring-social-facebook</artifactId>
       <version>2.0.3.RELEASE</version>
   </dependency>
   

2. Gradle：

   implementation 'org.springframework.social:spring-social-facebook:2.0.3.RELEASE'
   

请注意，由于项目不再维护，建议在生产环境中谨慎使用，并考虑其他替代方案。