de.ipcon.form.scheduler

Class FSchedulerBOModel<I extends BO,C extends BO,G>

java.lang.Object

de.ipcon.swing.scheduler.SchedulerModel<I,C,G>

de.ipcon.form.scheduler.FSchedulerBOModel<I,C,G>

Type Parameters:

I - The specific type of Business Object (extending BO) that represents scheduler items (e.g., appointments, events).

C - The specific type of Business Object (extending BO) that represents scheduler contacts (e.g., a person, an attendee, a resource).

G - The type of object taking the role of scheduler groups (e.g., departments, teams). If group functionality is not used, this type can be set to Void.

public class FSchedulerBOModel<I extends BO,C extends BO,G>
extends de.ipcon.swing.scheduler.SchedulerModel<I,C,G>

A concrete implementation of SchedulerModel responsible for performing Create, Update, and Delete (CUD) actions on Business Objects (BOs) that serve as data for the scheduler component. This class ensures that the already mapped data for the MindFusion scheduler is kept in synchronization with the underlying BOs.

It bridges the gap between the application's core business logic (represented by BOs) and the scheduler's data requirements, handling the persistence and state management of scheduled items, contacts, and groups.

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,com.mindfusion.scheduling.model.Contact>	getAllContacts()
java.util.Map<java.lang.String,de.ipcon.swing.scheduler.Group>	getAllGroups()
java.util.Map<java.lang.String,com.mindfusion.scheduling.model.Item>	getItemsInRange(java.time.LocalDateTime start, java.time.LocalDateTime end)
static <I extends BO,C extends BO,G> FSchedulerBOModel<I,C,G>	of(ClientContextI ctx, SchemaI schema, java.util.function.Supplier<Transaction> rootTx, BO rootBO, java.lang.String contactAttr, FSchedulerBOMapper<I,C,G> mapper) Factory method to create a new instance of FSchedulerBOModel.
void	refreshI(BO bo) Refreshes the state of a specific item in the model.
void	setNewItemFunc(TriFunction<BO,java.time.LocalDateTime,java.time.LocalDateTime,BO> newItemFunc) Sets a custom function for creating new item BOs.
void	verifyMapper(boolean viewOnly) Verifies that the attributes used by the mapper for settable values exist and are actually settable within the context of the Business Objects.

Methods inherited from class de.ipcon.swing.scheduler.SchedulerModel

createItem, getC, getCurrentlyLoadedItems, getG, getI, getIs, isItemLocked, removeItem, updateItem

Methods inherited from class java.lang.Object

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

Method Detail

of

public static <I extends BO,C extends BO,G> FSchedulerBOModel<I,C,G> of(ClientContextI ctx,
                                                                        SchemaI schema,
                                                                        java.util.function.Supplier<Transaction> rootTx,
                                                                        BO rootBO,
                                                                        java.lang.String contactAttr,
                                                                        FSchedulerBOMapper<I,C,G> mapper)

Factory method to create a new instance of FSchedulerBOModel.

This method ensures that the model is created with the same generic types as the provided mapper, thereby guaranteeing type consistency between the domain data stored within this model and the mapping logic defined in the mapper.

Type Parameters:

I - The specific type of Business Object for scheduler items.

C - The specific type of Business Object for scheduler contacts.

G - The type of object for scheduler groups.

Parameters:

ctx - The ClientContextI for the current client session.

schema - The SchemaI describing the BO structure.

rootTx - A Supplier providing the root Transaction for database operations.

rootBO - The root Business Object from which relations might be derived.

contactAttr - The name of the attribute in the root BO that points to contacts.

mapper - The FSchedulerBOMapper instance that defines how domain BOs are mapped to scheduler components.

Returns:

A new, initialized instance of FSchedulerBOModel.

setNewItemFunc

public void setNewItemFunc(TriFunction<BO,java.time.LocalDateTime,java.time.LocalDateTime,BO> newItemFunc)

Sets a custom function for creating new item BOs.

This function will be invoked when a new scheduler item needs to be created in the domain layer. It allows for flexible creation logic beyond a simple default constructor, enabling custom initialization based on the associated Business Object, start time, and end time.

Parameters:

newItemFunc - A TriFunction that takes a Business Object, a LocalDateTime start, and a LocalDateTime end, and returns a new Business Object (item).

verifyMapper

public void verifyMapper(boolean viewOnly)

Verifies that the attributes used by the mapper for settable values exist and are actually settable within the context of the Business Objects.

This method performs checks to ensure data integrity and prevent runtime errors. If viewOnly is false, it additionally verifies that attributes intended for modification are writable. This is crucial if the model is used in a context where modifications to BOs are expected.

Parameters:

viewOnly - If true, only checks for attribute existence. If false, also verifies that attributes configured for setting values are actually writable.

refreshI

public void refreshI(BO bo)

Refreshes the state of a specific item in the model.

This method is used to update the internal representation of a Business Object item (I) and its corresponding scheduler item (Item) after external changes or manual modifications to the BO. It ensures data consistency between the domain model and the scheduler's display.

Parameters:

bo - The Business Object item (I) that needs to be refreshed.

getItemsInRange

public java.util.Map<java.lang.String,com.mindfusion.scheduling.model.Item> getItemsInRange(java.time.LocalDateTime start,
                                                                                            java.time.LocalDateTime end)

Specified by:

getItemsInRange in class de.ipcon.swing.scheduler.SchedulerModel<I extends BO,C extends BO,G>

getAllContacts

public java.util.Map<java.lang.String,com.mindfusion.scheduling.model.Contact> getAllContacts()

Specified by:

getAllContacts in class de.ipcon.swing.scheduler.SchedulerModel<I extends BO,C extends BO,G>

getAllGroups

public java.util.Map<java.lang.String,de.ipcon.swing.scheduler.Group> getAllGroups()

Specified by:

getAllGroups in class de.ipcon.swing.scheduler.SchedulerModel<I extends BO,C extends BO,G>