Package org.instancio

Interface Selector

All Superinterfaces:

ConvertibleToScope, DepthSelector, GroupableSelector, LenientSelector, ScopeableSelector, TargetSelector, WithinScope

public interface Selector
extends DepthSelector, ScopeableSelector

Represents regular field and class selectors, including primitive and wrapper selectors.

Since:

1.2.0

See Also:

• Select
• TargetSelector

Method Summary

Modifier and Type	Method	Description
ScopeableSelector	atDepth(int depth)	Restricts this selector's targets to the specified depth.
GroupableSelector	within(Scope... scopes)	Specifies the scope for this selector in order to narrow down its target.

Methods inherited from interface org.instancio.ConvertibleToScope

toScope

Methods inherited from interface org.instancio.ScopeableSelector

lenient

Method Details

atDepth

ScopeableSelector atDepth(int depth)

Restricts this selector's targets to the specified depth. The selector will only apply to targets at the specified depth.

When a selector with atDepth(N) is converted using toScope(), the semantics of the within(Scope...) method still apply, meaning that the selection applies to targets at depth equal to or greater than N.

The root object is considered to be at depth 0.

Specified by:

atDepth in interface DepthSelector

Parameters:

depth - the depth at which the selector should apply

Returns:

a selector restricted to the specified depth

Since:

3.0.0

See Also:

• DepthPredicateSelector

within

GroupableSelector within(Scope... scopes)

Specifies the scope for this selector in order to narrow down its target.

For example, given the following classes:

 record Phone(String countryCode, String number) {}

 record Person(Phone home, Phone cell) {}
 

setting home and cell phone numbers to different values would require differentiating between two field(Phone::number) selectors. This can be achieved using scopes as follows:

 Scope homePhone = field(Person::home).toScope();
 Scope cellPhone = field(Person::cell).toScope();

 Person person = Instancio.of(Person.class)
     .set(field(Phone::number).within(homePhone), "777-88-99")
     .set(field(Phone::number).within(cellPhone), "123-45-67")
     .create();
 

See Selector Scopes section of the user guide for details.

Specified by:

within in interface ScopeableSelector

Specified by:

within in interface WithinScope

Parameters:

scopes - one or more scopes to apply

Returns:

a selector with the specified scope

Since:

1.3.0