Package org.bct.api

Class PropertyExtractors.ListPropertyExtractor

java.lang.Object

org.bct.api.PropertyExtractors.ObjectPropertyExtractor

org.bct.api.PropertyExtractors.ListPropertyExtractor

All Implemented Interfaces:

PropertyExtractor

Enclosing class:

PropertyExtractors

public static class PropertyExtractors.ListPropertyExtractor
extends PropertyExtractors.ObjectPropertyExtractor

Property extractor for array and collection objects with numeric indexing and size access.

This extractor extends PropertyExtractors.ObjectPropertyExtractor to add special handling for collection-like objects. It provides array-style access using numeric indices and universal size/length properties for any listifiable object.

Additional Properties:

• Numeric indices: "0", "1", "2", etc. for element access
• Negative indices: "-1", "-2" for reverse indexing (from end)
• Size properties: "length" and "size" return collection size

Supported Types:

Works with any object that can be listified by the converter:

• Arrays: All array types (primitive and object)
• Collections: List, Set, Queue, and all Collection subtypes
• Iterables: Any object implementing Iterable
• Streams: Stream objects and other lazy sequences
• Maps: Converted to list of entries for iteration

Examples:

// Array/List access list.get(0) // "0" property array[2] // "2" property list.get(-1) // "-1" property (last element) // Size access array.length // "length" property collection.size() // "size" property stream.count() // "length" or "size" property

Fallback: If the property is not a numeric index or size property, delegates to PropertyExtractors.ObjectPropertyExtractor for standard property access.

Constructor Summary

Constructors

Constructor	Description
ListPropertyExtractor()

Method Summary

Modifier and Type	Method	Description
boolean	canExtract(BeanConverter converter, Object o, String name)	Determines if this extractor can handle property access for the given object and property name.
Object	extract(BeanConverter converter, Object o, String name)	Extracts the specified property value from the given object.

Methods inherited from class java.lang.Object

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

Constructor Details

ListPropertyExtractor

public ListPropertyExtractor()

Method Details

canExtract

public boolean canExtract(BeanConverter converter,
 Object o,
 String name)

Description copied from interface: PropertyExtractor

Determines if this extractor can handle property access for the given object and property name.

This method should perform a quick check to determine compatibility without doing expensive operations. It's called frequently during property navigation.

Specified by:

canExtract in interface PropertyExtractor

Overrides:

canExtract in class PropertyExtractors.ObjectPropertyExtractor

Parameters:

converter - The bean converter instance (for recursive operations if needed)

o - The object to extract the property from

name - The property name to extract

Returns:

true if this extractor can handle the property access, false otherwise

extract

public Object extract(BeanConverter converter,
 Object o,
 String name)

Description copied from interface: PropertyExtractor

Extracts the specified property value from the given object.

This method is only called after PropertyExtractor.canExtract(BeanConverter, Object, String) returns true. It should perform the actual property extraction and return the property value.

Specified by:

extract in interface PropertyExtractor

Overrides:

extract in class PropertyExtractors.ObjectPropertyExtractor

Parameters:

converter - The bean converter instance (for recursive operations if needed)

o - The object to extract the property from

name - The property name to extract

Returns:

The property value