Add javadocs and delete unused method.
Add exception for failed authentication, minor clean-up in picketlink auth service, and add destruction callbacks for page listeners.