Package com.spaghetticodegang.trylater.contact

Klasse ContactService

java.lang.Object

com.spaghetticodegang.trylater.contact.ContactService

@Service
public class ContactService
extends Object

Service layer for handling business logic related to user contacts.

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
ContactService()

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
ContactResponseDto	createContact(User me, ContactRequestDto request)	Creates a new contact request between the authenticated user and the target user.
ContactResponseDto	createContactResponseDto(User me, Contact contact)	Creates a response DTO from a Contact entity.
void	deleteContact(User me, Long contactId)	Deletes a Contact entity.
boolean	existsByUserIds(Long userId1, Long userId2)	Checks whether a contact relationship exists between two users, regardless of which user was the requester or receiver.
Contact	findContactById(Long contactId)	Finds a contact by their unique ID.
List<ContactResponseDto>	getAllContactsByStatusAndRole(User me, ContactStatus contactStatus, ContactRole contactRole)	Searches the contact repository for all contact of the user.
ContactResponseDto	getContact(User me, Long contactId)	Searches the contact repository for a given id.
ContactResponseDto	updateContactStatus(User me, Long contactId, ContactStatusRequestDto contactStatusRequestDto)	Performs validation and updates the contact's status, including setting the acceptance date if applicable.

Von Klasse geerbte Methoden java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Konstruktordetails

ContactService

public ContactService()

Methodendetails

existsByUserIds

public boolean existsByUserIds(Long userId1,
 Long userId2)

Checks whether a contact relationship exists between two users, regardless of which user was the requester or receiver.

Parameter:

userId1 - the ID of the first user

userId2 - the ID of the second user

Gibt zurück:

true if a contact already exists between the two users, false otherwise

findContactById

public Contact findContactById(Long contactId)

Finds a contact by their unique ID.

Parameter:

contactId - the ID of the contact

Gibt zurück:

the contact entity

Löst aus:

ContactNotFoundException - if the contact is not found

createContactResponseDto

public ContactResponseDto createContactResponseDto(User me,
 Contact contact)

Creates a response DTO from a Contact entity. Determines which user is the contact partner (not the authenticated user).

Parameter:

me - the authenticated user

contact - the contact entity

Gibt zurück:

a response DTO representing the contact

getContact

public ContactResponseDto getContact(User me,
 Long contactId)

Searches the contact repository for a given id.

Parameter:

me - the authenticated user

contactId - the contact id

Gibt zurück:

a response DTO representing the contact

Löst aus:

ValidationException - if the user is neither the requester nor receiver of the contact

getAllContactsByStatusAndRole

public List<ContactResponseDto> getAllContactsByStatusAndRole(User me,
 ContactStatus contactStatus,
 ContactRole contactRole)

Searches the contact repository for all contact of the user.

Parameter:

me - the authenticated user

Gibt zurück:

a list of response DTO representing the contacts optional filters

createContact

public ContactResponseDto createContact(User me,
 ContactRequestDto request)

Creates a new contact request between the authenticated user and the target user. Performs validation to prevent duplicate or self-referential contacts.

Parameter:

me - the authenticated user initiating the request

request - the contact request containing the target user's ID

Gibt zurück:

a response DTO representing the newly created contact

Löst aus:

ValidationException - if the target is the same as the requester or if a contact already exists between the users

updateContactStatus

public ContactResponseDto updateContactStatus(User me,
 Long contactId,
 ContactStatusRequestDto contactStatusRequestDto)

Performs validation and updates the contact's status, including setting the acceptance date if applicable.

Parameter:

me - the currently authenticated user

contactId - the ID of the contact whose status is to be updated

contactStatusRequestDto - the DTO containing the new contact status

Gibt zurück:

a response DTO representing the updated contact

Löst aus:

ValidationException - if the status change is invalid

deleteContact

public void deleteContact(User me,
 Long contactId)

Deletes a Contact entity. Determines which user is the contact partner (not the authenticated user).

Parameter:

me - the authenticated user

contactId - the contact id