Task/add location object

src/main/java/com/onboarding/camera/cameraonboarding/controller/CameraRestController.java

@@ -1,9 +1,13 @@
 package com.onboarding.camera.cameraonboarding.controller;
 
 import com.onboarding.camera.cameraonboarding.converter.CameraDtoConverter;
+import com.onboarding.camera.cameraonboarding.converter.LocationDtoConverter;
 import com.onboarding.camera.cameraonboarding.dto.CameraDto;
 import com.onboarding.camera.cameraonboarding.dto.CameraResponse;
+import com.onboarding.camera.cameraonboarding.dto.LocationDto;
+import com.onboarding.camera.cameraonboarding.dto.LocationResponse;
 import com.onboarding.camera.cameraonboarding.entity.Camera;
+import com.onboarding.camera.cameraonboarding.entity.Location;
 import com.onboarding.camera.cameraonboarding.service.CameraService;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
@@ -32,6 +36,8 @@ public class CameraRestController {
 
     private final CameraDtoConverter cameraDtoConverter;
 
+    private final LocationDtoConverter locationDtoConverter;
+
     @PostMapping("/onboard")
     public ResponseEntity<CameraResponse> saveCamera(@Valid @RequestBody CameraDto cameraDto) {
 
@@ -79,4 +85,16 @@ public ResponseEntity<byte[]> downloadImage(@PathVariable UUID cameraId) {
                 .header(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=" + camera.getImageId() + ".png")
                 .body(imageData);
     }
+
+    @PostMapping("/camera/{cameraId}/location")
+    public ResponseEntity<LocationResponse> addLocation(
+            @PathVariable UUID cameraId,
+            @Valid @RequestBody LocationDto locationDto) {
+
+        Camera updatedCamera = cameraService.handleAddLocation(cameraId, locationDto);
+        Location cameraLocation = updatedCamera.getLocation();
+        LocationResponse response = locationDtoConverter.toLocationResponse(cameraLocation);
+
+        return new ResponseEntity<>(response, HttpStatus.CREATED);
+    }
 }

src/main/java/com/onboarding/camera/cameraonboarding/controller/GlobalExceptionHandler.java

@@ -9,6 +9,7 @@
 import com.onboarding.camera.cameraonboarding.exception.ImageNotDownloadedException;
 import com.onboarding.camera.cameraonboarding.exception.ImageNotFoundException;
 import com.onboarding.camera.cameraonboarding.exception.ImageNotUploadedException;
+import com.onboarding.camera.cameraonboarding.exception.LocationNotAddedException;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.MethodArgumentNotValidException;
@@ -153,5 +154,17 @@ public ResponseEntity<ErrorResponse> handleImageNotDownloadedException(ImageNotD
 
         return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
     }
+
+    @ExceptionHandler(LocationNotAddedException.class)
+    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
+    @ResponseBody
+    public ResponseEntity<ErrorResponse> handleLocationNotAddedException(LocationNotAddedException ex) {
+        ErrorResponse errorResponse = new ErrorResponse();
+
+        errorResponse.setStatusCode(HttpStatus.INTERNAL_SERVER_ERROR.value());
+        errorResponse.setMessage(ex.getMessage());
+
+        return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
+    }
 }
 

src/main/java/com/onboarding/camera/cameraonboarding/converter/LocationDtoConverter.java

@@ -0,0 +1,17 @@
+package com.onboarding.camera.cameraonboarding.converter;
+
+import com.onboarding.camera.cameraonboarding.dto.LocationResponse;
+import com.onboarding.camera.cameraonboarding.entity.Location;
+import org.springframework.stereotype.Component;
+
+@Component
+public class LocationDtoConverter {
+
+    public LocationResponse toLocationResponse(Location location) {
+        LocationResponse response = new LocationResponse();
+        response.setLatitude(location.getLatitude());
+        response.setLongitude(location.getLongitude());
+        response.setAddress(location.getAddress());
+        return response;
+    }
+}

src/main/java/com/onboarding/camera/cameraonboarding/dto/LocationDto.java

@@ -0,0 +1,30 @@
+package com.onboarding.camera.cameraonboarding.dto;
+
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class LocationDto {
+
+    @NotNull(message = "Latitude cannot be null")
+    @DecimalMin(value = "-90.0", message = "Latitude must be >= -90")
+    @DecimalMax(value = "90.0", message = "Latitude must be <= 90")
+    private double latitude;
+
+    @NotNull(message = "Longitude cannot be null")
+    @DecimalMin(value = "-180.0", message = "Longitude must be >= -180")
+    @DecimalMax(value = "180.0", message = "Longitude must be <= 180")
+    private double longitude;
+
+    @NotBlank(message = "Address cannot be blank")
+    @Size(min = 10, max = 100, message = "Address should be up to 100 characters")
+    private String address;
+}

src/main/java/com/onboarding/camera/cameraonboarding/dto/LocationResponse.java

@@ -0,0 +1,10 @@
+package com.onboarding.camera.cameraonboarding.dto;
+
+import lombok.Data;
+
+@Data
+public class LocationResponse {
+    private double latitude;
+    private double longitude;
+    private String address;
+}

src/main/java/com/onboarding/camera/cameraonboarding/entity/Camera.java

@@ -1,9 +1,12 @@
 package com.onboarding.camera.cameraonboarding.entity;
 
+import com.fasterxml.jackson.annotation.JsonManagedReference;
+import jakarta.persistence.CascadeType;
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
 import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.Id;
+import jakarta.persistence.OneToOne;
 import jakarta.persistence.Table;
 import lombok.Data;
 import lombok.ToString;
@@ -13,7 +16,7 @@
 import java.util.UUID;
 
 @Data
-@ToString
+@ToString(exclude = "location")
 @Entity
 @Table(name = "camera_metadata")
 public class Camera {
@@ -47,4 +50,8 @@ public class Camera {
 
     @Column(name = "initialized_at")
     private LocalDateTime initializedAt;
+
+    @OneToOne(mappedBy = "camera", cascade = CascadeType.ALL, orphanRemoval = true)
+    @JsonManagedReference
+    private Location location;
 }

src/main/java/com/onboarding/camera/cameraonboarding/entity/Location.java

@@ -0,0 +1,42 @@
+package com.onboarding.camera.cameraonboarding.entity;
+
+import com.fasterxml.jackson.annotation.JsonBackReference;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.OneToOne;
+import jakarta.persistence.Table;
+import lombok.Data;
+import lombok.ToString;
+import org.hibernate.annotations.UuidGenerator;
+
+import java.util.UUID;
+
+@Data
+@ToString(exclude = "camera")
+@Entity
+@Table(name = "location")
+public class Location {
+
+    @Id
+    @GeneratedValue
+    @UuidGenerator
+    @Column(name = "location_id")
+    private UUID locationId;
+
+    @Column(name = "latitude", nullable = false)
+    private Double latitude;
+
+    @Column(name = "longitude", nullable = false)
+    private Double longitude;
+
+    @Column(name = "address", nullable = false)
+    private String address;
+
+    @OneToOne
+    @JoinColumn(name = "camera_id", referencedColumnName = "cam_id")
+    @JsonBackReference
+    private Camera camera;
+}

src/main/java/com/onboarding/camera/cameraonboarding/exception/LocationNotAddedException.java

@@ -0,0 +1,7 @@
+package com.onboarding.camera.cameraonboarding.exception;
+
+public class LocationNotAddedException extends RuntimeException {
+    public LocationNotAddedException(String message) {
+        super(message);
+    }
+}

src/main/java/com/onboarding/camera/cameraonboarding/service/CameraService.java

@@ -1,5 +1,6 @@
 package com.onboarding.camera.cameraonboarding.service;
 
+import com.onboarding.camera.cameraonboarding.dto.LocationDto;
 import com.onboarding.camera.cameraonboarding.entity.Camera;
 import com.onboarding.camera.cameraonboarding.exception.CameraAlreadyInitializedException;
 import com.onboarding.camera.cameraonboarding.exception.CameraNotCreatedException;
@@ -8,6 +9,7 @@
 import com.onboarding.camera.cameraonboarding.exception.ImageNotDownloadedException;
 import com.onboarding.camera.cameraonboarding.exception.ImageNotFoundException;
 import com.onboarding.camera.cameraonboarding.exception.ImageNotUploadedException;
+import com.onboarding.camera.cameraonboarding.exception.LocationNotAddedException;
 
 import java.util.UUID;
 
@@ -70,4 +72,16 @@ public interface CameraService {
      */
 
     byte[] handleDownloadImage(UUID cameraId);
+
+    /**
+     * this method is used for add location information to camera
+     *
+     * @param cameraId    camera id
+     * @param locationDto camera location
+     * @return updated camera
+     * @throws CameraNotFoundException   if camera is not found with id
+     * @throws LocationNotAddedException if unexpected error occurs while adding location
+     */
+
+    Camera handleAddLocation(UUID cameraId, LocationDto locationDto);
 }

src/main/java/com/onboarding/camera/cameraonboarding/service/impl/CameraServiceImpl.java

@@ -1,6 +1,8 @@
 package com.onboarding.camera.cameraonboarding.service.impl;
 
+import com.onboarding.camera.cameraonboarding.dto.LocationDto;
 import com.onboarding.camera.cameraonboarding.entity.Camera;
+import com.onboarding.camera.cameraonboarding.entity.Location;
 import com.onboarding.camera.cameraonboarding.exception.CameraAlreadyInitializedException;
 import com.onboarding.camera.cameraonboarding.exception.CameraNotCreatedException;
 import com.onboarding.camera.cameraonboarding.exception.CameraNotFoundException;
@@ -9,15 +11,18 @@
 import com.onboarding.camera.cameraonboarding.exception.ImageNotDownloadedException;
 import com.onboarding.camera.cameraonboarding.exception.ImageNotFoundException;
 import com.onboarding.camera.cameraonboarding.exception.ImageNotUploadedException;
+import com.onboarding.camera.cameraonboarding.exception.LocationNotAddedException;
 import com.onboarding.camera.cameraonboarding.repository.CameraRepository;
 import com.onboarding.camera.cameraonboarding.service.BlobStorageService;
 import com.onboarding.camera.cameraonboarding.service.CameraService;
 import com.onboarding.camera.cameraonboarding.util.DateTimeFactory;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
 
 import java.io.ByteArrayOutputStream;
+import java.util.Optional;
 import java.util.UUID;
 
 @Slf4j
@@ -120,6 +125,29 @@ public byte[] handleDownloadImage(UUID cameraId) {
         }
     }
 
+    @Override
+    @Transactional
+    public Camera handleAddLocation(UUID cameraId, LocationDto locationDto) {
+        Camera camera = getCameraById(cameraId);
+
+        try {
+            Location location = Optional.ofNullable(camera.getLocation()).orElse(new Location());
+            location.setLatitude(locationDto.getLatitude());
+            location.setLongitude(locationDto.getLongitude());
+            location.setAddress(locationDto.getAddress());
+
+            location.setCamera(camera);
+            camera.setLocation(location);
+
+            cameraRepository.save(camera);
+            log.info("Location added/updated successfully for Camera ID: {}", cameraId);
+            return camera;
+        } catch (Exception ex) {
+            log.error("Exception occurred while adding location, camera:{}:ex:{}", cameraId, ex.getMessage());
+            throw new LocationNotAddedException(String.format("Error occurred while adding location: %s", ex.getMessage()));
+        }
+    }
+
     /**
      * Validates if the camera has been onboarded and initialized
      *

src/main/resources/db/changelog/changelog-master.xml

@@ -3,8 +3,9 @@
         xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
-            http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
+            https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
 
     <include file="/db/changelog/changelog-v1.xml"/>
+    <include file="/db/changelog/changelog-v2.xml"/>
 
 </databaseChangeLog>

src/main/resources/db/changelog/changelog-v2.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<databaseChangeLog
+        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
+            https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
+
+    <changeSet id="2" author="selahattin" runOnChange="true">
+        <preConditions onFail="MARK_RAN">
+            <not>
+                <tableExists tableName="location"/>
+            </not>
+        </preConditions>
+        <createTable tableName="location">
+            <column name="location_id" type="UUID">
+                <constraints primaryKey="true" nullable="false"/>
+            </column>
+            <column name="latitude" type="DOUBLE">
+                <constraints nullable="false"/>
+            </column>
+            <column name="longitude" type="DOUBLE">
+                <constraints nullable="false"/>
+            </column>
+            <column name="address" type="VARCHAR(255)">
+                <constraints nullable="false"/>
+            </column>
+            <column name="camera_id" type="UUID">
+                <constraints nullable="false"/>
+            </column>
+        </createTable>
+
+        <addForeignKeyConstraint
+                baseTableName="location"
+                baseColumnNames="camera_id"
+                referencedTableName="camera_metadata"
+                referencedColumnNames="cam_id"
+                constraintName="fk_location_camera_id"/>
+
+    </changeSet>
+
+</databaseChangeLog>