#2780: Event.java

projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/Event.java Java Model (FullCalendar Event) · projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/Event.java 186 lines · 108 code · 33 comments · 45 blank

The canonical model class representing a single calendar event in the Wicket FullCalendar integration. Maps directly to FullCalendar's JavaScript Event Object fields: unique identifier, title, all-day flag, start/end dates (as Joda-Time DateTime), optional URL link, CSS class name, editability flag, four color properties (text, background, border, and a general color), and an opaque payload field for attaching arbitrary serializable domain data. Every setter returns this for fluent construction. This object is serialized to JSON by Jackson and sent to the client as part of an event source's response.

Architecture

Event Identity

The id field serves as the unique identifier and is used by FullCalendar for event tracking (drag-and-drop persistence, event removal). Events without IDs are treated as ephemeral by the client. The ID typically corresponds to a database primary key (e.g., a calendar event's database row ID).

Color Properties

Four color fields provide granular visual control: color (text and border), backgroundColor, borderColor, and textColor. If only color is set, FullCalendar uses it for all visual aspects. The separate properties allow overriding specific aspects while inheriting others. These are CSS color strings (hex, rgb, or named colors).

Payload Pattern

The payload field (type Serializable) is an extension point for attaching application-specific data to calendar events. For example, a ProjectForge calendar event might carry a reference to the database entity (timesheet entry, vacation request, project milestone) that the event represents. The payload traverses the full round-trip: server → JSON → client → callback → server, enabling server-side handlers to retrieve the domain object associated with a clicked or dragged event.

Joda-Time Usage

Start and end times use Joda-Time's DateTime (not java.util.Date), providing timezone awareness that java.util.Date lacks. The custom serializers in AbstractFullCalendar convert these to ISO-8601 strings that FullCalendar's JavaScript client natively understands.

Git History

Commit	What changed
`868d6abb7` through `ceb63e8a1`	Six annual copyright header updates. The event model has remained stable, reflecting the maturity of the FullCalendar Event Object specification — all standard properties are covered, and the `payload` extension point handles custom data.