PropertyPath.PathSegment


public class PropertyPath.PathSegment


A segment of a PropertyPath, which includes the name of the property and a 0-based index into this property.

If the property index is not set to NON_REPEATED_CARDINALITY, this represents a schema property with the "repeated" cardinality, or a path like "foo[1]". Otherwise, this represents a schema property that could have any cardinality, or a path like "foo".

Summary

Constants

static final int

A marker variable to signify that a PathSegment represents a schema property that isn't indexed into.

Public methods

static @NonNull PropertyPath.PathSegment
create(@NonNull String propertyName)

Creation method that accepts and validates a property name

static @NonNull PropertyPath.PathSegment
create(@NonNull String propertyName, int propertyIndex)

Creation method that accepts and validates both a property name and the index into the property.

boolean
int

Returns the index into the property, or NON_REPEATED_CARDINALITY if this does not represent a PathSegment with an index.

@NonNull String

Returns the name of the property.

int
@NonNull String

Returns a path representing a PathSegment, either "foo" or "foo[1]"

Constants

NON_REPEATED_CARDINALITY

Added in 1.1.0-alpha07
public static final int NON_REPEATED_CARDINALITY = -1

A marker variable to signify that a PathSegment represents a schema property that isn't indexed into. The value is chosen to be invalid if used as an array index.

Public methods

create

Added in 1.1.0-alpha07
public static @NonNull PropertyPath.PathSegment create(@NonNull String propertyName)

Creation method that accepts and validates a property name

The property index is set to NON_REPEATED_CARDINALITY

Parameters
@NonNull String propertyName

the name of the property

Returns
@NonNull PropertyPath.PathSegment

A new PathSegment

create

Added in 1.1.0-alpha07
public static @NonNull PropertyPath.PathSegment create(@NonNull String propertyName, int propertyIndex)

Creation method that accepts and validates both a property name and the index into the property.

The property name may not be blank. It also may not contain square brackets or dots, as they are control characters in property paths. The index into the property may not be negative, unless it is NON_REPEATED_CARDINALITY, as these are invalid array indices.

Parameters
@NonNull String propertyName

the name of the property

int propertyIndex

the index into the property

Returns
@NonNull PropertyPath.PathSegment

A new PathSegment

Throws
java.lang.IllegalArgumentException

if the property name or index is invalid.

equals

public boolean equals(@Nullable Object o)

getPropertyIndex

Added in 1.1.0-alpha07
public int getPropertyIndex()

Returns the index into the property, or NON_REPEATED_CARDINALITY if this does not represent a PathSegment with an index.

getPropertyName

Added in 1.1.0-alpha07
public @NonNull String getPropertyName()

Returns the name of the property.

hashCode

public int hashCode()

toString

public @NonNull String toString()

Returns a path representing a PathSegment, either "foo" or "foo[1]"