Links & Resources

Source Code

Check out the complete source code and documentation on GitHub.

Description

ChâTop is a secure RESTful API built with Spring Boot for a property rental platform, featuring JWT authentication, image handling, and comprehensive property management capabilities.

API architecture diagram showing the relationship between controllers, services, and data repositories in the ChâTop backend.

This project is a robust backend API for a property rental platform, built using modern Java technologies and best practices. The API provides all necessary features for managing rental properties, user accounts, and bookings.

The technical stack includes:

Framework: Spring Boot for rapid API development
Security: JWT-based authentication and authorization
Database: MySQL with Spring Data JPA for persistence
Documentation: OpenAPI/Swagger for interactive API documentation
Testing: JUnit and Mockito for comprehensive test coverage
Image Handling: File upload and storage for property images

Key Features

The ChâTop API supports a complete set of operations for property rental management:

User Management: Registration, authentication, and profile management
Property CRUD Operations: Create, read, update, and delete rental properties
Booking System: Create and manage property reservations
File Management: Upload and retrieve property images
Security: Role-based access control and data protection

The architecture follows a clean, layered approach with separation of concerns:

Controller Layer: RESTful endpoints with input validation
Service Layer: Business logic and transaction management
Repository Layer: Data access and persistence
DTO Pattern: Separate data transfer objects for API responses
Mapper Components: Clean conversion between entities and DTOs

This project demonstrates my proficiency in Java backend development, API design, and implementing security best practices in enterprise applications.

@RestController
@RequestMapping("/api/rentals")
public class RentalController {

    private final RentalService rentalService;
    private final AuthenticationService authService;
    
    @Autowired
    public RentalController(RentalService rentalService, AuthenticationService authService) {
        this.rentalService = rentalService;
        this.authService = authService;
    }
    
    @GetMapping
    public ResponseEntity<List<RentalDTO>> getAllRentals() {
        List<RentalDTO> rentals = rentalService.getAllRentals();
        return ResponseEntity.ok(rentals);
    }
    
    @GetMapping("/{id}")
    public ResponseEntity<RentalDTO> getRentalById(@PathVariable("id") Long id) {
        RentalDTO rental = rentalService.getRentalById(id);
        return ResponseEntity.ok(rental);
    }
    
    @PostMapping
    @PreAuthorize("hasRole('OWNER')")
    public ResponseEntity<RentalDTO> createRental(
            @RequestBody @Valid RentalCreationDTO rentalDTO,
            Authentication authentication) {
        
        UserDetails userDetails = (UserDetails) authentication.getPrincipal();
        Long userId = authService.getUserIdFromUsername(userDetails.getUsername());
        
        RentalDTO createdRental = rentalService.createRental(rentalDTO, userId);
        return ResponseEntity
                .created(URI.create("/api/rentals/" + createdRental.getId()))
                .body(createdRental);
    }
    
    @PutMapping("/{id}")
    @PreAuthorize("hasRole('OWNER')")
    public ResponseEntity<RentalDTO> updateRental(
            @PathVariable("id") Long id,
            @RequestBody @Valid RentalUpdateDTO rentalDTO,
            Authentication authentication) {
        
        UserDetails userDetails = (UserDetails) authentication.getPrincipal();
        Long userId = authService.getUserIdFromUsername(userDetails.getUsername());
        
        RentalDTO updatedRental = rentalService.updateRental(id, rentalDTO, userId);
        return ResponseEntity.ok(updatedRental);
    }
}