Package de.xima.fc.handler.interfaces.entity

Interface IAppointmentHandler

All Superinterfaces:

IAPIHandler, IGenericHandler, Serializable

All Known Implementing Classes:

AppointmentHandler

public interface IAppointmentHandler
extends IGenericHandler

Handler for Appointment entities.

Author:

XIMA MEDIA GmbH

Method Summary

Modifier and Type	Method	Description
void	cancelBookedAppointment(UserContext uc, IAppointmentDeleteBookingParams params)	Cancels the given appointment.
Appointment	createBookedAppointment(UserContext uc, IAppointmentCreateBookingParams params)	Books the given appointment.
List<Appointment>	getAllBy(UserContext uc, IAppointmentQueryParams queryParams)	Returns all appointments that match the given query parameters.
<View extends IEffectiveAppointmentStatusProviding> List<View>	getAttributesBy(UserContext uc, IAppointmentQueryParams params, Class<View> viewClass)	Returns all the attributes of the appointments specified by the IAppointmentQueryParams.
Appointment	getBy(UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm, boolean eager)	Finds the appointment with the QueryCriteriaManager and an is able to load it eagerly.
Appointment	getByUUID(UserContext uc, String uuid)	Finds the appointment with the given UUID.
Appointment	getByUUID(UserContext uc, String uuid, boolean eager)	Finds the appointment with the given UUID and an is able to load it eagerly.
Appointment	getByUUID(UserContext uc, UUID uuid)	Finds the appointment with the given UUID.
Appointment	moveBookedAppointment(UserContext uc, IAppointmentMoveBookingParams params)	Moves an appointment to a different time and date.
List<EAppointmentBookingError>	validateAppointments(UserContext uc, IAppointmentValidateParams params)	Validates whether the given appointments can be created or updated.

Methods inherited from interface de.xima.fc.com.interfaces.IAPIHandler

getName

Methods inherited from interface de.xima.fc.handler.interfaces.entity.IGenericHandler

create, create, delete, delete, deleteBy, deleteById, deleteById, getAll, getAllBy, getAttributes, getAttributes, getBy, getById, getById, getById, getEntityRefs, getSingleAttributes, getSingleAttributes, resultTotalCount, update, update

Method Detail

cancelBookedAppointment

void cancelBookedAppointment(UserContext uc,
                             IAppointmentDeleteBookingParams params)
                      throws AppointmentBookingException

Cancels the given appointment. You should call validateAppointments(UserContext, IAppointmentValidateParams) first if you have not done so yet.

Parameters:

uc - Current user context for accessing the database.

params - Parameters with the appointment to cancel, must be a persisted entity.

Throws:

AppointmentBookingException - When the booking could not be performed. See AppointmentBookingException.getBookingError() for more details.

createBookedAppointment

Appointment createBookedAppointment(UserContext uc,
                                    IAppointmentCreateBookingParams params)
                             throws AppointmentBookingException

Books the given appointment. You should call validateAppointments(UserContext, IAppointmentValidateParams) first if you have not done so yet.

Parameters:

uc - Current user context for accessing the database.

params - Parameters with the appointment to book, must be a new (non-persisted) entity.

Returns:

The persisted appointment.

Throws:

AppointmentBookingException - When the booking could not be performed. See AppointmentBookingException.getBookingError() for more details.

getAllBy

List<Appointment> getAllBy(UserContext uc,
                           IAppointmentQueryParams queryParams)

Returns all appointments that match the given query parameters. You should call validateAppointments(UserContext, IAppointmentValidateParams) first if you have not done so yet.

Parameters:

uc - Current user context for accessing the database.

queryParams - Restrictions to apply the returned appointments.

Returns:

All appointments that match the given query parameters.

getAttributesBy

<View extends IEffectiveAppointmentStatusProviding> List<View> getAttributesBy(UserContext uc,
                                                                               IAppointmentQueryParams params,
                                                                               Class<View> viewClass)

Returns all the attributes of the appointments specified by the IAppointmentQueryParams.

Parameters:

uc - User context for the database transaction.

params - the appointment query params

viewClass - the class of the IEffectiveAppointmentStatusProviding implementation

Returns:

the attributes specified by the appointment query params

getByUUID

Appointment getByUUID(UserContext uc,
                      String uuid)

Finds the appointment with the given UUID.

Parameters:

uc - Current user context for accessing the database.

uuid - UUID of an appointment.

Returns:

The appointment with the given UUID.

getByUUID

Appointment getByUUID(UserContext uc,
                      String uuid,
                      boolean eager)

Finds the appointment with the given UUID and an is able to load it eagerly.

Parameters:

uc - Current user context for accessing the database.

uuid - UUID of an appointment.

eager - the flag to load the appointment eagerly.

Returns:

The appointment with the given UUID.

getBy

Appointment getBy(UserContext uc,
                  de.xima.cmn.criteria.QueryCriteriaManager qcm,
                  boolean eager)

Finds the appointment with the QueryCriteriaManager and an is able to load it eagerly.

Parameters:

uc - Current user context for accessing the database.

qcm - Custom filter criteria for the appointment.

eager - the flag to load the appointment eagerly.

Returns:

The appointment with the given UUID.

getByUUID

Appointment getByUUID(UserContext uc,
                      UUID uuid)

Finds the appointment with the given UUID.

Parameters:

uc - Current user context for accessing the database.

uuid - UUID of an appointment.

Returns:

The appointment with the given UUID.

moveBookedAppointment

Appointment moveBookedAppointment(UserContext uc,
                                  IAppointmentMoveBookingParams params)
                           throws AppointmentBookingException

Moves an appointment to a different time and date.

Parameters:

uc - Current user context for accessing the database.

params - Parameters with the appointment to move.

Returns:

The updated appointment from the database.

Throws:

AppointmentBookingException - When the booking could not be performed. See AppointmentBookingException.getBookingError() for more details.

validateAppointments

List<EAppointmentBookingError> validateAppointments(UserContext uc,
                                                    IAppointmentValidateParams params)

Validates whether the given appointments can be created or updated.

Parameters:

uc - Current user context for accessing the database.

params - Parameters with the appointments to validate.

Returns:

The validation errors for each appointment.