* `1` in the data type indicates the number of batch member types this config supports. 33 | * 34 | *
* For other Simple fields, please use `liftUtil` to lift corresponding validators. 35 | * 36 | * @param Container data type 37 | * @param Batch Member data type 38 | * @param 39 | */ 40 | @Value 41 | @FieldDefaults(level = AccessLevel.PACKAGE) 42 | @EqualsAndHashCode(callSuper = true) 43 | @SuperBuilder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 44 | public class BatchOfBatch1ValidationConfig 45 | extends BaseBatchValidationConfig { 46 | Tuple2< 47 | Function1>, 48 | BatchValidationConfig> 49 | withMemberBatchValidationConfig; 50 | } 51 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/BatchValidationConfig.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | /******************************************************************************* 9 | * Copyright (c) 2022, salesforce.com, inc. 10 | * All rights reserved. 11 | * SPDX-License-Identifier: BSD-3-Clause 12 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 13 | ******************************************************************************/ 14 | 15 | package com.salesforce.vador.config; 16 | 17 | import com.salesforce.vador.config.base.BaseBatchValidationConfig; 18 | import lombok.EqualsAndHashCode; 19 | import lombok.Value; 20 | import lombok.experimental.SuperBuilder; 21 | 22 | @Value 23 | @EqualsAndHashCode(callSuper = true) 24 | @SuperBuilder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 25 | public class BatchValidationConfig 26 | extends BaseBatchValidationConfig {} 27 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/FieldConfig.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | /******************************************************************************* 9 | * Copyright (c) 2022, salesforce.com, inc. 10 | * All rights reserved. 11 | * SPDX-License-Identifier: BSD-3-Clause 12 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 13 | ******************************************************************************/ 14 | 15 | package com.salesforce.vador.config; 16 | 17 | import de.cronn.reflection.util.TypedPropertyGetter; 18 | import io.vavr.Function2; 19 | import io.vavr.Tuple2; 20 | import java.util.Collection; 21 | import java.util.Map; 22 | import java.util.function.Predicate; 23 | import lombok.AccessLevel; 24 | import lombok.Builder; 25 | import lombok.NonNull; 26 | import lombok.Singular; 27 | import lombok.Value; 28 | import lombok.experimental.FieldDefaults; 29 | import org.jetbrains.annotations.Nullable; 30 | 31 | @Value 32 | @FieldDefaults(level = AccessLevel.PACKAGE) 33 | @Builder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 34 | public class FieldConfig { 35 | @Nullable Predicate withFieldValidator; 36 | 37 | @Singular("shouldHaveValidFormatOrFailWith") 38 | Map, FailureT> shouldHaveValidFormatForAllOrFailWith; 39 | 40 | @Nullable 41 | Tuple2< 42 | @NonNull Collection<@NonNull TypedPropertyGetter>, 43 | @NonNull Function2> 44 | shouldHaveValidFormatForAllOrFailWithFn; 45 | 46 | @Singular("shouldHaveValidFormatOrFailWithFn") 47 | Map, Function2> 48 | shouldHaveValidFormatOrFailWithFn; 49 | 50 | @Singular("absentOrHaveValidFormatOrFailWith") 51 | Map, FailureT> absentOrHaveValidFormatForAllOrFailWith; 52 | 53 | @Nullable 54 | Tuple2< 55 | @NonNull Collection<@NonNull TypedPropertyGetter>, 56 | @NonNull Function2> 57 | absentOrHaveValidFormatForAllOrFailWithFn; 58 | 59 | @Singular("absentOrHaveValidFormatOrFailWithFn") 60 | Map, Function2> 61 | absentOrHaveValidFormatOrFailWithFn; 62 | } 63 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/FilterDuplicatesConfig.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | /******************************************************************************* 9 | * Copyright (c) 2022, salesforce.com, inc. 10 | * All rights reserved. 11 | * SPDX-License-Identifier: BSD-3-Clause 12 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 13 | ******************************************************************************/ 14 | 15 | package com.salesforce.vador.config; 16 | 17 | import io.vavr.Function1; 18 | import lombok.AccessLevel; 19 | import lombok.Builder; 20 | import lombok.Value; 21 | import lombok.experimental.FieldDefaults; 22 | import org.jetbrains.annotations.Nullable; 23 | 24 | @Value 25 | @FieldDefaults(level = AccessLevel.PACKAGE) 26 | @Builder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 27 | public class FilterDuplicatesConfig { 28 | // `andFailDuplicatesWith` is not mandatory for `findAndFilterDuplicatesWith`. 29 | // You may want to just filter without failing duplicates. So they are separated 30 | @Nullable Function1 findAndFilterDuplicatesWith; 31 | @Nullable FailureT andFailDuplicatesWith; 32 | @Nullable FailureT andFailNullKeysWith; 33 | } 34 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/ValidationConfig.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | /******************************************************************************* 9 | * Copyright (c) 2022, salesforce.com, inc. 10 | * All rights reserved. 11 | * SPDX-License-Identifier: BSD-3-Clause 12 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 13 | ******************************************************************************/ 14 | 15 | package com.salesforce.vador.config; 16 | 17 | import com.salesforce.vador.config.base.BaseValidationConfig; 18 | import lombok.AccessLevel; 19 | import lombok.EqualsAndHashCode; 20 | import lombok.Value; 21 | import lombok.experimental.FieldDefaults; 22 | import lombok.experimental.SuperBuilder; 23 | 24 | @Value 25 | @FieldDefaults(level = AccessLevel.PACKAGE) 26 | @EqualsAndHashCode(callSuper = true) 27 | @SuperBuilder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 28 | public class ValidationConfig 29 | extends BaseValidationConfig {} 30 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/base/BaseBatchValidationConfig.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | /******************************************************************************* 9 | * Copyright (c) 2022, salesforce.com, inc. 10 | * All rights reserved. 11 | * SPDX-License-Identifier: BSD-3-Clause 12 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 13 | ******************************************************************************/ 14 | 15 | package com.salesforce.vador.config.base; 16 | 17 | import com.salesforce.vador.config.FilterDuplicatesConfig.FilterDuplicatesConfigBuilder; 18 | import java.util.Collection; 19 | import lombok.EqualsAndHashCode; 20 | import lombok.Getter; 21 | import lombok.Singular; 22 | import lombok.experimental.SuperBuilder; 23 | import org.jetbrains.annotations.Nullable; 24 | 25 | @Getter 26 | @EqualsAndHashCode(callSuper = true) 27 | @SuperBuilder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 28 | public abstract class BaseBatchValidationConfig 29 | extends BaseValidationConfig { 30 | 31 | @Singular 32 | protected Collection> 33 | findAndFilterDuplicatesConfigs; 34 | } 35 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/base/BaseContainerValidationConfig.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | /******************************************************************************* 9 | * Copyright (c) 2022, salesforce.com, inc. 10 | * All rights reserved. 11 | * SPDX-License-Identifier: BSD-3-Clause 12 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 13 | ******************************************************************************/ 14 | 15 | package com.salesforce.vador.config.base; 16 | 17 | import com.salesforce.vador.config.container.ContainerValidationConfigEx; 18 | import com.salesforce.vador.types.Validator; 19 | import com.salesforce.vador.types.ValidatorEtr; 20 | import io.vavr.Tuple2; 21 | import java.util.Collection; 22 | import java.util.List; 23 | import java.util.Map; 24 | import lombok.Getter; 25 | import lombok.NonNull; 26 | import lombok.Singular; 27 | import lombok.experimental.SuperBuilder; 28 | import org.jetbrains.annotations.Nullable; 29 | 30 | @Getter 31 | @SuperBuilder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 32 | public abstract class BaseContainerValidationConfig { 33 | @Nullable protected Tuple2<@NonNull Integer, @Nullable FailureT> shouldHaveMinBatchSizeOrFailWith; 34 | @Nullable protected Tuple2<@NonNull Integer, @Nullable FailureT> shouldHaveMaxBatchSizeOrFailWith; 35 | 36 | @Singular 37 | protected Collection> withContainerValidatorEtrs; 38 | 39 | @Nullable 40 | protected Tuple2< 41 | @NonNull Collection>, 42 | @Nullable FailureT> 43 | withContainerValidators; 44 | 45 | @Singular("withContainerValidator") 46 | protected Map, FailureT> 47 | withContainerValidator; 48 | 49 | public List> getContainerValidators() { 50 | return ContainerValidationConfigEx.getContainerValidatorsEx(this); 51 | } 52 | } 53 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/base/BaseValidationConfigEx.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("BaseValidationConfigEx") 9 | 10 | package com.salesforce.vador.config.base 11 | 12 | import com.salesforce.vador.specs.factory.SpecFactory 13 | import com.salesforce.vador.specs.specs.Spec1 14 | import com.salesforce.vador.specs.specs.Spec2 15 | import com.salesforce.vador.specs.specs.Spec3 16 | import com.salesforce.vador.specs.specs.base.BaseSpec 17 | import com.salesforce.vador.types.Validator 18 | import de.cronn.reflection.util.PropertyUtils 19 | import de.cronn.reflection.util.TypedPropertyGetter 20 | import io.vavr.Function1 21 | import java.lang.reflect.Type 22 | import java.util.Optional 23 | import java.util.function.Predicate 24 | import net.jodah.typetools.TypeResolver 25 | 26 | internal fun BaseValidationConfig.getSpecsEx(): 27 | List> { 28 | val specFactory = SpecFactory() 29 | return (specify?.invoke(specFactory)?.map { it.done() as BaseSpec } 30 | ?: emptyList()) + 31 | withSpecs.map { it.invoke(specFactory).done() as BaseSpec } 32 | } 33 | 34 | internal fun BaseValidationConfig 35 | .getPredicateOfSpecForTestEx(nameForTest: String): Optional> { 36 | // TODO 29/04/21 gopala.akshintala: Move this duplicate-check to ValidationConfig `prepare` 37 | val specNameToSpecs = 38 | specs.groupingBy { it.nameForTest }.eachCount().filter { it.value > 1 }.keys.filterNotNull() 39 | require(specNameToSpecs.isEmpty()) { "Specs with Duplicate NamesForTest found: $specNameToSpecs" } 40 | return Optional.ofNullable(specs.first { it.nameForTest == nameForTest }?.toPredicate()) 41 | } 42 | 43 | internal fun BaseValidationConfig.getRequiredFieldNamesEx( 44 | beanClass: Class 45 | ): Set = 46 | (shouldHaveFieldsOrFailWith.keys + 47 | (shouldHaveFieldsOrFailWithFn?._1 ?: emptyList()) + 48 | shouldHaveFieldOrFailWithFn.keys) 49 | .map { PropertyUtils.getPropertyName(beanClass, it) } 50 | .toSet() 51 | 52 | internal fun getValidatableType( 53 | config: BaseValidationConfig 54 | ): Type? { 55 | (config.withValidators?._1?.firstOrNull() ?: config.withValidator.keys.firstOrNull())?.let { 56 | return TypeResolver.resolveRawArguments(Validator::class.java, it.javaClass)[0] 57 | } 58 | (config.shouldHaveFieldsOrFailWith.keys.firstOrNull() 59 | ?: config.shouldHaveFieldsOrFailWithFn?._1?.firstOrNull() 60 | ?: config.shouldHaveFieldOrFailWithFn.keys.firstOrNull()) 61 | ?.let { 62 | return TypeResolver.resolveRawArguments(TypedPropertyGetter::class.java, it.javaClass)[0] 63 | } 64 | // ! TODO gopala.akshintala 14/08/22: For other fields and FieldConfig 65 | config.withIdConfigs 66 | ?.firstOrNull() 67 | ?.prepare() 68 | ?.shouldHaveValidSFIdFormatForAllOrFailWith 69 | ?.keys 70 | ?.firstOrNull() 71 | ?._1 72 | ?.let { 73 | return TypeResolver.resolveRawArguments(TypedPropertyGetter::class.java, it.javaClass)[0] 74 | } 75 | config.getSpecsEx().firstOrNull()?.let { 76 | // ! TODO gopala.akshintala 15/08/22: Resolve for other Specs 77 | return when (it) { 78 | is Spec1<*, *, *> -> 79 | TypeResolver.resolveRawArguments(Function1::class.java, it.given.javaClass)[0] 80 | is Spec2<*, *, *, *> -> 81 | TypeResolver.resolveRawArguments(Function1::class.java, it.`when`.javaClass)[0] 82 | is Spec3<*, *, *, *, *> -> 83 | TypeResolver.resolveRawArguments(Function1::class.java, it.`when`.javaClass)[0] 84 | else -> null 85 | } 86 | } 87 | return null 88 | } 89 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/container/ContainerValidationConfig.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | /******************************************************************************* 9 | * Copyright (c) 2022, salesforce.com, inc. 10 | * All rights reserved. 11 | * SPDX-License-Identifier: BSD-3-Clause 12 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 13 | ******************************************************************************/ 14 | 15 | package com.salesforce.vador.config.container; 16 | 17 | import com.salesforce.vador.config.base.BaseContainerValidationConfig; 18 | import de.cronn.reflection.util.TypedPropertyGetter; 19 | import java.util.Collection; 20 | import java.util.Set; 21 | import lombok.AccessLevel; 22 | import lombok.EqualsAndHashCode; 23 | import lombok.Singular; 24 | import lombok.Value; 25 | import lombok.experimental.FieldDefaults; 26 | import lombok.experimental.SuperBuilder; 27 | import org.jetbrains.annotations.Nullable; 28 | 29 | @Value 30 | @FieldDefaults(level = AccessLevel.PACKAGE) 31 | @EqualsAndHashCode(callSuper = true) 32 | @SuperBuilder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 33 | public class ContainerValidationConfig 34 | extends BaseContainerValidationConfig { 35 | 36 | @Singular 37 | Collection>> withBatchMembers; 38 | 39 | public Set getFieldNamesForBatch(Class validatableClazz) { 40 | return ContainerValidationConfigEx.getFieldNamesForBatchEx(this, validatableClazz); 41 | } 42 | } 43 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/container/ContainerValidationConfigEx.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("ContainerValidationConfigEx") 9 | 10 | package com.salesforce.vador.config.container 11 | 12 | import com.salesforce.vador.config.base.BaseContainerValidationConfig 13 | import com.salesforce.vador.execution.strategies.util.fromValidators1 14 | import com.salesforce.vador.execution.strategies.util.fromValidators2 15 | import com.salesforce.vador.types.ValidatorEtr 16 | import de.cronn.reflection.util.PropertyUtils 17 | 18 | internal fun BaseContainerValidationConfig< 19 | ContainerValidatableT?, 20 | FailureT?, 21 | > 22 | .getContainerValidatorsEx(): List> = 23 | fromValidators1(withContainerValidators) + 24 | fromValidators2(withContainerValidator) + 25 | withContainerValidatorEtrs 26 | 27 | internal fun ContainerValidationConfig< 28 | ContainerValidatableT?, 29 | FailureT?, 30 | > 31 | .getFieldNamesForBatchEx(validatableClazz: Class): Set = 32 | withBatchMembers.map { PropertyUtils.getPropertyName(validatableClazz, it) }.toSet() 33 | 34 | internal fun ContainerValidationConfigWith2Levels< 35 | ContainerValidatableT?, 36 | *, 37 | FailureT?, 38 | > 39 | .getFieldNamesForBatchEx(validatableClazz: Class): Set = 40 | withBatchMembers.map { PropertyUtils.getPropertyName(validatableClazz, it) }.toSet() 41 | 42 | internal fun ContainerValidationConfigWith2Levels< 43 | *, 44 | NestedContainerValidatableT?, 45 | FailureT?, 46 | > 47 | .getFieldNamesForBatchLevel1Ex( 48 | validatableClazz: Class 49 | ): Set = 50 | withScopeOf1LevelDeep.withBatchMembers 51 | .map { PropertyUtils.getPropertyName(validatableClazz, it) } 52 | .toSet() 53 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/config/container/ContainerValidationConfigWith2Levels.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | package com.salesforce.vador.config.container; 9 | 10 | import com.salesforce.vador.config.base.BaseContainerValidationConfig; 11 | import de.cronn.reflection.util.TypedPropertyGetter; 12 | import java.util.Collection; 13 | import java.util.Set; 14 | import lombok.AccessLevel; 15 | import lombok.EqualsAndHashCode; 16 | import lombok.Singular; 17 | import lombok.Value; 18 | import lombok.experimental.FieldDefaults; 19 | import lombok.experimental.SuperBuilder; 20 | import org.jetbrains.annotations.Nullable; 21 | 22 | @Value 23 | @FieldDefaults(level = AccessLevel.PACKAGE) 24 | @EqualsAndHashCode(callSuper = true) 25 | @SuperBuilder(buildMethodName = "prepare", builderMethodName = "toValidate", toBuilder = true) 26 | public class ContainerValidationConfigWith2Levels< 27 | ContainerRootLevelValidatableT, ContainerLevel1ValidatableT, FailureT> 28 | extends BaseContainerValidationConfig { 29 | 30 | @Singular 31 | Collection< 32 | TypedPropertyGetter< 33 | ContainerRootLevelValidatableT, @Nullable Collection>> 34 | withBatchMembers; 35 | 36 | ContainerValidationConfig withScopeOf1LevelDeep; 37 | 38 | public Set getFieldNamesForBatchLevel1( 39 | Class validatableClazz) { 40 | return ContainerValidationConfigEx.getFieldNamesForBatchLevel1Ex(this, validatableClazz); 41 | } 42 | 43 | public Set getFieldNamesForBatchRootLevel( 44 | Class validatableClazz) { 45 | return ContainerValidationConfigEx.getFieldNamesForBatchEx(this, validatableClazz); 46 | } 47 | } 48 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/execution/Vador.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("Vador") 9 | 10 | package com.salesforce.vador.execution 11 | 12 | import com.salesforce.vador.config.ValidationConfig 13 | import com.salesforce.vador.config.container.ContainerValidationConfig 14 | import com.salesforce.vador.config.container.ContainerValidationConfigWith2Levels 15 | import com.salesforce.vador.execution.strategies.accumulationStrategy 16 | import com.salesforce.vador.execution.strategies.failFast 17 | import com.salesforce.vador.execution.strategies.failFastForContainer 18 | import com.salesforce.vador.lift.liftAllToEtr 19 | import com.salesforce.vador.types.Validator 20 | import com.salesforce.vador.types.ValidatorEtr 21 | import java.util.Optional 22 | 23 | object Vador { 24 | /** <--- CONTAINER --- */ 25 | @JvmStatic 26 | @JvmOverloads 27 | fun validateAndFailFastForContainer( 28 | container: ContainerValidatableT, 29 | containerValidationConfig: ContainerValidationConfig, 30 | throwableMapper: (Throwable) -> FailureT? = { throw it }, 31 | ): Optional = 32 | failFastForContainer(containerValidationConfig, throwableMapper)(container) 33 | 34 | @JvmStatic 35 | @JvmOverloads 36 | fun < 37 | FailureT : Any, 38 | ContainerValidatableT, 39 | NestedContainerValidatableT, 40 | > validateAndFailFastForContainer( 41 | container: ContainerValidatableT, 42 | containerValidationConfigWith2Levels: 43 | ContainerValidationConfigWith2Levels< 44 | ContainerValidatableT, 45 | NestedContainerValidatableT, 46 | FailureT?, 47 | >, 48 | throwableMapper: (Throwable) -> FailureT? = { throw it }, 49 | ): Optional = 50 | failFastForContainer(containerValidationConfigWith2Levels, throwableMapper)(container) 51 | 52 | /** --- CONTAINER ---> */ 53 | @JvmStatic 54 | @JvmOverloads 55 | fun validateAndFailFast( 56 | validatable: ValidatableT, 57 | validationConfig: ValidationConfig, 58 | throwableMapper: (Throwable) -> FailureT? = { throw it }, 59 | ): Optional = failFast(validationConfig, throwableMapper)(validatable) 60 | 61 | // --- ERROR ACCUMULATION --- 62 | /** 63 | * Applies the Simple validators on a Single validatable in error-accumulation mode. 64 | * 65 | * @param validatable 66 | * @param validators 67 | * @param none Value to be returned in case of no failures. 68 | * @param 69 | * @param 70 | * @return List of Validation failures. 71 | */ 72 | @JvmStatic 73 | @JvmOverloads 74 | fun validateAndAccumulateErrors( 75 | validatable: ValidatableT, 76 | validators: Collection>, 77 | none: FailureT, 78 | throwableMapper: (Throwable) -> FailureT? = { throw it }, 79 | ): List = 80 | validateAndAccumulateErrors(validatable, liftAllToEtr(validators, none), none, throwableMapper) 81 | 82 | /** 83 | * Applies the validators on a Single validatable in error-accumulation mode. The Accumulated 84 | * 85 | * @param validatable 86 | * @param validators 87 | * @param none Value to be returned in case of no failures. 88 | * @param 89 | * @param 90 | * @param throwableMapper Function to map throwable to Failure in case of exception 91 | * @return List of Validation failures. EmptyList if all the validations pass. 92 | * 93 | */ 94 | @JvmStatic 95 | @JvmOverloads 96 | fun validateAndAccumulateErrors( 97 | validatable: ValidatableT, 98 | validators: List>, 99 | none: FailureT, 100 | throwableMapper: (Throwable) -> FailureT? = { throw it }, 101 | ): List { 102 | val results = 103 | accumulationStrategy(validators, throwableMapper)(validatable).map { result -> 104 | result.fold({ it }, { none }) 105 | } 106 | return if (results.all { it == none }) emptyList() else results 107 | } 108 | } 109 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/execution/strategies/AccumulationStrategies.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | package com.salesforce.vador.execution.strategies 9 | 10 | import com.salesforce.vador.execution.strategies.util.fireValidators 11 | import com.salesforce.vador.types.ValidatorEtr 12 | import io.vavr.control.Either 13 | import io.vavr.kotlin.right 14 | 15 | /** 16 | * Higher-order function to compose list of validators into Accumulation Strategy. 17 | * 18 | * @param validators 19 | * @param invalidValidatable 20 | * @param 21 | * @param 22 | * @return Composed Accumulation Strategy 23 | */ 24 | @JvmSynthetic 25 | internal fun accumulationStrategy( 26 | validators: List>, 27 | throwableMapper: (Throwable) -> FailureT?, 28 | ): Accumulation = { 29 | fireValidators(right(it), validators, throwableMapper).toList() 30 | } 31 | 32 | internal typealias Accumulation = 33 | (ValidatableT) -> List> 34 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/lift/AggregationLiftEtrUtil.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("AggregationLiftEtrUtil") 9 | 10 | package com.salesforce.vador.lift 11 | 12 | import com.salesforce.vador.types.ValidatorEtr 13 | 14 | /** 15 | * Lifts a member validation to container type. 16 | * 17 | * @param memberValidator 18 | * @param toMemberMapper Mapper function to extract member from container 19 | * @param nullContainer Failure to return if container is null 20 | * @param nullMember Failure to return if member is null 21 | * @param 22 | * @param 23 | * @param 24 | * @return container type validation 25 | */ 26 | fun liftToContainerValidatorType( 27 | memberValidator: ValidatorEtr, 28 | toMemberMapper: (ContainerT?) -> MemberT?, 29 | ): ValidatorEtr = ValidatorEtr { container -> 30 | val member = container?.map(toMemberMapper) 31 | memberValidator.unchecked().apply(member) 32 | } // This whole function is inside a CheckedFunction, so no problem with `uncChecked()` above 33 | 34 | /** 35 | * Lifts a list of member validations to container type. 36 | * 37 | * @param memberValidatorEtrs List of member validations 38 | * @param toChildMapper Mapper function to extract member from container 39 | * @param invalidParent Failure to return if container is null 40 | * @param invalidChild Failure to return if member is null 41 | * @param 42 | * @param 43 | * @param 44 | * @return List of container type validations 45 | */ 46 | fun liftAllToContainerValidatorType( 47 | memberValidatorEtrs: Collection>, 48 | toMemberMapper: (ContainerT?) -> MemberT?, 49 | ): List> = 50 | memberValidatorEtrs.map { liftToContainerValidatorType(it, toMemberMapper) } 51 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/lift/AggregationLiftUtil.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("AggregationLiftUtil") 9 | 10 | package com.salesforce.vador.lift 11 | 12 | import com.salesforce.vador.types.Validator 13 | 14 | /** 15 | * Lifts a simple member validation to container type. 16 | * 17 | * @param memberValidation Validation on the Member 18 | * @param toMemberMapper Mapper function to extract member from container 19 | * @param 20 | * @param 21 | * @param 22 | * @return Container type validation 23 | */ 24 | fun liftToContainerValidatorType( 25 | memberValidation: Validator, 26 | toMemberMapper: (ContainerT?) -> MemberT?, 27 | ): Validator = Validator { memberValidation.apply(toMemberMapper(it)) } 28 | 29 | /** 30 | * Lifts a list of simple member validations to container type. 31 | * 32 | * @param memberValidations List of member validations 33 | * @param toMemberMapper Mapper function to extract member from container 34 | * @param 35 | * @param 36 | * @param 37 | * @return List of container type validations 38 | */ 39 | fun liftAllToContainerValidatorType( 40 | memberValidations: Collection>, 41 | toMemberMapper: (ContainerT?) -> MemberT?, 42 | ): List> = 43 | memberValidations.map { liftToContainerValidatorType(it, toMemberMapper) } 44 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/lift/InheritanceLiftEtrUtil.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("InheritanceLiftEtrUtil") 9 | 10 | package com.salesforce.vador.lift 11 | 12 | import com.salesforce.vador.types.ValidatorEtr 13 | import io.vavr.control.Either.narrow 14 | 15 | /** 16 | * Assume `ParentT` is parent by inheritance to `ValidatableT`. To validate `ValidatableT`, all it's 17 | * validations + all its Parent validations has to pass. These utils help to lift it's parent's 18 | * validations in the context of ValidatableT, so that they can be chained together. 19 | */ 20 | fun liftToChildValidatorType( 21 | parentValidatorEtr: ValidatorEtr 22 | ): ValidatorEtr = ValidatorEtr { childValidatable -> 23 | parentValidatorEtr.apply(narrow(childValidatable)) 24 | } 25 | 26 | fun liftAllToChildValidatorType( 27 | parentValidatorEtrs: Collection> 28 | ): List> = 29 | parentValidatorEtrs.map { liftToChildValidatorType(it) } 30 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/lift/ValidatorLiftUtil.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("ValidatorLiftUtil") 9 | 10 | package com.salesforce.vador.lift 11 | 12 | import com.salesforce.vador.types.Validator 13 | import com.salesforce.vador.types.ValidatorEtr 14 | import io.vavr.kotlin.left 15 | 16 | /** 17 | * Lifts Simple Validator to Validator type. 18 | * 19 | * @param toBeLifted Simple validator to be lifted 20 | * @param none Value to be returned in case of no failures 21 | * @param 22 | * @param 23 | * @return Validator 24 | */ 25 | fun liftToEtr( 26 | toBeLifted: Validator, 27 | none: FailureT?, 28 | ): ValidatorEtr = ValidatorEtr { 29 | it.flatMap { validatable -> 30 | val result = toBeLifted.unchecked().apply(validatable) 31 | if (result == none) it else left(result) 32 | } 33 | } 34 | 35 | /** 36 | * Lifts a list of Simple validators to list of Validator type. 37 | * 38 | * @param toBeLiftedFns List of Simple functions to be lifted. 39 | * @param none Value to be returned in case of no failures. 40 | * @param 41 | * @param 42 | * @return List of Validators 43 | */ 44 | fun liftAllToEtr( 45 | toBeLiftedFns: Collection>, 46 | none: FailureT, 47 | ): List> = toBeLiftedFns.map { liftToEtr(it, none) } 48 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/specs/Destructures.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * **************************************************************************** 3 | * Copyright (c) 2022, salesforce.com, inc. All rights reserved. SPDX-License-Identifier: 4 | * BSD-3-Clause For full license text, see the LICENSE file in the repo root or 5 | * https://opensource.org/licenses/BSD-3-Clause 6 | * **************************************************************************** 7 | */ 8 | @file:JvmName("Destructures") 9 | 10 | package com.salesforce.vador.specs 11 | 12 | import io.vavr.Tuple2 13 | import io.vavr.Tuple3 14 | 15 | // ! TODO gopala.akshintala 13/04/22: Move to a common module 16 | operator fun Tuple2.component1(): T1 = this._1 17 | 18 | operator fun Tuple2<*, T2>.component2(): T2 = this._2 19 | 20 | operator fun Tuple3.component1(): T1 = this._1 21 | 22 | operator fun Tuple3<*, T2, *>.component2(): T2 = this._2 23 | 24 | operator fun Tuple3<*, *, T2>.component3(): T2 = this._3 25 | -------------------------------------------------------------------------------- /vador/src/main/java/com/salesforce/vador/specs/factory/SpecFactory.java: -------------------------------------------------------------------------------- 1 | /******************************************************************************* 2 | * Copyright (c) 2022, salesforce.com, inc. 3 | * All rights reserved. 4 | * SPDX-License-Identifier: BSD-3-Clause 5 | * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause 6 | ******************************************************************************/ 7 | 8 | package com.salesforce.vador.specs.factory; 9 | 10 | import com.salesforce.vador.specs.specs.Spec1; 11 | import com.salesforce.vador.specs.specs.Spec2; 12 | import com.salesforce.vador.specs.specs.Spec3; 13 | import com.salesforce.vador.specs.specs.Spec4; 14 | import com.salesforce.vador.specs.specs.Spec5; 15 | 16 | public final class SpecFactory { 17 | 18 | @SuppressWarnings({"java:S100", "java:S1452"}) 19 | public Spec1.Spec1Builder _1() { 20 | return Spec1.check(); 21 | } 22 | 23 | @SuppressWarnings({"java:S100", "java:S1452"}) 24 | public