Class PeerIdentity


  • public abstract class PeerIdentity
    extends Object
    A peer's authenticated identity.
    Author:
    David M. Lloyd
    • Constructor Detail

      • PeerIdentity

        protected PeerIdentity​(PeerIdentity.Configuration configuration,
                               Principal peerPrincipal)
        Construct a new instance.
        Parameters:
        configuration - the opaque configuration (must not be null)
        peerPrincipal - the peer principal (must not be null)
    • Method Detail

      • preAssociate

        protected void preAssociate()
        Perform an optional pre-association action, called before association with the current thread.
      • postAssociate

        protected void postAssociate()
        Perform an optional post-association action, called after association with the current thread has completed.
      • isSamePeerIdentityContext

        public boolean isSamePeerIdentityContext​(PeerIdentity other)
        Determine if the peer identity context of this identity is the same as that of the given identity.
        Parameters:
        other - the other peer identity
        Returns:
        true if the identities share a context, false otherwise
      • runAs

        public void runAs​(Runnable runnable)
        Run an action under this identity.
        Parameters:
        runnable - the action to run
      • runAs

        public <T> T runAs​(Callable<T> callable)
                    throws Exception
        Run an action under this identity.
        Type Parameters:
        T - the action return type
        Parameters:
        callable - the action to run
        Returns:
        the action result (may be null)
        Throws:
        PrivilegedActionException - if the action fails
        Exception
      • runAs

        public <T> T runAs​(PrivilegedAction<T> action)
        Run an action under this identity.
        Type Parameters:
        T - the action return type
        Parameters:
        action - the action to run
        Returns:
        the action result (may be null)
      • runAs

        public <T,​P> T runAs​(P parameter,
                                   ParametricPrivilegedAction<T,​P> action)
        Run an action under this identity.
        Type Parameters:
        T - the action return type
        P - the action parameter type
        Parameters:
        parameter - the parameter to pass to the action
        action - the action to run
        Returns:
        the action result (may be null)
      • runAs

        public <T,​P> T runAs​(P parameter,
                                   ParametricPrivilegedExceptionAction<T,​P> action)
                            throws PrivilegedActionException
        Run an action under this identity.
        Type Parameters:
        T - the action return type
        P - the action parameter type
        Parameters:
        parameter - the parameter to pass to the action
        action - the action to run
        Returns:
        the action result (may be null)
        Throws:
        PrivilegedActionException - if the action fails
      • runAsFunction

        public <T,​R> R runAsFunction​(T parameter,
                                           Function<T,​R> action)
        Run an action under this identity.
        Type Parameters:
        T - the action parameter type
        R - the action return type
        Parameters:
        parameter - the parameter to pass to the action
        action - the action to run
        Returns:
        the action result (may be null)
      • runAsFunction

        public <T,​U,​R> R runAsFunction​(T parameter1,
                                                   U parameter2,
                                                   BiFunction<T,​U,​R> action)
        Run an action under this identity.
        Type Parameters:
        T - the action first parameter type
        U - the action second parameter type
        R - the action return type
        Parameters:
        parameter1 - the first parameter to pass to the action
        parameter2 - the second parameter to pass to the action
        action - the action to run
        Returns:
        the action result (may be null)
      • runAsConsumer

        public <T> void runAsConsumer​(T parameter,
                                      Consumer<T> action)
        Run an action under this identity.
        Type Parameters:
        T - the action parameter type
        Parameters:
        parameter - the parameter to pass to the action
        action - the action to run
      • runAsConsumer

        public <T,​U> void runAsConsumer​(T parameter1,
                                              U parameter2,
                                              BiConsumer<T,​U> action)
        Run an action under this identity.
        Type Parameters:
        T - the action first parameter type
        U - the action second parameter type
        Parameters:
        parameter1 - the first parameter to pass to the action
        parameter2 - the second parameter to pass to the action
        action - the action to run
      • runAsSupplier

        public <T> T runAsSupplier​(Supplier<T> supplier)
                            throws Exception
        Run an action under this identity.
        Type Parameters:
        T - the action return type
        Parameters:
        supplier - the action to run
        Returns:
        the action result (may be null)
        Throws:
        PrivilegedActionException - if the action fails
        Exception
      • runAsAll

        public static void runAsAll​(Runnable runnable,
                                    PeerIdentity... identities)
        Run an action under a series of identities.
        Parameters:
        runnable - the action to run
        identities - the identities to use
      • runAsAll

        public static <T> T runAsAll​(Callable<T> callable,
                                     PeerIdentity... identities)
                              throws Exception
        Run an action under a series of identities.
        Type Parameters:
        T - the action return type
        Parameters:
        callable - the action to run
        identities - the identities to use
        Throws:
        Exception
      • runAsAll

        public static <T> T runAsAll​(PrivilegedAction<T> privilegedAction,
                                     PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        T - the action return type
        Parameters:
        privilegedAction - the action to run
        identities - the identities to use
      • runAsAll

        public static <T,​P> T runAsAll​(P parameter,
                                             ParametricPrivilegedAction<T,​P> privilegedAction,
                                             PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        T - the action return type
        P - the action parameter type
        Parameters:
        parameter - the parameter to pass to the action
        privilegedAction - the action to run
        identities - the identities to use
      • runAsAll

        public static <T,​P> T runAsAll​(P parameter,
                                             ParametricPrivilegedExceptionAction<T,​P> privilegedAction,
                                             PeerIdentity... identities)
                                      throws PrivilegedActionException
        Run an action under a series of identities.
        Type Parameters:
        T - the action return type
        P - the action parameter type
        Parameters:
        parameter - the parameter to pass to the action
        privilegedAction - the action to run
        identities - the identities to use
        Throws:
        PrivilegedActionException - if the action throws an exception
      • runAsAllFunction

        public static <R,​T> R runAsAllFunction​(T parameter,
                                                     Function<T,​R> privilegedAction,
                                                     PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        R - the action return type
        T - the action parameter type
        Parameters:
        parameter - the parameter to pass to the action
        privilegedAction - the action to run
        identities - the identities to use
      • runAsAllFunction

        public static <T,​U,​R> R runAsAllFunction​(T parameter1,
                                                             U parameter2,
                                                             BiFunction<T,​U,​R> privilegedAction,
                                                             PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        T - the action first parameter type
        U - the action second parameter type
        R - the action return type
        Parameters:
        parameter1 - the first parameter to pass to the action
        parameter2 - the second parameter to pass to the action
        privilegedAction - the action to run
        identities - the identities to use
      • runAsAllConsumer

        public static <T> void runAsAllConsumer​(T parameter,
                                                Consumer<T> privilegedAction,
                                                PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        T - the action parameter type
        Parameters:
        parameter - the parameter to pass to the action
        privilegedAction - the action to run
        identities - the identities to use
      • runAsAllConsumer

        public static <T,​U> void runAsAllConsumer​(T parameter1,
                                                        U parameter2,
                                                        BiConsumer<T,​U> privilegedAction,
                                                        PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        T - the action first parameter type
        U - the action second parameter type
        Parameters:
        parameter1 - the first parameter to pass to the action
        parameter2 - the second parameter to pass to the action
        privilegedAction - the action to run
        identities - the identities to use
      • runAsAllObjIntConsumer

        public static <T> void runAsAllObjIntConsumer​(T parameter1,
                                                      int parameter2,
                                                      ObjIntConsumer<T> privilegedAction,
                                                      PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        T - the action first parameter type
        Parameters:
        parameter1 - the first parameter to pass to the action
        parameter2 - the second parameter to pass to the action
        privilegedAction - the action to run
        identities - the identities to use
      • runAsAllSupplier

        public static <T> T runAsAllSupplier​(Supplier<T> action,
                                             PeerIdentity... identities)
        Run an action under a series of identities.
        Type Parameters:
        T - the action return type
        Parameters:
        action - the action to run
        identities - the identities to use
      • getPeerPrincipal

        public Principal getPeerPrincipal()
        Get the peer principal.
        Returns:
        the peer principal (not null)
      • getPeerRoles

        public Set<String> getPeerRoles()
        Get the peer identity roles. The default implementation returns an empty set.
        Returns:
        the peer identity role set (not null)
      • hasPeerRole

        public boolean hasPeerRole​(String roleName)
        Determine whether the peer identity has a given role name. The default implementation returns false.
        Parameters:
        roleName - the role name
        Returns:
        true if the peer identity has the role, false otherwise
      • getPeerAttributes

        public Attributes getPeerAttributes()
        Get the attribute set for the peer identity. The default implementation returns an empty attributes set.
        Returns:
        the peer identity attributes
      • getPeerAttribute

        public Attributes.Entry getPeerAttribute​(String key)
        Get a specific attribute value for the peer identity. The default implementation returns null.
        Parameters:
        key - the attribute name
        Returns:
        the attribute value entry, or null if there is no matching entry
      • getPeerIdentityContext

        protected final PeerIdentityContext getPeerIdentityContext()
        Get the peer identity context for this identity.
        Returns:
        the peer identity context for this identity (not null)