feat #168: pluggable serialization support (with jackson for now)

[lilgallon]

Migration guide

To keep the same behavior as before (after merging this), add:

// runtimeClasspath is enough, you probably should not need it directly in your code
// if it's the case, it either means our API has flaws (you can open an issue if it's
// the case) or because you are not using the right `OcpiSerializer` method for your
// use case (see below)
runtimeClasspath("com.izivia:ocpi-2-2-1-jackson:<version>")

And mapper package changed

import com.izivia.ocpi.toolkit.common.mapper // before
import com.izivia.ocpi.toolkit.serialization.mapper // after

And its functions changed, because it's generic now

// before
mapper.writeValueAsString(value)
// after
import com.izivia.ocpi.toolkit.serialization.serialize
mapper.serialize(value) 

// before
mapper.writeValueAsString(value, class)
// after
mapper.serializeObject(value, class) 

// before
mapper.readValue(value, class)
// after
mapper.deserializeObject(value, class) 

// before
mapper.readValue<XX>(value)
// after
mapper.deserializeObject<XX>(value) 

// before
mapper.readValue<XX>(value, jacksonTypeDef)
// after
import com.izivia.ocpi.toolkit.serialization.serialize
mapper.deserializeOcpiResponse<XX>(value) // use the right specific method

Otherwise, no breaking change is expected. The mapper behavior stays the same.

Use your own mapper (serializer implementation)

Add a file in: META-INF/services/com.izivia.ocpi.toolkit.serialization.OcpiSerializer specifying where your OcpiSerializer implementation is located, and don't import com.izivia:ocpi-2-2-1-jackson

Description

I added plenty of mapping tests for each OCPI data structure, and made sure exception were taken into account:

• Enums.OTHER: deserialized as OTHER if unknown enum
• Connector.tariffIds: ignore null values

---

closes #168

[lilgallon]

Testing internally, this feature did not introduce any regression according to our tests. It's ready for final review

[sonarqubecloud]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud