Fix broken unit tests

1) Define contract around DimExtractionFn and add class level javadoc
2) Adjust tests to show what the current state of the system is.
3) Also, rename "PartialDimExtractionFn" to "MatchingDimExtractionFn" because the name "Partial" confused cheddar, xvrl and fjy