Package com.endurancetrio.business.event.service

Interface EventService

All Known Implementing Classes:
EventServiceMain
public interface EventService
The EventService defines the business operations for managing event data.

  • Method Summary

    Modifier and Type
    Method
    Description
    EventOverviewDTO
    getEventOverview(Long id, int year)
    Returns an EventOverviewDTO containing the summary details of the event identified by the given id and belonging to the given year, including its organizers and races.
    EventsPageDTO
    getEventsByYear(int year, org.springframework.data.domain.Pageable pageable)
    Returns an EventsPageDTO containing the events whose start date falls within the given year, ordered by start date descending and paginated according to the given Pageable.
    List<Integer>
    getEventYears()
    Returns a list of all distinct years extracted from the events' start dates, ordered descending.
    EventsPageDTO
    getMostRecentAddedEvents(org.springframework.data.domain.Pageable pageable)
    Returns an EventsPageDTO containing the most recently added events, ordered by their creation timestamp descending.

  • Method Details

    • getEventYears

      List<Integer> getEventYears()
      Returns a list of all distinct years extracted from the events' start dates, ordered descending. This is used by YearsWithEventsDTO to drive the year-browser pagination on the events landing page.
      Returns:
      a list of distinct event years in descending order

    • getEventsByYear

      EventsPageDTO getEventsByYear(int year, org.springframework.data.domain.Pageable pageable)
      Returns an EventsPageDTO containing the events whose start date falls within the given year, ordered by start date descending and paginated according to the given Pageable.
      Parameters:
      year - the year to filter events by
      pageable - the pagination information (page number, page size, etc.)
      Returns:
      an EventsPageDTO with the events for the given year and pagination metadata

    • getEventOverview

      EventOverviewDTO getEventOverview(Long id, int year)
      Returns an EventOverviewDTO containing the summary details of the event identified by the given id and belonging to the given year, including its organizers and races.
      Parameters:
      id - the unique identifier of the event
      year - the year the event belongs to
      Returns:
      an EventOverviewDTO with the event overview
      Throws:
      EnduranceTrioException - if no event with the given id and year is found

    • getMostRecentAddedEvents

      EventsPageDTO getMostRecentAddedEvents(org.springframework.data.domain.Pageable pageable)
      Returns an EventsPageDTO containing the most recently added events, ordered by their creation timestamp descending. Courses are eagerly fetched to derive sport codes without additional queries.
      Parameters:
      pageable - the pagination information; use PageRequest.of(0, limit) to retrieve the most recent N events
      Returns:
      an EventsPageDTO with the most recently added events and pagination metadata