HelpRequestController.java

package edu.ucsb.cs156.example.controllers;

import com.fasterxml.jackson.core.JsonProcessingException;

import edu.ucsb.cs156.example.entities.HelpRequest;

import edu.ucsb.cs156.example.repositories.HelpRequestRepository;

import io.swagger.v3.oas.annotations.Operation;

import io.swagger.v3.oas.annotations.Parameter;

import io.swagger.v3.oas.annotations.tags.Tag;

import java.time.LocalDateTime;

import lombok.extern.slf4j.Slf4j;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.format.annotation.DateTimeFormat;

import org.springframework.security.access.prepost.PreAuthorize;

import org.springframework.web.bind.annotation.GetMapping;

import org.springframework.web.bind.annotation.PostMapping;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RequestParam;

import org.springframework.web.bind.annotation.RestController;

/** This is a REST controller for HelpRequest */

@Tag(name = "HelpRequest")

@RequestMapping("/api/helprequest")

@RestController

  @Autowired HelpRequestRepository helpRequestRepository;

  /**

   * List all Help Requests

   *

   * @return an iterable of HelpRequest

   */

  @Operation(summary = "List all help requests")

  @PreAuthorize("hasRole('ROLE_USER')")

  @GetMapping("/all")

  public Iterable<HelpRequest> allHelpRequests() {

  }

  /**

   * Create a new help request

   *

   * @param requesterEmail the requester's email

   * @param teamId the team id of the requester

   * @param tableOrBreakoutRoom table or breakout room of the requester

   * @param requestTime the request time of the help request

   * @param explanation an example explanation of the help request

   * @param solved whether the help request has been solved or not

   * @return the saved HelpRequest

   */

  @Operation(summary = "Create a new help request")

  @PreAuthorize("hasRole('ROLE_ADMIN')")

  @PostMapping("/post")

  public HelpRequest postHelpRequest(

      @Parameter(name = "requesterEmail") @RequestParam String requesterEmail,

      @Parameter(name = "teamId") @RequestParam String teamId,

      @Parameter(name = "tableOrBreakoutRoom") @RequestParam String tableOrBreakoutRoom,

      @Parameter(name = "explanation") @RequestParam String explanation,

      @Parameter(name = "solved") @RequestParam Boolean solved,

      @Parameter(

              name = "requestTime",

              description =

                  "date (in iso format, e.g. YYYY-mm-ddTHH:MM:SS; see https://en.wikipedia.org/wiki/ISO_8601)")

          @RequestParam("requestTime")

          @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)

          LocalDateTime requestTime)

      throws JsonProcessingException {

    // For an explanation of @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)

    // See: https://www.baeldung.com/spring-date-parameters

  }

}

Mutations