Package org.instancio.internal.selectors

Class SelectorImpl

java.lang.Object

org.instancio.internal.selectors.SelectorImpl

All Implemented Interfaces:

GroupableSelector, Flattener, Selector, TargetSelector, ToScopeConvertible

public final class SelectorImpl
extends Object
implements Selector, GroupableSelector, Flattener

Constructor Summary

Constructors

Constructor	Description
SelectorImpl(SelectorTargetKind selectorTargetKind, Class<?> targetClass, String fieldName)
SelectorImpl(SelectorTargetKind selectorTargetKind, Class<?> targetClass, String fieldName, List<Scope> scopes, Selector parent)	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
List<SelectorImpl>	flatten()
String	getFieldName()
Selector	getParent()
List<Scope>	getScopes()
Class<?>	getTargetClass()
int	hashCode()
SelectorTargetKind	selectorType()
Scope	toScope()	Scope representation of a selector.
String	toString()
Selector	within(Scope... scopes)	Specifies the scope for this selector in order to narrow down the selector target.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

SelectorImpl

public SelectorImpl(SelectorTargetKind selectorTargetKind,
                    @Nullable
                    Class<?> targetClass,
                    @Nullable
                    String fieldName,
                    @Nullable
                    List<Scope> scopes,
                    @Nullable
                    Selector parent)

Constructor.

Parameters:

selectorTargetKind - selector target's kind

targetClass - target class

fieldName - field name, applicable to field selectors only

scopes - scopes specified top-down, from outermost to innermost

parent - required only for PrimitiveAndWrapperSelectorImpl for checking unused selectors

SelectorImpl

public SelectorImpl(SelectorTargetKind selectorTargetKind,
                    @Nullable
                    Class<?> targetClass,
                    @Nullable
                    String fieldName)

Method Detail

within

public Selector within(Scope... scopes)

Description copied from interface: Selector

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

For example, if the Person class has two Phone fields:

     class Person {
         private Phone home;
         private Phone cell;
         // snip...
     }
 

and we want to set only the cell phone to a specific value, we can narrow down the selector as follows:

     Person person = Instancio.of(Person.class)
         .set(field(Phone.class, "number").within(scope(Person.class, "cell")), "123-45-67")
         .create();
 

Multiple scopes can be specified top-down, that is starting from the outermost class.

Specified by:

within in interface Selector

Parameters:

scopes - one or more scopes to apply

Returns:

a selector with the specified scope

toScope

public Scope toScope()

Description copied from interface: ToScopeConvertible

Scope representation of a selector.

Specified by:

toScope in interface ToScopeConvertible

Returns:

scope

flatten

public List<SelectorImpl> flatten()

Specified by:

flatten in interface Flattener

getParent

public Selector getParent()

getScopes

public List<Scope> getScopes()

selectorType

public SelectorTargetKind selectorType()

getTargetClass

public Class<?> getTargetClass()

getFieldName

public String getFieldName()

equals

public boolean equals(Object o)

Performs equality check with all fields except parent.

Overrides:

equals in class Object

hashCode

public int hashCode()

Calculates hashcode using all fields except parent.

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object