io.temporal.common.converter

Class DefaultDataConverter

java.lang.Object

io.temporal.common.converter.DefaultDataConverter

All Implemented Interfaces:

DataConverter

public class DefaultDataConverter
extends java.lang.Object
implements DataConverter

DataConverter that delegates conversion to type specific PayloadConverter instance.

Constructor Summary

Constructors

Constructor and Description
DefaultDataConverter(PayloadConverter... converters) Creates instance from ordered array of converters.

Method Summary

Modifier and Type	Method and Description
java.lang.Object[]	arrayFromPayloads(java.util.Optional<io.temporal.common.v1.Payloads> content, java.lang.Class<?>[] parameterTypes, java.lang.reflect.Type[] valueTypes) Implements conversion of an array of values of different types.
<T> T	fromPayload(io.temporal.common.v1.Payload payload, java.lang.Class<T> valueClass, java.lang.reflect.Type valueType)
<T> T	fromPayloads(java.util.Optional<io.temporal.common.v1.Payloads> content, java.lang.Class<T> valueClass, java.lang.reflect.Type valueType) Implements conversion of a single value.
static void	setDefaultDataConverter(DataConverter converter) Override the global data converter default.
<T> java.util.Optional<io.temporal.common.v1.Payload>	toPayload(T value)
java.util.Optional<io.temporal.common.v1.Payloads>	toPayloads(java.lang.Object... values) When values is empty or it contains a single value and it is null then return empty blob.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultDataConverter

public DefaultDataConverter(PayloadConverter... converters)

Creates instance from ordered array of converters. When converting an object to payload the array of converters is iterated from the beginning until one of the converters succesfully converts the value.

Method Detail

setDefaultDataConverter

public static void setDefaultDataConverter(DataConverter converter)

Override the global data converter default. Consider overriding data converter per client instance (using WorkflowClientOptions.Builder.setDataConverter(DataConverter) to avoid potential conflicts.

Parameters:

converter -

toPayload

public <T> java.util.Optional<io.temporal.common.v1.Payload> toPayload(T value)

Specified by:

toPayload in interface DataConverter

fromPayload

public <T> T fromPayload(io.temporal.common.v1.Payload payload,
                         java.lang.Class<T> valueClass,
                         java.lang.reflect.Type valueType)

Specified by:

fromPayload in interface DataConverter

toPayloads

public java.util.Optional<io.temporal.common.v1.Payloads> toPayloads(java.lang.Object... values)
                                                              throws DataConverterException

When values is empty or it contains a single value and it is null then return empty blob. If a single value do not wrap it into Json array. Exception stack traces are converted to a single string stack trace to save space and make them more readable.

Specified by:

toPayloads in interface DataConverter

Parameters:

values - Java values to convert to String.

Returns:

serialized values

Throws:

DataConverterException - if conversion of the value passed as parameter failed for any reason.

fromPayloads

public <T> T fromPayloads(java.util.Optional<io.temporal.common.v1.Payloads> content,
                          java.lang.Class<T> valueClass,
                          java.lang.reflect.Type valueType)
                   throws DataConverterException

Description copied from interface: DataConverter

Implements conversion of a single value.

Specified by:

fromPayloads in interface DataConverter

Parameters:

content - Serialized value to convert to a Java object.

valueClass - type of the parameter stored in the content

valueType - generic type of the parameter stored in the content

Returns:

converted Java object

Throws:

DataConverterException - if conversion of the data passed as parameter failed for any reason.

arrayFromPayloads

public java.lang.Object[] arrayFromPayloads(java.util.Optional<io.temporal.common.v1.Payloads> content,
                                            java.lang.Class<?>[] parameterTypes,
                                            java.lang.reflect.Type[] valueTypes)
                                     throws DataConverterException

Description copied from interface: DataConverter

Implements conversion of an array of values of different types. Useful for deserializing arguments of function invocations.

Specified by:

arrayFromPayloads in interface DataConverter

Parameters:

content - serialized value to convert to Java objects.

parameterTypes - types of the parameters stored in the content

valueTypes - generic types of the parameters stored in the content

Returns:

array of converted Java objects

Throws:

DataConverterException - if conversion of the data passed as parameter failed for any reason.