Module jdk.httpserver
Package com.sun.net.httpserver

# Class HttpPrincipal

java.lang.Object
com.sun.net.httpserver.HttpPrincipal

All Implemented Interfaces:
  `Principal`

public class HttpPrincipal extends Object implements Principal
Represents a user authenticated by HTTP Basic or Digest authentication.

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `HttpPrincipal(String username, String realm)`
  Creates a `HttpPrincipal` from the given `username` and `realm`.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `boolean`
  `equals(Object another)`
  Compare two instances of `HttpPrincipal`.
  `String`
  `getName()`
  Returns the contents of this principal in the form realm:username.
  `String`
  `getRealm()`
  Returns the `realm` this object was created with.
  `String`
  `getUsername()`
  Returns the `username` this object was created with.
  `int`
  `hashCode()`
  Returns a hashcode for this `HttpPrincipal`.
  `String`
  `toString()`
  Returns the same string as `getName()`.

  ### Methods declared in class java.lang.Object

  `clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

  ### Methods declared in interface java.security.Principal

  `implies`

- ## Constructor Details

  - ### HttpPrincipal

    public HttpPrincipal(String username, String realm)
    Creates a `HttpPrincipal` from the given `username` and `realm`.
    Parameters:
      `username` - the name of the user within the realm
      `realm` - the realm for this user
    Throws:
      `NullPointerException` - if either username or realm are `null`

- ## Method Details

  - ### equals

    public boolean equals(Object another)
    Compare two instances of `HttpPrincipal`. Returns `true` if another is an instance of `HttpPrincipal`, and its username and realm are equal to this object's username and realm. Returns `false` otherwise.
    Specified by:
      `equals` in interface `Principal`
    Overrides:
      `equals` in class `Object`
    Parameters:
      `another` - the object to compare this instance of `HttpPrincipal` against
    Returns:
      `true` or `false` depending on whether objects are equal or not
    See Also:
      - `Object.hashCode()`
      - `HashMap`

  - ### getName

    public String getName()
    Returns the contents of this principal in the form realm:username.
    Specified by:
      `getName` in interface `Principal`
    Returns:
      the contents of this principal in the form realm:username

  - ### getUsername

    public String getUsername()
    Returns the `username` this object was created with.
    Returns:
      the name of the user associated with this object

  - ### getRealm

    public String getRealm()
    Returns the `realm` this object was created with.
    Returns:
      the realm associated with this object

  - ### hashCode

    public int hashCode()
    Returns a hashcode for this `HttpPrincipal`. This is calculated as `(getUsername()+getRealm()).hashCode()`.
    Specified by:
      `hashCode` in interface `Principal`
    Overrides:
      `hashCode` in class `Object`
    Returns:
      the hashcode for this object
    See Also:
      - `Object.equals(java.lang.Object)`
      - `System.identityHashCode(java.lang.Object)`

  - ### toString

    public String toString()
    Returns the same string as `getName()`.
    Specified by:
      `toString` in interface `Principal`
    Overrides:
      `toString` in class `Object`
    Returns:
      the name associated with this object