Added javadoc to Query and EntityQuery making the contract of refresh explicit. View the original post : http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4089741#4089741 Reply to the post : http://www.jboss.com/index.html?module=bb&op=posting&mode=reply&p=4089741