Property parser to make querying the properties easier

[andrewtarry]

In order to extract a series of nested properties, we need to create a complex series of calls. If we had a structure like this:

{
    "a": {
         "objectValue": {
             "stringValue": "value"
            } 
    }
}

In order to get the value we would need to do something like this

class Example {

    String getValue(PropertyHoldingEntity entity) {
        PropertyCollection propertyCollection = entity.getProperties();

        Optional<Property> subPropertyA = propertyCollection.getObjectByKey("a", Property.class);
        Optional<Property> valueA = subPropertyA.flatMap(p -> p.getObjectValue(Property.class));
        Optional<String> stringValue = valueA.flatMap(Property::getStringValue);
        
        return stringValue.orElse("");
    }
}

A better solution would be to allow json style path to be mapped to it.

public interface PropertyMapper {
    
    Optional<String> getStringValue(PropertyHoldingEntity entity, String path);
}

class Example {

    String getValue(PropertyHoldingEntity entity) {
        PropertyMapper propertyMapper = new PropertyMapper();

        return propertyMapper.getStringValue(entity, "a.object.string").orElse("");
    }
}