improved hz:map javadoc and handling for null keys and values