#178: start of api client

Author: Death111

pom.xml

@@ -162,6 +162,14 @@
       <artifactId>hamcrest-library</artifactId>
       <scope>test</scope>
     </dependency>
+
+    <!-- for HeimatTime LocalDate (de)serializiation -->
+    <dependency>
+      <groupId>com.fasterxml.jackson.datatype</groupId>
+      <artifactId>jackson-datatype-jsr310</artifactId>
+      <version>2.18.2</version>
+    </dependency>
+
   </dependencies>
   <build>
     <finalName>keeptime-${project.version}</finalName>

src/main/java/de/doubleslash/keeptime/rest/integration/heimat/HeimatAPI.java

@@ -0,0 +1,82 @@
+package de.doubleslash.keeptime.rest.integration.heimat;
+
+import de.doubleslash.keeptime.rest.integration.heimat.model.HeimatTask;
+import de.doubleslash.keeptime.rest.integration.heimat.model.HeimatTime;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.client.RestClient;
+import org.springframework.web.util.UriBuilder;
+
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+
+public class HeimatAPI {
+
+   private final RestClient restClient;
+
+   public HeimatAPI(final String baseUrl, final String bearerToken) {
+      restClient = RestClient.builder()
+                             .baseUrl(baseUrl)
+                             .defaultHeader("X-Client-Identifier", "KeepTime")
+                             .defaultHeader("Authorization", "Bearer " + bearerToken)
+                             .build();
+   }
+
+   public boolean isLoginValid() {
+      getMyTasks();
+      return true;
+   }
+
+   public List<HeimatTask> getMyTasks() {
+      return getMyTasks(null);
+   }
+
+   // GET /my/tasks
+   public List<HeimatTask> getMyTasks(final LocalDate forDate) {
+      return restClient.get().uri(uriBuilder -> {
+         UriBuilder builder = uriBuilder.path("/my/tasks");
+         if (forDate != null) {
+            builder.queryParam("date", forDate.format(DateTimeFormatter.ISO_DATE));
+         }
+         return builder.build();
+      }).retrieve().onStatus(HttpStatus.UNAUTHORIZED::equals, (request, response) -> {
+         throw new UnauthorizedException();
+      }).body(new ParameterizedTypeReference<>() {});
+   }
+
+   public List<HeimatTime> getMyTimes() {
+      return getMyTimes(null);
+   }
+
+   // GET /my/times
+   public List<HeimatTime> getMyTimes(final LocalDate forDate) {
+      return restClient.get().uri(uriBuilder -> {
+         UriBuilder builder = uriBuilder.path("/my/times");
+         if (forDate != null) {
+            builder.queryParam("date", forDate.format(DateTimeFormatter.ISO_DATE));
+         }
+         return builder.build();
+      }).retrieve().onStatus(HttpStatus.UNAUTHORIZED::equals, (request, response) -> {
+         throw new UnauthorizedException();
+      }).body(new ParameterizedTypeReference<>() {});
+   }
+
+   // POST /my/times
+   public void addMyTime(final HeimatTime heimatTime) {
+      restClient.post()
+                .uri(uriBuilder -> {
+                   UriBuilder builder = uriBuilder.path("/my/times");
+                   return builder.build();
+                })
+                .header("Content-Type", "application/json")
+                .body(heimatTime)
+                .retrieve()
+                .onStatus(HttpStatus.UNAUTHORIZED::equals, (request, response) -> {
+                   throw new UnauthorizedException();
+                });
+   }
+
+   // DELETE /my/times/{id}
+
+}

src/main/java/de/doubleslash/keeptime/rest/integration/heimat/JwtDecoder.java

@@ -0,0 +1,47 @@
+package de.doubleslash.keeptime.rest.integration.heimat;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.Base64;
+import java.util.Map;
+
+public class JwtDecoder {
+
+   public record JWTTokenAttributes(
+         String header,
+         String payload,
+         LocalDateTime expiration
+   ) {}
+
+
+   public static JWTTokenAttributes parse(String bearerToken) {
+      String token = removeBearerPrefix(bearerToken);
+
+      String[] parts = token.split("\\.");
+      if (parts.length != 3) {
+         throw new IllegalArgumentException("Invalid JWT token format");
+      }
+
+      String header = new String(Base64.getUrlDecoder().decode(parts[0]));
+      String payload = new String(Base64.getUrlDecoder().decode(parts[1]));
+
+      ObjectMapper mapper = new ObjectMapper();
+      Map<String, Object> claims = null;
+      try {
+         claims = mapper.readValue(payload, Map.class);
+      } catch (JsonProcessingException e) {
+         throw new RuntimeException(e);
+      }
+
+      final LocalDateTime expiration = LocalDateTime.parse((String) claims.get("expiration"), DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
+
+      return new JWTTokenAttributes(header, payload, expiration);
+   }
+
+   private static String removeBearerPrefix(String token) {
+      return token.startsWith("Bearer ") ? token.substring(7) : token;
+   }
+}

src/main/java/de/doubleslash/keeptime/rest/integration/heimat/UnauthorizedException.java

@@ -0,0 +1,3 @@
+package de.doubleslash.keeptime.rest.integration.heimat;
+
+public class UnauthorizedException extends RuntimeException {}

src/main/java/de/doubleslash/keeptime/rest/integration/heimat/model/HeimatTask.java

@@ -0,0 +1,11 @@
+package de.doubleslash.keeptime.rest.integration.heimat.model;
+
+public record HeimatTask(
+      long id, // int64
+      String name,
+      String projectName,
+      boolean isFavorite,
+      String bookingHint,
+      boolean isStartAndEndTimeRequired,
+      boolean isNoteOptional
+) {}

src/main/java/de/doubleslash/keeptime/rest/integration/heimat/model/HeimatTime.java

@@ -0,0 +1,17 @@
+package de.doubleslash.keeptime.rest.integration.heimat.model;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+public record HeimatTime(
+      long taskId, // int64
+      @JsonFormat(pattern = "yyyy-MM-dd")
+      LocalDate date, // 2024-01-01
+      LocalTime start, // 23:59
+      LocalTime end, // 23:59
+      int durationInMinutes, // int32
+      String note,
+      long id // int64
+) {}