introduced ShiroFacade; added PrincipalElementProcessor
added examples.html
adapted README.md