Returns a boolean indicating whether the authenticated user is included in the specified logical role. If the user has not been authenticated, the method returns false.

Parameters:

role

A String specifying the name of the role

Returns:  a boolean indicating whether the sender of the request belongs to a given role

Exceptions:

IllegalStateException

This exception is thrown if the method is called while no request is being serviced.