Interface ServiceOutputParameter
-
- All Superinterfaces:
ServiceParameter
- All Known Implementing Classes:
BaseServiceOutputParameter
public interface ServiceOutputParameter extends ServiceParameter
The interface of a service output parameter used in a service definition.- Author:
- Micha Kiener
-
-
Field Summary
Fields Modifier and Type Field Description static StringMISSING_VALUE_CONFIG_IGNOREUse this setting, if a missing output value should be ignored (left missing and not be overwritten with another value).static StringMISSING_VALUE_CONFIG_SET_TO_DEFAULTUse this setting, if a missing output value should be set to a default value instead.static StringMISSING_VALUE_CONFIG_SET_TO_NULLUse this setting, if a missing output value should be set to null instead.static StringMISSING_VALUE_CONFIG_THROW_EXCEPTIONUse this setting, if a missing output value should throw an exception.static StringNULL_VALUE_CONFIG_REMOVEUse this setting, if an existing output value which is null should be removed from the result.static StringNULL_VALUE_CONFIG_SET_TO_DEFAULTUse this setting, if an existing output value which is null should be set to a default value instead of null.static StringNULL_VALUE_CONFIG_SET_TO_NULLUse this setting, if an existing output value which is null should be left as is.static StringNULL_VALUE_CONFIG_THROW_EXCEPTIONUse this setting, if an existing output value which is null should throw an exception.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description BooleangetErrorParameter()Returns whether this ServiceOutputParameter is only used for handling errorsStringgetMissingValueConfig()Returns the configuration on how to handle a missing value returned by the service invocation by this parameter.StringgetMissingValueDefault()If the null value config returned bygetMissingValueConfig()is set toMISSING_VALUE_CONFIG_SET_TO_DEFAULT, this method returns the default value to be returned instead of null (might be an expression or any value converted into the target parameter type).NestedOutputMappinggetNestedOutputMapping()Certain output parameters have a 'nested' definition (e.g.StringgetNullValueConfig()Returns the configuration on how to handle a null value returned by the service invocation by this parameter.StringgetNullValueDefault()If the null value config returned bygetNullValueConfig()is set toNULL_VALUE_CONFIG_SET_TO_DEFAULT, this method returns the default value to be returned instead of null (might be an expression or any value converted into the target parameter type).StringgetPath()Returns the optional path where the parameter value will be retrieved out of the returned service invocation result.StringgetSource()Returns the optional source where the parameter value will be retrieved from of the returned service invocation result.-
Methods inherited from interface com.flowable.serviceregistry.api.repository.ServiceParameter
getDescription, getDisplayName, getMappingName, getName, getType
-
-
-
-
Field Detail
-
NULL_VALUE_CONFIG_REMOVE
static final String NULL_VALUE_CONFIG_REMOVE
Use this setting, if an existing output value which is null should be removed from the result.- See Also:
- Constant Field Values
-
NULL_VALUE_CONFIG_SET_TO_DEFAULT
static final String NULL_VALUE_CONFIG_SET_TO_DEFAULT
Use this setting, if an existing output value which is null should be set to a default value instead of null.- See Also:
- Constant Field Values
-
NULL_VALUE_CONFIG_SET_TO_NULL
static final String NULL_VALUE_CONFIG_SET_TO_NULL
Use this setting, if an existing output value which is null should be left as is.- See Also:
- Constant Field Values
-
NULL_VALUE_CONFIG_THROW_EXCEPTION
static final String NULL_VALUE_CONFIG_THROW_EXCEPTION
Use this setting, if an existing output value which is null should throw an exception.- See Also:
- Constant Field Values
-
MISSING_VALUE_CONFIG_IGNORE
static final String MISSING_VALUE_CONFIG_IGNORE
Use this setting, if a missing output value should be ignored (left missing and not be overwritten with another value).- See Also:
- Constant Field Values
-
MISSING_VALUE_CONFIG_SET_TO_DEFAULT
static final String MISSING_VALUE_CONFIG_SET_TO_DEFAULT
Use this setting, if a missing output value should be set to a default value instead.- See Also:
- Constant Field Values
-
MISSING_VALUE_CONFIG_SET_TO_NULL
static final String MISSING_VALUE_CONFIG_SET_TO_NULL
Use this setting, if a missing output value should be set to null instead.- See Also:
- Constant Field Values
-
MISSING_VALUE_CONFIG_THROW_EXCEPTION
static final String MISSING_VALUE_CONFIG_THROW_EXCEPTION
Use this setting, if a missing output value should throw an exception.- See Also:
- Constant Field Values
-
-
Method Detail
-
getPath
String getPath()
Returns the optional path where the parameter value will be retrieved out of the returned service invocation result.- Returns:
- the optional path for the result value
-
getSource
String getSource()
Returns the optional source where the parameter value will be retrieved from of the returned service invocation result.- Returns:
- the optional path for the result value
-
getErrorParameter
Boolean getErrorParameter()
Returns whether this ServiceOutputParameter is only used for handling errors- Returns:
- true, if it is an error output parameter
-
getNullValueConfig
String getNullValueConfig()
Returns the configuration on how to handle a null value returned by the service invocation by this parameter. Might be 'remove', 'setToDefault', 'setToNull' or 'throwException' (see constant definition documentation for details).- Returns:
- the configuration on how to handle a null value as the output for this parameter
-
getMissingValueConfig
String getMissingValueConfig()
Returns the configuration on how to handle a missing value returned by the service invocation by this parameter. Might be 'ignore', 'setToDefault', 'setToNull' or 'throwException' (see constant definition documentation for details).- Returns:
- the configuration on how to handle a missing value as the output for this parameter
-
getNullValueDefault
String getNullValueDefault()
If the null value config returned bygetNullValueConfig()is set toNULL_VALUE_CONFIG_SET_TO_DEFAULT, this method returns the default value to be returned instead of null (might be an expression or any value converted into the target parameter type).- Returns:
- the optional default value to be used if the null value config is actually set to default
-
getMissingValueDefault
String getMissingValueDefault()
If the null value config returned bygetMissingValueConfig()is set toMISSING_VALUE_CONFIG_SET_TO_DEFAULT, this method returns the default value to be returned instead of null (might be an expression or any value converted into the target parameter type).- Returns:
- the optional default value to be used if the missing value config is actually set to default
-
getNestedOutputMapping
NestedOutputMapping getNestedOutputMapping()
Certain output parameters have a 'nested' definition (e.g. when a server returns nested json). TheNestedOutputMappingcontains this mapping of the nested data.- Returns:
- the optional nested mapping.
-
-