ArticleRepository

Overview

The ArticleRepository defines the contract for accessing article data in the Space Flight News app. It provides methods to fetch articles with optional filtering and retrieve individual article details. Package: com.bsvillarraga.spaceflightnews.domain.repository Implementation: ArticleRepositoryImpl

Interface

interface ArticleRepository {
    suspend fun getArticles(query: String? = null): Resource<List<Article>>
    suspend fun getArticleById(articleId: Long): Resource<ArticleDetail>
}

Methods

getArticles

Retrieves a list of articles from the API with optional search filtering.

suspend fun getArticles(
    query: String? = null
): Resource<List<Article>>

query

String?

default:"null"

Optional search query to filter articles by title, summary, or content

return

Resource<List<Article>>

A Resource wrapper containing either:

Resource.Success<List<Article>> - List of articles matching the query
Resource.Error - Error information including error code and message

Example Usage

class ArticleViewModel @Inject constructor(
    private val repository: ArticleRepository
) : ViewModel() {
    
    fun loadArticles(searchQuery: String? = null) {
        viewModelScope.launch {
            when (val result = repository.getArticles(searchQuery)) {
                is Resource.Success -> {
                    val articles = result.data
                    // Update UI with articles
                }
                is Resource.Error -> {
                    // Handle error
                    val errorMessage = result.message
                }
            }
        }
    }
}

getArticleById

Retrieves detailed information for a specific article by its unique identifier.

suspend fun getArticleById(articleId: Long): Resource<ArticleDetail>

articleId

Long

required

The unique identifier of the article to retrieve

return

Resource<ArticleDetail>

A Resource wrapper containing either:

Resource.Success<ArticleDetail> - Complete article details including authors, summary, and metadata
Resource.Error - Error information if the article is not found or request fails

Example Usage

class ArticleDetailViewModel @Inject constructor(
    private val repository: ArticleRepository
) : ViewModel() {
    
    fun loadArticleDetail(articleId: Long) {
        viewModelScope.launch {
            when (val result = repository.getArticleById(articleId)) {
                is Resource.Success -> {
                    val article = result.data
                    // Display article details
                }
                is Resource.Error -> {
                    // Show error message
                    Log.e(TAG, "Error: ${result.message}")
                }
            }
        }
    }
}

Implementation