Utility class for providing copying of a designated case class with minimal overhead.
Utility class for providing copying of a designated case class with minimal overhead. ONLY WORKS WITH TOP-LEVEL CASE CLASSES
To use, either import IdImplicits._
or mix in IdImplicitLike
Modified from StackOverflow
Using raw types such as
Long
,java.util.UUID
, andOption[Long]
for database ids invites errors. Scala developers should instead use the Id and HasId wrapper types provided by this project because of the type safety they provide over raw types.Id
andHasId
are database-agnostic. Both auto-incrementId
s andId
s whose value is defined before persisting them are supported.Id
Id
can wrapLong
,UUID
andString
values, and any of them can be optional. The supported flavors ofId
are:Id[Long]
- maps to PostgresBIGINT
orBIGSERIAL
Id[UUID]
- do not misuseId[String]
Id[Option[Long]]
- commonly used with autoincrement columnsId[Option[UUID]]
Id[Option[String]]
Id
is a Scala value object, which means there is little or no runtime cost for using it as compared to the value that it wraps. In other words, there is no penalty for boxing and unboxing.Convenience Types
For convenience, the following types are defined in Types:
OptionLong
–Option[Long]
OptionString
–Option[String]
OptionUuid
–Option[UUID]
IdLong
–Id[Long]
IdString
–Id[String]
IdUuid
–Id[UUID]
IdOptionLong
–Id[Option[Long]
IdOptionString
–Id[Option[String]]
IdOptionUuid
–Id[Option[UUID]]
Id.empty
Id
s define a special value, calledempty
. EachId
flavor has a unique value forempty
. FYI, the values forempty
are:IdUuid.empty == new UUID(0, 0)
IdLong.empty == 0L
IdString.empty == ""
IdOptionUuid.empty = None
IdOptionLong.empty = None
IdOptionString.empty = None
Depending on the context, you might need to provide type ascription when using
Id.empty
. For example,IdUuid.empty
orIdOptionLong.empty
.Id.toOption
You can use the
Id.toOption
method to convert from anIdLong
orIdUuid
toIdOptionLong
orIdOptionUuid
.Be sure to cast the result to the desired
Id
subtype, otherwise you'll get a weird unhelpful type:HasId
Each case class that uses
Id
to represent the persisted record id in the database must extendHasId
.HasId
is a parametric type with two type parameters:Id
for the case class.For example, you can make
MyCaseClass
extendHasId
by writing something like this for the extended type:HasId[MyCaseClass, Long]
HasId[MyCaseClass, UUID]
HasId[MyCaseClass, String]
HasId[MyCaseClass, OptionLong]
– Most commonly used flavorHasId[MyCaseClass, OptionUuid]
HasId[MyCaseClass, OptionString]
Usage Examples
Here are examples of using
Id
andHasId
:Simple Example
HasId Sub-Subclasses
Subclasses of
HasId
subclasses should be parametric. In the following example,Rateable
is an abstract class that subclassesHasId
. Notice thatRateable
is parametric inT
, andHasId
's first type parameter is alsoT
:The following two
Rateable
subclasses provide values forT
that match the names of the derived classes: