Javadoc
PLT-361 - Toughen use of null

Do not accept null where not sensible
PLT-361 - Add nullability annotations