WIP on feat/random_user

Author: MayuriXx

README.md

@@ -83,7 +83,7 @@ dummy.api.base-url=https://dummyjson.com/
 
 | Method | Path                     | Description | Status |
 |--------|--------------------------|-------------|--------|
-| `GET` | `/random-users?count=30` | Fetch and save users from external API | ✅ |
+| `GET` | `/random-users?page=1&size=10&source=DUMMY` | Fetch and save users from selected external API source | ✅ |
 | `GET` | `/random-users/{id}`     | Get user by ID | ✅ |
 | `POST` | `/random-users`          | Create a new user | ✅ |
 | `PUT` | `/random-users/{id}`     | Update user | ✅ |
@@ -93,7 +93,10 @@ dummy.api.base-url=https://dummyjson.com/
 
 ```bash
 # Fetch 10 users from external API and store them
-curl -X GET "http://localhost:8080/random-users?count=10"
+curl -X GET "http://localhost:8080/random-users?page=1&size=10&source=DUMMY"
+
+# Fetch 10 users from randomuser.me and store them
+curl -X GET "http://localhost:8080/random-users?page=1&size=10&source=RANDOM_USER"
 
 # Get user by ID
 curl -X GET "http://localhost:8080/random-users/1"
@@ -185,6 +188,8 @@ curl -X PUT "http://localhost:8080/random-users/1" \
 
 - `DummyUserApi`: Retrofit client contract for DummyJSON endpoints.
 - `DummyUserServiceImpl`: adapter that calls `DummyUserApi`, maps DTOs, and returns `PaginatedUsers`.
+- `RandomUserApi`: Retrofit client contract for randomuser.me endpoints.
+- `RandomUserServiceImpl`: adapter that calls `RandomUserApi`, maps DTOs, and returns `PaginatedUsers`.
 
 ### Project Structure
 

src/main/java/com/xpeho/spring_boot_java_random_user/data/converters/UserConverter.java

@@ -1,6 +1,7 @@
 package com.xpeho.spring_boot_java_random_user.data.converters;
 
 import com.xpeho.spring_boot_java_random_user.data.models.api.dummy.DummyUserResultDTO;
+import com.xpeho.spring_boot_java_random_user.data.models.api.randomuser.RandomUserResultDTO;
 import com.xpeho.spring_boot_java_random_user.data.models.db.User;
 import com.xpeho.spring_boot_java_random_user.domain.entities.UserEntity;
 import org.springframework.stereotype.Service;
@@ -52,4 +53,24 @@ public UserEntity fromApiModel(DummyUserResultDTO model) {
                 null
         );
     }
+
+    // RandomUser API DTO -> Domain
+    public UserEntity fromRandomUserApiModel(RandomUserResultDTO model) {
+        String title = model.getName() != null ? model.getName().getTitle() : null;
+        String first = model.getName() != null ? model.getName().getFirst() : null;
+        String last = model.getName() != null ? model.getName().getLast() : null;
+        String picture = model.getPicture() != null ? model.getPicture().getMedium() : null;
+
+        return new UserEntity(
+                null,
+                model.getGender(),
+                first,
+                last,
+                title,
+                model.getEmail(),
+                model.getPhone(),
+                picture,
+                model.getNat()
+        );
+    }
 }

src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserNameDTO.java

@@ -0,0 +1,32 @@
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
+
+public class RandomUserNameDTO {
+    private String title;
+    private String first;
+    private String last;
+
+    public String getTitle() {
+        return title;
+    }
+
+    public void setTitle(String title) {
+        this.title = title;
+    }
+
+    public String getFirst() {
+        return first;
+    }
+
+    public void setFirst(String first) {
+        this.first = first;
+    }
+
+    public String getLast() {
+        return last;
+    }
+
+    public void setLast(String last) {
+        this.last = last;
+    }
+}
+

src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserPictureDTO.java

@@ -0,0 +1,14 @@
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
+
+public class RandomUserPictureDTO {
+    private String medium;
+
+    public String getMedium() {
+        return medium;
+    }
+
+    public void setMedium(String medium) {
+        this.medium = medium;
+    }
+}
+

src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserResponseDTO.java

@@ -0,0 +1,16 @@
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
+
+import java.util.List;
+
+public class RandomUserResponseDTO {
+    private List<RandomUserResultDTO> results;
+
+    public List<RandomUserResultDTO> getResults() {
+        return results;
+    }
+
+    public void setResults(List<RandomUserResultDTO> results) {
+        this.results = results;
+    }
+}
+

src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserResultDTO.java

@@ -0,0 +1,59 @@
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
+
+public class RandomUserResultDTO {
+    private String gender;
+    private RandomUserNameDTO name;
+    private String email;
+    private String phone;
+    private RandomUserPictureDTO picture;
+    private String nat;
+
+    public String getGender() {
+        return gender;
+    }
+
+    public void setGender(String gender) {
+        this.gender = gender;
+    }
+
+    public RandomUserNameDTO getName() {
+        return name;
+    }
+
+    public void setName(RandomUserNameDTO name) {
+        this.name = name;
+    }
+
+    public String getEmail() {
+        return email;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+
+    public String getPhone() {
+        return phone;
+    }
+
+    public void setPhone(String phone) {
+        this.phone = phone;
+    }
+
+    public RandomUserPictureDTO getPicture() {
+        return picture;
+    }
+
+    public void setPicture(RandomUserPictureDTO picture) {
+        this.picture = picture;
+    }
+
+    public String getNat() {
+        return nat;
+    }
+
+    public void setNat(String nat) {
+        this.nat = nat;
+    }
+}
+

src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/DummyUserApiConfig.java

@@ -1,6 +1,7 @@
 package com.xpeho.spring_boot_java_random_user.data.sources.api;
 
 import okhttp3.OkHttpClient;
+import org.springframework.beans.factory.annotation.Qualifier;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.core.env.Environment;
@@ -9,7 +10,7 @@
 
 @Configuration
 public class DummyUserApiConfig {
-    @Bean
+    @Bean(name = "dummyUserRetrofit")
     public Retrofit dummyUserRetrofit(Environment env) {
         String baseUrl = env.getRequiredProperty("dummy.api.base-url");
         OkHttpClient client = new OkHttpClient.Builder().build();
@@ -21,7 +22,7 @@ public Retrofit dummyUserRetrofit(Environment env) {
     }
 
     @Bean
-    public DummyUserApi dummyUserApi(Retrofit dummyUserRetrofit) {
+    public DummyUserApi dummyUserApi(@Qualifier("dummyUserRetrofit") Retrofit dummyUserRetrofit) {
         return dummyUserRetrofit.create(DummyUserApi.class);
     }
 }

src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/DummyUserServiceImpl.java

@@ -4,6 +4,7 @@
 import com.xpeho.spring_boot_java_random_user.data.models.api.dummy.DummyUserResponse;
 import com.xpeho.spring_boot_java_random_user.data.models.api.dummy.DummyUserResultDTO;
 import com.xpeho.spring_boot_java_random_user.domain.entities.PaginatedUsers;
+import com.xpeho.spring_boot_java_random_user.domain.entities.UserSource;
 import com.xpeho.spring_boot_java_random_user.domain.entities.UserEntity;
 import com.xpeho.spring_boot_java_random_user.domain.services.RemoteUserService;
 import org.springframework.stereotype.Service;
@@ -22,6 +23,11 @@ public DummyUserServiceImpl(DummyUserApi dummyUserApi, UserConverter userConvert
         this.userConverter = userConverter;
     }
 
+    @Override
+    public UserSource getSource() {
+        return UserSource.DUMMY;
+    }
+
     @Override
     public PaginatedUsers fetchUsers(int page, int size) throws IOException {
         // Convert 1-based page index to 0-based skip offset

src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/RandomUserApi.java

@@ -0,0 +1,12 @@
+package com.xpeho.spring_boot_java_random_user.data.sources.api;
+
+import com.xpeho.spring_boot_java_random_user.data.models.api.randomuser.RandomUserResponseDTO;
+import retrofit2.Call;
+import retrofit2.http.GET;
+import retrofit2.http.Query;
+
+public interface RandomUserApi {
+    @GET(".")
+    Call<RandomUserResponseDTO> getUsers(@Query("results") int results, @Query("page") int page);
+}
+

src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/RandomUserApiConfig.java

@@ -0,0 +1,29 @@
+package com.xpeho.spring_boot_java_random_user.data.sources.api;
+
+import okhttp3.OkHttpClient;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.core.env.Environment;
+import retrofit2.Retrofit;
+import retrofit2.converter.gson.GsonConverterFactory;
+
+@Configuration
+public class RandomUserApiConfig {
+    @Bean(name = "randomUserRetrofit")
+    public Retrofit randomUserRetrofit(Environment env) {
+        String baseUrl = env.getRequiredProperty("randomuser.api.base-url");
+        OkHttpClient client = new OkHttpClient.Builder().build();
+        return new Retrofit.Builder()
+                .baseUrl(baseUrl)
+                .addConverterFactory(GsonConverterFactory.create())
+                .client(client)
+                .build();
+    }
+
+    @Bean
+    public RandomUserApi randomUserApi(@Qualifier("randomUserRetrofit") Retrofit randomUserRetrofit) {
+        return randomUserRetrofit.create(RandomUserApi.class);
+    }
+}
+