Package org.instancio.internal.generator.io

Class FileGenerator

java.lang.Object

org.instancio.internal.generator.AbstractGenerator<File>

org.instancio.internal.generator.io.FileGenerator

All Implemented Interfaces:

AsStringGeneratorSpec<File>, Generator<File>, GeneratorSpec<File>, AsGeneratorSpec<File>, FilePathSpec<File>, FileSpec, NullableGeneratorSpec<File>, PathAsGeneratorSpec<File>, PathGeneratorSpec<File>, ValueSpec<File>

public class FileGenerator
extends AbstractGenerator<File>
implements FileSpec, PathAsGeneratorSpec<File>

Constructor Summary

Constructors

Constructor	Description
FileGenerator()
FileGenerator(GeneratorContext context)
FileGenerator(GeneratorContext context, String... directories)

Method Summary

Modifier and Type	Method	Description
String	apiMethod()	Returns the public API method name of the generator spec.
FileGenerator	createDirectory()	Terminal method to indicate that the generated path, including parent directories (if any), should be created as a directory in the file system.
FileGenerator	createFile()	Terminal method to indicate that the generated path, including parent directories (if any), should be created as a file in the file system.
FileGenerator	createFile(InputStream content)	Terminal method to indicate that the generated path, including parent directories (if any), should be created as a file in the file system and content provided by the input stream written to the file.
FileGenerator	name(Generator<String> nameGenerator)	Generator for the file or directory name.
FileGenerator	nullable()	Indicates that null value can be generated.
FileGenerator	prefix(String prefix)	File or directory name prefix.
FileGenerator	suffix(String suffix)	File or directory name suffix.
FileGenerator	tmp()	Generate path with java.io.tmpdir as the parent directory.
protected File	tryGenerateNonNull(Random random)	Makes the best effort to return a non-null value.

Methods inherited from class org.instancio.internal.generator.AbstractGenerator

generate, getContext, hints, isNullable, nullable

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.instancio.generator.specs.AsGeneratorSpec

as, asString

Methods inherited from interface org.instancio.generator.AsStringGeneratorSpec

asString

Methods inherited from interface org.instancio.generator.Generator

init

Methods inherited from interface org.instancio.generator.ValueSpec

get, list, map, stream, toModel

Constructor Details

FileGenerator

public FileGenerator()

FileGenerator

public FileGenerator(GeneratorContext context)

FileGenerator

public FileGenerator(GeneratorContext context,
 String... directories)

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<File>

Returns:

spec name if defined, or null otherwise

tmp

public FileGenerator tmp()

Description copied from interface: PathGeneratorSpec

Generate path with java.io.tmpdir as the parent directory.

Specified by:

tmp in interface FilePathSpec<File>

Specified by:

tmp in interface FileSpec

Specified by:

tmp in interface PathAsGeneratorSpec<File>

Specified by:

tmp in interface PathGeneratorSpec<File>

Returns:

spec builder

prefix

public FileGenerator prefix(String prefix)

Description copied from interface: PathGeneratorSpec

File or directory name prefix. No prefix is added by default.

Specified by:

prefix in interface FilePathSpec<File>

Specified by:

prefix in interface FileSpec

Specified by:

prefix in interface PathAsGeneratorSpec<File>

Specified by:

prefix in interface PathGeneratorSpec<File>

Parameters:

prefix - to add to the file or directory name

Returns:

spec builder

suffix

public FileGenerator suffix(String suffix)

Description copied from interface: PathGeneratorSpec

File or directory name suffix. No suffix is added by default.

Specified by:

suffix in interface FilePathSpec<File>

Specified by:

suffix in interface FileSpec

Specified by:

suffix in interface PathAsGeneratorSpec<File>

Specified by:

suffix in interface PathGeneratorSpec<File>

Parameters:

suffix - to add to the file or directory name

Returns:

spec builder

name

public FileGenerator name(Generator<String> nameGenerator)

Description copied from interface: PathGeneratorSpec

Generator for the file or directory name.

Generated path names are formed using the following elements:

     [prefix][name][suffix]
 

• Prefix and suffix are optional and are null by default.
• If no generator is supplied using this method, a random 16-character lowercase name will be generated.
• The concatenation of prefix, name, and suffix must not be blank.

Example:

 List<Path> paths = Instancio.ofList(Path.class)
         .generate(all(Path.class), gen -> gen.nio().path()
                 .prefix("queued_")
                 .name(random -> random.alphanumeric(8))
                 .suffix(".csv"))
         .create();

 // Sample paths: queued_t5LG4AUw.csv, queued_o0nBWkej.csv, etc
 

Specified by:

name in interface FilePathSpec<File>

Specified by:

name in interface FileSpec

Specified by:

name in interface PathAsGeneratorSpec<File>

Specified by:

name in interface PathGeneratorSpec<File>

Parameters:

nameGenerator - for generating the name

Returns:

spec builder

createFile

public FileGenerator createFile(InputStream content)

Description copied from interface: PathGeneratorSpec

Terminal method to indicate that the generated path, including parent directories (if any), should be created as a file in the file system and content provided by the input stream written to the file.

If the file already exists, then no action will be taken.

Specified by:

createFile in interface FilePathSpec<File>

Specified by:

createFile in interface FileSpec

Specified by:

createFile in interface PathAsGeneratorSpec<File>

Specified by:

createFile in interface PathGeneratorSpec<File>

Parameters:

content - to write to the file

Returns:

completed spec with no further methods

See Also:

• PathGeneratorSpec.createFile()
• PathGeneratorSpec.createDirectory()

createFile

public FileGenerator createFile()

Description copied from interface: PathGeneratorSpec

Terminal method to indicate that the generated path, including parent directories (if any), should be created as a file in the file system.

If the file already exists, then no action will be taken.

Specified by:

createFile in interface FilePathSpec<File>

Specified by:

createFile in interface FileSpec

Specified by:

createFile in interface PathAsGeneratorSpec<File>

Specified by:

createFile in interface PathGeneratorSpec<File>

Returns:

completed spec with no further methods

See Also:

• PathGeneratorSpec.createFile(InputStream)
• PathGeneratorSpec.createDirectory()

createDirectory

public FileGenerator createDirectory()

Description copied from interface: PathGeneratorSpec

Terminal method to indicate that the generated path, including parent directories (if any), should be created as a directory in the file system.

If the directory already exists, then no action will be taken.

Specified by:

createDirectory in interface FilePathSpec<File>

Specified by:

createDirectory in interface FileSpec

Specified by:

createDirectory in interface PathAsGeneratorSpec<File>

Specified by:

createDirectory in interface PathGeneratorSpec<File>

Returns:

completed spec with no further methods

See Also:

• PathGeneratorSpec.createFile()
• PathGeneratorSpec.createFile(InputStream)

nullable

public FileGenerator nullable()

Description copied from interface: NullableGeneratorSpec

Indicates that null value can be generated.

Specified by:

nullable in interface NullableGeneratorSpec<File>

Specified by:

nullable in interface ValueSpec<File>

Overrides:

nullable in class AbstractGenerator<File>

Returns:

spec builder

tryGenerateNonNull

protected File tryGenerateNonNull(Random random)

Description copied from class: AbstractGenerator

Makes the best effort to return a non-null value. However, in certain cases this method will produce a null.

Specified by:

tryGenerateNonNull in class AbstractGenerator<File>

Parameters:

random - for generating the value

Returns:

generated value, either a null or non-null