restful: decorators test cases

• Adds test cases for restful decorators.

• Adds documentation on issues with decorators being called with both bound and unbound methods when used from Flask-Restful method_decorators attribute (bound) vs normally applied decorator (via @ on class method).

Signed-off-by: Lars Holm Nielsen <lars.holm.nielsen@cern.ch>