Social

Social Module Documentation

Table of Contents

• Overview
• Components
  • SocialFragment
  • SocialPost
  • SocialPostAdapter
  • PostCreateFragment

---

Overview

The Social Module provides a comprehensive solution for managing social posts within the application. It follows the MVVM architecture and leverages Android’s modern components for efficient UI updates and data handling.

Key Features

• Social post creation and management
• Post preview and organization
• Tag recommendations
• Search history management
• Efficient data management

---

Components

SocialFragment

Purpose

SocialFragment serves as the main UI component for displaying social posts and handling user interactions. It manages post display, creation, and user interactions.

Key Methods

onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

Initializes the RecyclerView, sets up the adapter, and binds ViewModel data.

Implementation Details:

• Sets up a list layout for social posts.
• Observes SocialPostViewModel's post list for data changes.
• Handles post creation and user interactions.
• Initializes tag recommendations and search history.

onPostClick(SocialPost post)

@Override
public void onPostClick(SocialPost post)

Handles post click events, launching the detail view for the selected post.

createNewPost()

public void createNewPost()

Launches the post creation fragment.

Implementation Details:

• Navigates to PostCreateFragment for creating a new post.

loadTagRecommendations()

public void loadTagRecommendations()

Loads recommended tags for the post creation.

Implementation Details:

• Fetches tags from a predefined list or API.
• Displays tags in a horizontal RecyclerView.

saveSearchHistory(String query)

public void saveSearchHistory(String query)

Saves the search query to the search history.

Implementation Details:

• Stores the query in SharedPreferences or a local database.
• Limits the history to a certain number of entries.

Usage Example

SocialFragment fragment = new SocialFragment();
getSupportFragmentManager()
    .beginTransaction()
    .replace(R.id.container, fragment)
    .commit();

---

SocialPost

Purpose

SocialPost represents a social post entity, containing post data such as title, content, and tags.

Key Properties

private String title
private String content
private List<String> tags

Key Methods

getTitle()

public String getTitle()

Returns the title of the post.

getContent()

public String getContent()

Returns the content of the post.

getTags()

public List<String> getTags()

Returns the tags associated with the post.

Usage Example

SocialPost post = new SocialPost("My Post", "This is a post content", Arrays.asList("tag1", "tag2"));

---

SocialPostAdapter

Purpose

SocialPostAdapter is a RecyclerView adapter for displaying social posts in a list. It manages post loading and click event delegation.

Key Components

Constructor

public SocialPostAdapter(List<SocialPost> postList, OnPostClickListener listener)

Initializes the adapter with a list of social posts and a click listener.

updateData(List<SocialPost> postList)

public void updateData(List<SocialPost> postList)

Updates the adapter’s data and refreshes the view.

ViewHolder

class PostViewHolder extends RecyclerView.ViewHolder

Holds references to the post views.

OnPostClickListener

public interface OnPostClickListener {
    void onPostClick(SocialPost post);
}

Callback interface for post click events.

Usage Example

SocialPostAdapter adapter = new SocialPostAdapter(postList, post -> {
    // Handle post click
});
recyclerView.setAdapter(adapter);

---

PostCreateFragment

Purpose

PostCreateFragment provides a UI for creating new social posts, including title, content, and tag input.

Key Methods

onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

Initializes the post creation UI and handles user input.

Implementation Details:

• Sets up input fields for title, content, and tags.
• Handles post submission and validation.

submitPost()

public void submitPost()

Submits the new post to the ViewModel for processing.

Implementation Details:

• Validates input fields.
• Creates a new SocialPost object and passes it to the ViewModel.

Usage Example

PostCreateFragment fragment = new PostCreateFragment();
getSupportFragmentManager()
    .beginTransaction()
    .replace(R.id.container, fragment)
    .commit();