Allows to force this builder to not generate values (through its
getValues() method).
By default (and unless the protocol version 1 is in use, see below) and
for performance reasons, the query builder will not serialize all values
provided to strings. This means that the
#getQueryString may
return a query string with bind markers (where and when is at the
discretion of the builder) and
#getValues will return the binary
values for those markers. This method allows to force the builder to not
generate binary values but rather to serialize them all in the query
string. In practice, this means that if you call
setForceNoValues(true), you are guaranteed that
getValues() will
return
null and that the string returned by
getQueryString() will contain no other bind markers than the one
inputted by the user.
If the native protocol version 1 is in use, the driver will default
to not generating values since those are not supported by that version of
the protocol. In practice, the driver will automatically call this method
with
true as argument prior to execution. Hence, calling this
method when the protocol version 1 is in use is basically a no-op.
Note that this method is mainly useful for debugging purpose. In general,
the default behavior should be the correct and most efficient one.