Package org.bct.api

Class PropertyExtractors.MapPropertyExtractor

java.lang.Object

org.bct.api.PropertyExtractors.ObjectPropertyExtractor

org.bct.api.PropertyExtractors.MapPropertyExtractor

All Implemented Interfaces:

PropertyExtractor

Enclosing class:

PropertyExtractors

public static class PropertyExtractors.MapPropertyExtractor
extends PropertyExtractors.ObjectPropertyExtractor

Property extractor for Map objects with direct key access and size property.

This extractor extends PropertyExtractors.ObjectPropertyExtractor to add special handling for Map objects. It provides direct key-based property access and a universal size property for Map objects.

Map-Specific Properties:

• Direct key access: Any property name that exists as a Map key
• Size property: "size" returns map.size()

Supported Types:

Works with any object implementing the Map interface:

• HashMap, LinkedHashMap: Standard Map implementations
• TreeMap, ConcurrentHashMap: Specialized Map implementations
• Properties: Java Properties objects
• Custom Maps: Any Map implementation

Examples:

// Direct key access map.get("name") // "name" property map.get("timeout") // "timeout" property props.getProperty("key") // "key" property // Size access map.size() // "size" property

Key Priority:

Map key access takes priority over JavaBean properties. If a Map contains a key with the same name as a property/method, the Map value is returned first.

Fallback: If the property is not found as a Map key and is not "size", delegates to PropertyExtractors.ObjectPropertyExtractor for standard property access.

Constructor Summary

Constructors

Constructor	Description
MapPropertyExtractor()

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

MapPropertyExtractor

public MapPropertyExtractor()

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