NetworkDataSource

Network data source for fetching remote data via REST API.

This interface defines the contract for making network requests to retrieve data from remote endpoints. It serves as an abstraction layer over the underlying REST API implementation, allowing repositories to fetch network data without depending on specific HTTP client details.

Design Pattern

This follows the Data Source Pattern:

• Encapsulates all network communication logic

• Returns domain-agnostic network models (NetworkPost)

• Throws exceptions on network errors (handled by repositories with dev.atick.core.utils.suspendRunCatching)

• Executes on IO dispatcher (automatically handled by implementation)

Illustrative repository extension

The local-data and Post mapping APIs below would need to be supplied by the adopter.

class PostsRepository @Inject constructor(
    private val networkDataSource: NetworkDataSource,
    private val localDataSource: LocalDataSource
) {
    suspend fun syncPosts(): Result<Unit> = suspendRunCatching {
        val networkPosts = networkDataSource.getPosts()
        localDataSource.savePosts(networkPosts.map { it.toEntity() })
    }

    suspend fun getPostById(id: Int): Result<Post> = suspendRunCatching {
        networkDataSource.getPost(id).toDomainModel()
    }
}

Error Handling

This interface does not return Result types. Instead:

• Network errors throw java.io.IOException

• HTTP errors throw retrofit2.HttpException

• Repositories should wrap calls with dev.atick.core.utils.suspendRunCatching

Threading

All suspend functions execute on the IO dispatcher automatically. Callers should not wrap calls with kotlinx.coroutines.withContext - the implementation handles dispatching.

See also