if nulls are permitted, then say so in the javadoc, otherwise checknotnull.