improve - javadoc
improve - channel api

channel.write() declare IllegalChannelStateException