A named group of auctions run together as one event, holding the auctions and the default start and end dates new ones inherit. A set belongs to one account and its name is used to look it up, so it acts as the container an administrator manages a run of auctions from. Creating an auction inside a set copies the set's start and end dates onto the auction, after which each auction keeps its own dates. Sets are soft deleted: deleting one stamps deletedBy and deletedDate, deletes its auctions as well, and the finders skip anything with a deleted date.
Group: Database Entities
Implements: Serializable, Relational
Properties
| Property | Returns | Description |
|---|---|---|
| auctionEndDate | Date | Default end date for auctions in this set. It is copied onto an auction when the auction is created in the set, and changing it afterwards does not move auctions that already exist. |
| auctions | List<Auction> | The auctions belonging to this set, including any that have been soft deleted. Null rather than empty for a set that has never had an auction added. |
| auctionStartDate | Date | Default start date for auctions in this set. It is copied onto an auction when the auction is created in the set, and changing it afterwards does not move auctions that already exist. |
| createdBy | Profile | The administrator who created the set. Never null, and lazily loaded. |
| createdDate | Date | Date and time the set was created. |
| deletedBy | Profile | The administrator who deleted the set, for a set that has been soft deleted. Lazily loaded. |
| deletedDate | Date | Date and time the set was soft deleted. The finders exclude any set with a deleted date, so setting it hides the set without removing the row. |
| id | long | Database identifier for this auction set. |
| name | String | Portable, path safe identifier for the set, intended to be unique within the account and used as the lookup key. Use getTitle for anything shown to a user. Never null. |
| title | String | Free text display label for the set, which is what lists of sets are sorted by. Not unique and not safe to use as an identifier or path segment. |
Methods
getId() · setId(long id) · setOrganisation(Organisation organisation) · getName() · setName(String name) · getTitle() · setTitle(String title) · getCreatedDate() · setCreatedDate(Date createdDate) · getCreatedBy() · setCreatedBy(Profile createdBy) · getDeletedBy() · setDeletedBy(Profile deletedBy) · getDeletedDate() · setDeletedDate(Date deletedDate) · getAuctionStartDate() · setAuctionStartDate(Date auctionStartDate) · getAuctionEndDate() · setAuctionEndDate(Date auctionEndDate) · getAuctions() · setAuctions(List<Auction> auctions)
getId()
Returns: long
Database identifier for this auction set.
setId(long id)
Returns: void
Sets the database identifier. Normally only assigned by the persistence layer.
| Parameter | Description |
|---|---|
id | the primary key to assign |
setOrganisation(Organisation organisation)
Returns: void
Sets the account this set belongs to. Required.
| Parameter | Description |
|---|---|
organisation | the owning organisation |
getName()
Returns: String
Portable, path safe identifier for the set, intended to be unique within the account and used as the lookup key. Use getTitle for anything shown to a user. Never null.
setName(String name)
Returns: void
Sets the portable identifier for the set. Required, and it should be unique within the account and safe to use in a URL path.
| Parameter | Description |
|---|---|
name | the set's name |
getTitle()
Returns: String
Free text display label for the set, which is what lists of sets are sorted by. Not unique and not safe to use as an identifier or path segment.
setTitle(String title)
Returns: void
Sets the display label shown to users.
| Parameter | Description |
|---|---|
title | the set's display title |
getCreatedDate()
Returns: Date
Date and time the set was created.
setCreatedDate(Date createdDate)
Returns: void
Sets the date and time the set was created.
| Parameter | Description |
|---|---|
createdDate | the creation date |
getCreatedBy()
Returns: Profile
The administrator who created the set. Never null, and lazily loaded.
setCreatedBy(Profile createdBy)
Returns: void
Sets the administrator who created the set. Required.
| Parameter | Description |
|---|---|
createdBy | the profile that created the set |
getDeletedBy()
Returns: Profile
The administrator who deleted the set, for a set that has been soft deleted. Lazily loaded.
setDeletedBy(Profile deletedBy)
Returns: void
Sets the administrator who deleted the set.
| Parameter | Description |
|---|---|
deletedBy | the profile that deleted the set |
getDeletedDate()
Returns: Date
Date and time the set was soft deleted. The finders exclude any set with a deleted date, so setting it hides the set without removing the row.
setDeletedDate(Date deletedDate)
Returns: void
Marks the set as deleted from the given date, or clears the deletion by setting null.
| Parameter | Description |
|---|---|
deletedDate | the deletion date, or null to restore the set |
getAuctionStartDate()
Returns: Date
Default start date for auctions in this set. It is copied onto an auction when the auction is created in the set, and changing it afterwards does not move auctions that already exist.
setAuctionStartDate(Date auctionStartDate)
Returns: void
Sets the default start date applied to auctions created in this set.
| Parameter | Description |
|---|---|
auctionStartDate | the default auction start date |
getAuctionEndDate()
Returns: Date
Default end date for auctions in this set. It is copied onto an auction when the auction is created in the set, and changing it afterwards does not move auctions that already exist.
setAuctionEndDate(Date auctionEndDate)
Returns: void
Sets the default end date applied to auctions created in this set.
| Parameter | Description |
|---|---|
auctionEndDate | the default auction end date |
getAuctions()
Returns: List<Auction>
The auctions belonging to this set, including any that have been soft deleted. Null rather than empty for a set that has never had an auction added.
setAuctions(List<Auction> auctions)
Returns: void
Replaces the list of auctions in this set. Prefer addAuction and removeAuction, which keep the list consistent and save the change.
| Parameter | Description |
|---|---|
auctions | the auctions in the set |