Package org.instancio.generator.specs

Interface PathSpec

All Superinterfaces:

AsGeneratorSpec<Path>, FilePathSpec<Path>, GeneratorSpec<Path>, PathGeneratorSpec<Path>, Supplier<Path>, ValueSpec<Path>

public interface PathSpec
extends FilePathSpec<Path>

Spec for generating Path values.

Since:

2.6.0

Method Summary

Modifier and Type	Method	Description
ValueSpec<Path>	createDirectory()	Terminal method to indicate that the generated path, including parent directories (if any), should be created as a directory in the file system.
ValueSpec<Path>	createFile()	Terminal method to indicate that the generated path, including parent directories (if any), should be created as a file in the file system.
ValueSpec<Path>	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.
PathSpec	name(Generator<String> nameGenerator)	Generator for the file or directory name.
PathSpec	prefix(String prefix)	File or directory name prefix.
PathSpec	suffix(String suffix)	File or directory name suffix.
PathSpec	tmp()	Generate path with java.io.tmpdir as the parent directory.

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

as, asString

Methods inherited from interface org.instancio.generator.ValueSpec

get, list, map, nullable, stream

Method Details

name

PathSpec 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<Path>

Specified by:

name in interface PathGeneratorSpec<Path>

Parameters:

nameGenerator - for generating the name

Returns:

spec builder

prefix

PathSpec 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<Path>

Specified by:

prefix in interface PathGeneratorSpec<Path>

Parameters:

prefix - to add to the file or directory name

Returns:

spec builder

suffix

PathSpec 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<Path>

Specified by:

suffix in interface PathGeneratorSpec<Path>

Parameters:

suffix - to add to the file or directory name

Returns:

spec builder

tmp

PathSpec tmp()

Description copied from interface: PathGeneratorSpec

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

Specified by:

tmp in interface FilePathSpec<Path>

Specified by:

tmp in interface PathGeneratorSpec<Path>

Returns:

spec builder

createDirectory

ValueSpec<Path> 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<Path>

Specified by:

createDirectory in interface PathGeneratorSpec<Path>

Returns:

completed spec with no further methods

See Also:

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

createFile

ValueSpec<Path> 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<Path>

Specified by:

createFile in interface PathGeneratorSpec<Path>

Returns:

completed spec with no further methods

See Also:

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

createFile

ValueSpec<Path> 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<Path>

Specified by:

createFile in interface PathGeneratorSpec<Path>

Parameters:

content - to write to the file

Returns:

completed spec with no further methods

See Also:

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