complete javadoc in ResourceAdapter