registerResultConverter

Registers a ResultConverter for this query and nothing else.

The driver gives every query converter registries of its own, chained to the session's and thrown away with the query; this is how a builder reaches them. A one-off mapping - a column read as something other than what the registry says, a shape that exists in one report and nowhere else - therefore costs nothing outside the query it was written for, where registering on the type manager would reach every session pointing at the same database.

Registered ahead of whatever the session already holds, and later registrations here win over earlier ones.

db.select("payload").from("dispatches")
    .registerResultConverter(SealedEnvelopeConverter)
    .where("legion_id = @id")
    .fetchObjects<Envelope>("id" to 7)

Parameters