de.ipcon.form.scheduler

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

java.lang.Object

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

de.ipcon.form.scheduler.FSchedulerBOMapper<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. If grouping is achieved by assigning items or contacts the same name or ID, it can also be set to a scalar type (String, Long, etc)

public class FSchedulerBOMapper<I extends BO,C extends BO,G>
extends de.ipcon.swing.scheduler.SchedulerMapper<I,C,G>

A concrete implementation of the SchedulerMapper that defines which business objects (BOs) are associated with which MindFusion data types (items, contacts, groups) and how their values relate to each other, by serving as a container for more specific mappers that provide configuration options for each object type involved.

A new FSchedulerBOMapper should be created using the ofClasses(java.lang.Class<I>, java.lang.Class<C>) factory method, which assures that the generic types are correctly set from the provided class parameters. Once constructed, calls to itemMapper(), contactMapper(), groupMapper() may be called and chained to provide attributes or functions that define the actual mapping of values (e.g. start time, end time, display name)

Method Summary

Modifier and Type	Method and Description
boolean	canUseItemQuery() This method checks if enough and the right attributes were provided for the configuration of the itemMapper() to be likely able to query items.
ContactBOMapper<C,I,G>	contactMapper() This method retrieves the inner ContactMapper of generic type C, which provides options to configure how MindFusion scheduling Contacts are mapped to the BO-subtype set as generic param C.
GroupBOMapper<G>	groupMapper() This method retrieves the inner GroupMapper of generic type G, which provides options to configure how MindFusion scheduling Groups are mapped to the BO-subtype set as generic param G.
ItemBOMapper<I,C,G>	itemMapper() This method retrieves the inner ItemMapper of generic type I, which provides options to configure how MindFusion scheduling Items are mapped to the BO-subtype set as generic param I.
static <I extends BO,C extends BO> FSchedulerBOMapper<I,C,java.lang.Void>	ofClasses(java.lang.Class<I> itemClazz, java.lang.Class<C> contactClazz)
static <I extends BO,C extends BO,G> FSchedulerBOMapper<I,C,G>	ofClasses(java.lang.Class<I> itemClazz, java.lang.Class<C> contactClazz, java.lang.Class<G> groupClass)

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

getContactClass, getGroupClass, getItemClass, mapContact, mapGroup, mapItem, setValues, setValues

Methods inherited from class java.lang.Object

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

Method Detail

ofClasses

public static <I extends BO,C extends BO> FSchedulerBOMapper<I,C,java.lang.Void> ofClasses(java.lang.Class<I> itemClazz,
                                                                                           java.lang.Class<C> contactClazz)

ofClasses

public static <I extends BO,C extends BO,G> FSchedulerBOMapper<I,C,G> ofClasses(java.lang.Class<I> itemClazz,
                                                                                java.lang.Class<C> contactClazz,
                                                                                java.lang.Class<G> groupClass)

itemMapper

public ItemBOMapper<I,C,G> itemMapper()

This method retrieves the inner ItemMapper of generic type I, which provides options to configure how MindFusion scheduling Items are mapped to the BO-subtype set as generic param I.

This method never returns null, but either a new or the existing ItemMapper for this instance.

The configuration of the ItemMapper is mandatory. At the very least, values should be provided to one of the overloaded method variants of ItemBOMapper.start(java.lang.String), ItemBOMapper.end(java.lang.String) and ItemBOMapper.displayText(java.lang.String). Use persistent attributes for the start and end dates to enable automatic querying, or provide a query using ItemMapper.query(TriFunction)

Specified by:

itemMapper in class de.ipcon.swing.scheduler.SchedulerMapper<I extends BO,C extends BO,G>

Returns:

a new or existing ContactBOMapper for this instance.

contactMapper

public ContactBOMapper<C,I,G> contactMapper()

This method retrieves the inner ContactMapper of generic type C, which provides options to configure how MindFusion scheduling Contacts are mapped to the BO-subtype set as generic param C.

This method never returns null, but either a new or the existing ContactMapper for this instance.

The use of contacts is optional for most view types of the MindFusion calendar, except the ResourceView.

Specified by:

contactMapper in class de.ipcon.swing.scheduler.SchedulerMapper<I extends BO,C extends BO,G>

Returns:

a new or existing ContactBOMapper for this instance.

groupMapper

public GroupBOMapper<G> groupMapper()

This method retrieves the inner GroupMapper of generic type G, which provides options to configure how MindFusion scheduling Groups are mapped to the BO-subtype set as generic param G.

This method never returns null, but either a new or the existing GroupMapper for this instance.

Grouping of items, and thus, by extension, the configuration of the groupMapper, is optional.

Specified by:

groupMapper in class de.ipcon.swing.scheduler.SchedulerMapper<I extends BO,C extends BO,G>

Returns:

a new or existing GroupBOMapper for this instance.

canUseItemQuery

public boolean canUseItemQuery()

This method checks if enough and the right attributes were provided for the configuration of the itemMapper() to be likely able to query items.

Whether the set attributes are persistent or virtual is currently not considered and needs to be checked in a different context, preferably one with access to the SchemaI describing the BO class used for items.

Returns:

true if the use of a database for optimized loading of items is likely possible, false if it is most certainly not possible.