[FLINK-1040] Make types() call in projections optional

This closes #194
[FLINK-1040] Updated JavaDocs and removed deprecated types() calls from examples and tests