Make reusable base url paths to all query builders, added new constants and queries.

Author: RajashekarRaju

app/src/main/java/com/developerbreach/developerbreach/repository/network/NetworkService.kt

@@ -1,29 +1,35 @@
 package com.developerbreach.developerbreach.repository.network
 
 import com.developerbreach.developerbreach.model.*
-import java.io.IOException
 import java.net.URL
 
 
-fun getArticles(): List<Article> {
-    val response = NetworkResponse.articleResponse()
+fun getArticles(
+    totalPostsToDoRunQueryOn: Int
+): List<Article> {
+    val response = NetworkResponse.articleResponse(totalPostsToDoRunQueryOn)
     return JsonRemoteData.fetchArticleJsonData(response)
 }
 
-fun getArticleDetails(articleId: Int): ArticleDetail {
+fun getArticleDetails(
+    articleId: Int
+): ArticleDetail {
     val response = NetworkResponse.articleDetailResponse(articleId)
     return JsonRemoteData.fetchArticleJsonDataById(response)
 }
 
-fun getSearchableArticles(): List<Search> {
-    val response = NetworkResponse.searchResponse()
+fun getSearchableArticles(
+    totalPostsToDoRunQueryOn: Int
+): List<Search> {
+    val response = NetworkResponse.searchResponse(totalPostsToDoRunQueryOn)
     return JsonRemoteData.fetchSearchableArticlesJsonData(response)
 }
 
-fun getArticlesByCategory(
-    categoryId: Int
+fun getArticlesByCategoryId(
+    categoryId: Int,
+    postsPage: Int
 ): List<Article> {
-    val response = NetworkResponse.articleResponseByCategoryId(categoryId)
+    val response = NetworkResponse.articleResponseByCategoryId(categoryId, postsPage)
     return JsonRemoteData.fetchArticleJsonData(response)
 }
 
@@ -44,54 +50,53 @@ fun getAuthorById(
     return JsonRemoteData.fetchAuthorDataById(response)
 }
 
-// TODO verify Exception essentials
-object NetworkResponse {
+internal object NetworkResponse {
 
-    @Throws(IOException::class)
-    fun articleResponse(): String {
-        val uriString: String = QueryBuilder.articleBuilder(8)
+    fun articleResponse(
+        totalPostsToDoRunQueryOn: Int
+    ): String {
+        val uriString: String = QueryBuilder.articleBuilder(totalPostsToDoRunQueryOn)
         val requestUrl: URL = createUrl(uriString)
         return getResponseFromHttpUrl(requestUrl)
     }
 
-    @Throws(IOException::class)
-    fun articleDetailResponse(articleId: Int): String {
+    fun articleDetailResponse(
+        articleId: Int
+    ): String {
         val uriString: String = QueryBuilder.articleByIdBuilder(articleId)
         val requestUrl: URL = createUrl(uriString)
         return getResponseFromHttpUrl(requestUrl)
     }
 
-    @Throws(IOException::class)
-    fun searchResponse(): String {
-        val uriString: String = QueryBuilder.articleBuilder(28)
+    fun searchResponse(
+        totalPostsToDoRunQueryOn: Int
+    ): String {
+        val uriString: String = QueryBuilder.articleBuilder(totalPostsToDoRunQueryOn)
         val requestUrl: URL = createUrl(uriString)
         return getResponseFromHttpUrl(requestUrl)
     }
 
-    @Throws(IOException::class)
     fun articleResponseByCategoryId(
-        categoryId: Int
+        categoryId: Int,
+        postsPage: Int
     ): String {
-        val uriString: String = QueryBuilder.articlesByCategoryBuilder(categoryId)
+        val uriString: String = QueryBuilder.articlesByCategoryBuilder(categoryId, postsPage)
         val requestUrl: URL = createUrl(uriString)
         return getResponseFromHttpUrl(requestUrl)
     }
 
-    @Throws(IOException::class)
     fun categoryResponse(): String {
         val uriString: String = QueryBuilder.categoryBuilder()
         val requestUrl: URL = createUrl(uriString)
         return getResponseFromHttpUrl(requestUrl)
     }
 
-    @Throws(IOException::class)
     fun authorResponse(): String {
         val uriString: String = QueryBuilder.authorBuilder()
         val requestUrl: URL = createUrl(uriString)
         return getResponseFromHttpUrl(requestUrl)
     }
 
-    @Throws(IOException::class)
     fun authorResponseById(authorId: Int): String {
         val uriString: String = QueryBuilder.authorBuilderById(authorId)
         val requestUrl: URL = createUrl(uriString)

app/src/main/java/com/developerbreach/developerbreach/repository/network/QueryBuilder.kt

@@ -11,79 +11,90 @@ import com.developerbreach.developerbreach.utils.*
  */
 object QueryBuilder {
 
+    private const val NUMBER_OF_POSTS_PER_PAGE = 5.toString()
+
     /**
-     * https://developersbreach.com/wp-json/wp/v2/{posts}
-     * [numberOfPostsPerPage] updates list with new content.
+     * https://developersbreach.com/wp-json/wp/v2/posts?per_page=5
      */
-    fun articleBuilder(numberOfPostsPerPage: Int): String {
-        val baseUri: Uri = Uri.parse(SCHEME_AUTHORITY)
-        val uriBuilder: Uri.Builder = baseUri.buildUpon()
-        uriBuilder.appendPath(APPEND_PATH)
-        uriBuilder.appendPath(APPEND_ENDPOINT_POSTS)
-        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POSTS_PER_PAGE, "$numberOfPostsPerPage")
+    fun articleBuilder(
+        numberOfPosts: Int
+    ): String {
+        val uriBuilder: Uri.Builder = baseUriBuilder()
+        uriBuilder.appendPath(APPEND_PATH_POSTS)
+        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POSTS_PER_PAGE, numberOfPosts.toString())
         return uriBuilder.build().toString()
     }
 
     /**
      * https://developersbreach.com/wp-json/wp/v2/posts?include={10920}
      * [articleId] updates list with new content.
      */
-    fun articleByIdBuilder(articleId: Int): String {
-        val baseUri: Uri = Uri.parse(SCHEME_AUTHORITY)
-        val uriBuilder: Uri.Builder = baseUri.buildUpon()
-        uriBuilder.appendPath(APPEND_PATH)
-        uriBuilder.appendPath(APPEND_ENDPOINT_POSTS)
-        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POST_INCLUDE_ID, "$articleId")
+    fun articleByIdBuilder(
+        articleId: Int
+    ): String {
+        val uriBuilder: Uri.Builder = baseUriBuilder()
+        uriBuilder.appendPath(APPEND_PATH_POSTS)
+        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POST_INCLUDE_ID, articleId.toString())
         return uriBuilder.build().toString()
     }
 
     /**
      * https://developersbreach.com/wp-json/wp/v2/{posts}
      * [categoryId] updates articles list with based on selected category Id.
+     *
      * https://developersbreach.com/wp-json/wp/v2/posts?categories=2713721
+     * https://developersbreach.com/wp-json/wp/v2/posts?per_page=2&page=1&categories=2713553&orderby=date
      */
     fun articlesByCategoryBuilder(
-        categoryId: Int
+        categoryId: Int,
+        postsPage: Int
     ): String {
-        val baseUri: Uri = Uri.parse(SCHEME_AUTHORITY)
-        val uriBuilder: Uri.Builder = baseUri.buildUpon()
-        uriBuilder.appendPath(APPEND_PATH)
-        uriBuilder.appendPath(APPEND_ENDPOINT_POSTS)
-        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POSTS_BY_CATEGORY, "$categoryId")
+        val uriBuilder: Uri.Builder = baseUriBuilder()
+        uriBuilder.appendPath(APPEND_PATH_POSTS)
+        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POSTS_PER_PAGE, NUMBER_OF_POSTS_PER_PAGE)
+        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POSTS_PAGE, postsPage.toString())
+        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POSTS_BY_CATEGORY, categoryId.toString())
+        uriBuilder.appendQueryParameter(QUERY_PARAMETER_POSTS_ORDER, ORDER_BY_DATE)
         return uriBuilder.build().toString()
     }
 
     /**
      * https://developersbreach.com/wp-json/wp/v2/{categories}
      */
     fun categoryBuilder(): String {
-        val baseUri: Uri = Uri.parse(SCHEME_AUTHORITY)
-        val uriBuilder: Uri.Builder = baseUri.buildUpon()
-        uriBuilder.appendPath(APPEND_PATH)
-        uriBuilder.appendPath("categories")
+        val uriBuilder: Uri.Builder = baseUriBuilder()
+        uriBuilder.appendPath(APPEND_PATH_CATEGORIES)
         return uriBuilder.build().toString()
     }
 
     /**
      * https://developersbreach.com/wp-json/wp/v2/{users}
      */
     fun authorBuilder(): String {
-        val baseUri: Uri = Uri.parse(SCHEME_AUTHORITY)
-        val uriBuilder: Uri.Builder = baseUri.buildUpon()
-        uriBuilder.appendPath(APPEND_PATH)
-        uriBuilder.appendPath("users")
+        val uriBuilder: Uri.Builder = baseUriBuilder()
+        uriBuilder.appendPath(APPEND_PATH_USERS)
         return uriBuilder.build().toString()
     }
 
     /**
      * https://developersbreach.com/wp-json/wp/v2/users/{107376512}
      */
-    fun authorBuilderById(authorId: Int): String {
+    fun authorBuilderById(
+        authorId: Int
+    ): String {
+        val uriBuilder: Uri.Builder = baseUriBuilder()
+        uriBuilder.appendPath(APPEND_PATH_USERS)
+        uriBuilder.appendPath(authorId.toString())
+        return uriBuilder.build().toString()
+    }
+
+    /**
+     * https://developersbreach.com/wp-json/wp/v2
+     */
+    private fun baseUriBuilder(): Uri.Builder {
         val baseUri: Uri = Uri.parse(SCHEME_AUTHORITY)
         val uriBuilder: Uri.Builder = baseUri.buildUpon()
         uriBuilder.appendPath(APPEND_PATH)
-        uriBuilder.appendPath(APPEND_USERS_PATH)
-        uriBuilder.appendPath(authorId.toString())
-        return uriBuilder.build().toString()
+        return uriBuilder
     }
 }

app/src/main/java/com/developerbreach/developerbreach/utils/Constants.kt

@@ -45,16 +45,14 @@ object Preferences {
 
 const val SCHEME_AUTHORITY = "https://developersbreach.com"
 const val APPEND_PATH = "wp-json/wp/v2"
-const val APPEND_USERS_PATH = "users"
 
-// ?per_page=21
-const val APPEND_ENDPOINT_POSTS = "posts"
+const val APPEND_PATH_USERS = "users"
+const val APPEND_PATH_CATEGORIES = "categories"
+const val APPEND_PATH_POSTS = "posts"
+
 const val QUERY_PARAMETER_POSTS_PER_PAGE = "per_page"
+const val QUERY_PARAMETER_POSTS_PAGE = "page"
 const val QUERY_PARAMETER_POSTS_BY_CATEGORY = "categories"
 const val QUERY_PARAMETER_POST_INCLUDE_ID = "include"
-
-// Get multiple articles by id's
-// const val ARTICLES_ID = "https://developersbreach.com/wp-json/wp/v2/posts?include=8432,7787"
-
-// Get categories list
-// const val CATEGORIES = "https://developersbreach.com/wp-json/wp/v2/categories"
+const val QUERY_PARAMETER_POSTS_ORDER = "orderby"
+const val ORDER_BY_DATE = "date"