Package org.instancio.internal.generator.array

Class OneOfArrayGenerator<T>

java.lang.Object
org.instancio.internal.generator.AbstractGenerator<T>
org.instancio.internal.generator.array.OneOfArrayGenerator<T>
All Implemented Interfaces:
Generator<T>, GeneratorSpec<T>, NullableGeneratorSpec<T>, OneOfArrayGeneratorSpec<T>, OneOfArraySpec<T>, ValueSpec<T>
public class OneOfArrayGenerator<T> extends AbstractGenerator<T> implements OneOfArraySpec<T>

  • Constructor Details

    • OneOfArrayGenerator

      public OneOfArrayGenerator()

    • OneOfArrayGenerator

      public OneOfArrayGenerator(GeneratorContext context)

  • Method Details

    • apiMethod

      public String apiMethod()
      Description copied from class: AbstractGenerator
      Returns the public API method name of the generator spec. The returned name is used for reporting validation errors.
      Specified by:
      apiMethod in class AbstractGenerator<T>
      Returns:
      spec name if defined, or null otherwise

    • oneOf

      public OneOfArrayGenerator<T> oneOf(T... values)
      Description copied from interface: OneOfArrayGeneratorSpec
      Selects a random value from the given choices.
      Specified by:
      oneOf in interface OneOfArrayGeneratorSpec<T>
      Specified by:
      oneOf in interface OneOfArraySpec<T>
      Parameters:
      values - from which a random value will be selected
      Returns:
      completed spec with no further methods

    • generate

      public T generate(Random random)
      Description copied from interface: Generator
      Returns a generated value.

      If this method produces random data, the data needs to be generated using the provided Random instance. This ensures generated values are reproducible for a given seed value.

      Specified by:
      generate in interface Generator<T>
      Parameters:
      random - provider for generating random values
      Returns:
      generated value or null if value is nullable, could not be generated, or generation is delegated to the engine

    • hints

      public Hints hints()
      Description copied from interface: Generator
      Hints provided by the generator to the engine.

      The most important hint for custom generators is AfterGenerate. This hint indicates whether the object created by this generator:

      • should be populated (for example, if it has null fields)
      • can be modified using selectors

      For example, setting the hint to AfterGenerate.POPULATE_NULLS will cause Instancio to populate null fields on the object returned by this generator: 

      
   @Override
   public Hints hints() {
       return Hints.afterGenerate(AfterGenerate.POPULATE_NULLS);
   }

      If the action is not specified, default behaviour will be based on the AfterGenerate value configured in the Settings using the key Keys.AFTER_GENERATE_HINT.

      In addition, the following hints can be provided for populating data structures:

      Specified by:
      hints in interface Generator<T>
      Overrides:
      hints in class AbstractGenerator<T>
      Returns:
      hints from this generator to the engine
      See Also: