The property finder will look for a column to property match first if none is found it will try to do a partial match on the property to look for a sub-property.
property name matching
is a case-insensitive match ignoring ‘_’ and ‘ ‘.
the following column will match the property myProperty.
- ‘my property’
property name aliases
If the name of the property does not match the column name it is possible to specify a alias for the property using the
addAlias method on the
JPA @Column annotation
sfm also supports the JPA
@Column annotation to map a property to a column.
@Column(name="id") private long nothingToSeeHere;
id will map to the
The annotation works on fields, getters and setters.
Datastax @Column annotation
the sfm-datastax module provides the same functionality for the datastax @Column annotation.
inner object matching
the inner object matching is done if the complete matching did not found any property. The finder will try to match the start of the column to a property of the object and then will do a match against the column name left over.
for a property property.subProperty the following will match
- ‘property sub property’
if the type of the object is an array or a list then the finder will look for the first number in the column and use at as the index to put the element in. if there is a sub-property specify after the number that will be matched against the element class. If not it will look for a 1 argument constructor.
myList, 'my_list_3' -> will match against the 3rd element of the list as a String.
myList, 'my_list_3_id' -> will match against property id of the 3rd element of the list.
Tuples work in the same way as list/array but the size is limited and the types can be different depending on the element.
If no index is found it will try to find an empty index where the element has not been injected the property yet.
my_list_id, my_list_0_name, my_list_name will map to
Optional properties are also supported.
the column name will map to
if the name is null it will create an empty optional.
The property mapping will look for an injection vector in the following order
Constructor/Factory method Injection
Sfm looks for a static method for which the returns type is that same as the expected type.
Sfm will look for a static method that return a type that will return the builder. A builder needs to have a method that instantiates the targeted class and have a setter method that modifies the builder or return a new version of the builder.
It is also possible to manually specify the method/constructor to instantiate the builder.
final field semantic is respected. The constructor injection will need the asm library to extract the name of the parameters from the debug symbol. If not present then it falls on more expensive strategy on injecting a value through the constructor and looking for a getter that returns the same value.
Customise the property matching
Can inject your own PropertyNameMatcherFactory in the mapper factory.
ie to use have exact and case sensitive match
The property matching is done by the PropertyFinder.