Examples of org.apache.shiro.subject.Subject.runAs()

• org.apache.shiro.subject.Subject.runAs()
  Allows this subject to 'run as' or 'assume' another identity indefinitely. This can only be called when the {@code Subject} instance already has an identity (i.e. they are remembered from a previouslog-in or they have authenticated during their current session).

  Some notes about {@code runAs}:

  • You can tell if a {@code Subject} is 'running as' another identity by calling the{@link #isRunAs() isRunAs()} method.
  • If running as another identity, you can determine what the previous 'pre run as' identity was by calling the {@link #getPreviousPrincipals() getPreviousPrincipals()} method.
  • When you want a {@code Subject} to stop running as another identity, you can return to its previous'pre run as' identity by calling the {@link #releaseRunAs() releaseRunAs()} method.

  @param principals the identity to 'run as', aka the identity to assume indefinitely. @throws NullPointerException if the specified principals collection is {@code null} or empty. @throws IllegalStateException if this {@code Subject} does not yet have an identity of its own. @since 1.0