[#67] introduce filtered listener
[#67] fix filtered listener interaction problem and updated api doc