add methods for individual entity types, javadocs