PropertyPathHelper

Class Overview

Helps producers determine if a property is $selected and/or $expanded.

Note on recursive extensions: The idea here is that when one has an object graph that is a tree of like nodes (such as a class hierarchy), it should be possible to specify a $expand that is applied recursively.

Two new custom options are proposed:

expandR and selectR

ABNF:

 expandRQueryOp = "expandR=" recursiveExpandClause *("," recursiveExpandClause)
 recursiveExpandClause = entityNavProperty "/" expandDepth
 expandDepth = integer

 selectRQueryOp = "selectR=" recursiveSelectClause *("," recursiveSelectClause)
 recursiveSelectClause = rSelectItem *("," recursiveSelectClause)
 rSelectItem = selectedNavProperty "/" rPropItem
 rPropItem = "*" / selectedProperty
 

expandDepth drives the number of traversal iterations. An expandDepth of 0 is unlimited. During query processing, the max expandDepth of all recursivExpandClauses is computed and drives processing.

example: expandR=SubTypes/0,Properties/1

This says that at each position in the object graph traversal during query we will expand the SubTypes navigation property. At the first level we will also expand the Properties navigation property

 selectR=SubTypes/Namespace,SubTypes/Type
 

This says that whenever we expand the SubTypes navigation property we will only include Namespace and Type properties.

Summary

[Expand] Inherited Methods
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)