Package org.instancio

Class Gen

java.lang.Object
org.instancio.Gen

@ExperimentalApi public final class Gen extends Object
Class for generating simple value types, such as strings, numbers, dates, and so on.

Examples:


   String s = Gen.string().length(10).digits().get();
   Integer i = Gen.ints().range(0, 100).get();
   List<LocalDate> dates = Gen.temporal().localDate().past().list(10);
 
Since:
2.6.0
  • Method Details

    • booleans

      public static BooleanSpec booleans()
      Generates Boolean values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • chars

      public static CharacterSpec chars()
      Generates Character values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • string

      public static StringSpec string()
      Generates String values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • bytes

      public static ByteSpec bytes()
      Generates Byte values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • shorts

      public static ShortSpec shorts()
      Generates Short values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • ints

      public static IntegerSpec ints()
      Generates Integer values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • intSeq

      @ExperimentalApi public static NumericSequenceSpec<Integer> intSeq()
      Generates Integer sequences.
      Returns:
      value spec builder
      Since:
      2.13.0
    • longs

      public static LongSpec longs()
      Generates Long values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • longSeq

      @ExperimentalApi public static NumericSequenceSpec<Long> longSeq()
      Generates Long sequences.
      Returns:
      value spec builder
      Since:
      2.13.0
    • floats

      public static FloatSpec floats()
      Generates Float values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • doubles

      public static DoubleSpec doubles()
      Generates Double values.
      Returns:
      value spec builder
      Since:
      2.6.0
    • enumOf

      public static <E extends Enum<E>> EnumSpec<E> enumOf(Class<E> enumClass)
      Generates enum values.
      Type Parameters:
      E - enum type
      Parameters:
      enumClass - the enum class
      Returns:
      value spec builder
      Since:
      2.12.0
    • oneOf

      @SafeVarargs public static <T> ValueSpec<T> oneOf(T... choices)
      Picks a random value from the given choices.
      Type Parameters:
      T - element type
      Parameters:
      choices - to choose from
      Returns:
      value spec builder
      Since:
      2.6.0
    • oneOf

      public static <T> ValueSpec<T> oneOf(Collection<T> choices)
      Picks a random value from the given choices.
      Type Parameters:
      T - element type
      Parameters:
      choices - to choose from
      Returns:
      value spec builder
      Since:
      2.6.0
    • io

      public static IoSpecs io()
      Provides generators for java.io classes.
      Returns:
      built-in generators for java.io classes.
      Since:
      2.6.0
    • math

      public static MathSpecs math()
      Provides generators for java.math classes.
      Returns:
      built-in generators for java.math classes.
      Since:
      2.6.0
    • net

      public static NetSpecs net()
      Provides generators for java.net classes.
      Returns:
      built-in generators for java.net classes.
      Since:
      2.6.0
    • nio

      public static NioSpecs nio()
      Provides generators for java.nio classes.
      Returns:
      built-in generators for java.nio classes.
      Since:
      2.6.0
    • temporal

      public static TemporalSpecs temporal()
      Provides generators for java.time classes.
      Returns:
      built-in generators for java.time classes.
      Since:
      2.6.0
    • text

      public static TextSpecs text()
      Provides text generators.
      Returns:
      built-in text generators
      Since:
      2.6.0
    • uuid

      public static UUIDSpec uuid()
      Generates UUID values.
      Returns:
      value spec builder
      Since:
      3.2.0
    • checksum

      public static ChecksumSpecs checksum()
      Provides generators for checksum-valid numbers.
      Returns:
      built-in checksum generators
      Since:
      2.16.0
    • id

      public static IdSpecs id()
      Provides identifier generators.
      Returns:
      built-in identifier generators
      Since:
      2.11.0
    • hash

      public static HashSpec hash()
      Generates various types of hashes.
      Returns:
      API builder reference
      Since:
      2.11.0
    • finance

      public static FinanceSpecs finance()
      Provides finance-related generators.
      Returns:
      built-in finance-related generators
      Since:
      2.11.0
    • spatial

      public static SpatialSpecs spatial()
      Provides spatial data related generators.
      Returns:
      built-in spatial data related generators
      Since:
      4.4.0