## org.apache.http.auth
Class AuthScope

    java.lang.Object
      org.apache.http.auth.AuthScope

    @Immutable
    public class AuthScope

extends Object

The class represents an authentication scope consisting of a host name, a port number, a realm name and an authentication scheme name which `Credentials` apply to.

Since:
  4.0

Field Summary
`static AuthScope` `ANY` Default scope matching any host, port, realm and authentication scheme.
`static String` `ANY_HOST` The `null` value represents any host.
`static int` `ANY_PORT` The `-1` value represents any port.
`static String` `ANY_REALM` The `null` value represents any realm.
`static String` `ANY_SCHEME` The `null` value represents any authentication scheme.

Constructor Summary
`AuthScope(AuthScope authscope)` Creates a copy of the given credentials scope.
`AuthScope(HttpHost host)`
`AuthScope(HttpHost host, String realm, String schemeName)`
`AuthScope(String host, int port)` Creates a new credentials scope for the given `host`, `port`, any realm name, and any authentication scheme.
`AuthScope(String host, int port, String realm)` Creates a new credentials scope for the given `host`, `port`, `realm`, and any authentication scheme.
`AuthScope(String host, int port, String realm, String scheme)` Creates a new credentials scope for the given `host`, `port`, `realm`, and `authentication scheme`.

Method Summary
`boolean` `equals(Object o)`
`String` `getHost()`
`int` `getPort()`
`String` `getRealm()`
`String` `getScheme()`
`int` `hashCode()`
`int` `match(AuthScope that)` Tests if the authentication scopes match.
`String` `toString()`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Field Detail

### ANY_HOST

    public static final String ANY_HOST

  The `null` value represents any host. In the future versions of HttpClient the use of this parameter will be discontinued.

### ANY_PORT

    public static final int ANY_PORT

  The `-1` value represents any port.

  See Also:
    Constant Field Values

### ANY_REALM

    public static final String ANY_REALM

  The `null` value represents any realm.

### ANY_SCHEME

    public static final String ANY_SCHEME

  The `null` value represents any authentication scheme.

### ANY

    public static final AuthScope ANY

  Default scope matching any host, port, realm and authentication scheme. In the future versions of HttpClient the use of this parameter will be discontinued.

Constructor Detail

### AuthScope

    public AuthScope(String host,
                     int port,
                     String realm,
                     String scheme)

  Creates a new credentials scope for the given `host`, `port`, `realm`, and `authentication scheme`.

  Parameters:
    `host` - the host the credentials apply to. May be set to `null` if credentials are applicable to any host.
    `port` - the port the credentials apply to. May be set to negative value if credentials are applicable to any port.
    `realm` - the realm the credentials apply to. May be set to `null` if credentials are applicable to any realm.
    `scheme` - the authentication scheme the credentials apply to. May be set to `null` if credentials are applicable to any authentication scheme.

### AuthScope

    public AuthScope(HttpHost host,
                     String realm,
                     String schemeName)

Since:
  4.2

### AuthScope

    public AuthScope(HttpHost host)

Since:
  4.2

### AuthScope

    public AuthScope(String host,
                     int port,
                     String realm)

  Creates a new credentials scope for the given `host`, `port`, `realm`, and any authentication scheme.

  Parameters:
    `host` - the host the credentials apply to. May be set to `null` if credentials are applicable to any host.
    `port` - the port the credentials apply to. May be set to negative value if credentials are applicable to any port.
    `realm` - the realm the credentials apply to. May be set to `null` if credentials are applicable to any realm.

### AuthScope

    public AuthScope(String host,
                     int port)

  Creates a new credentials scope for the given `host`, `port`, any realm name, and any authentication scheme.

  Parameters:
    `host` - the host the credentials apply to. May be set to `null` if credentials are applicable to any host.
    `port` - the port the credentials apply to. May be set to negative value if credentials are applicable to any port.

### AuthScope

    public AuthScope(AuthScope authscope)

  Creates a copy of the given credentials scope.

Method Detail

### getHost

    public String getHost()

  Returns:
    the host

### getPort

    public int getPort()

  Returns:
    the port

### getRealm

    public String getRealm()

  Returns:
    the realm name

### getScheme

    public String getScheme()

  Returns:
    the scheme type

### match

    public int match(AuthScope that)

  Tests if the authentication scopes match.

  Returns:
    the match factor. Negative value signifies no match. Non-negative signifies a match. The greater the returned value the closer the match.

### equals

    public boolean equals(Object o)

  Overrides:
    `equals` in class `Object`
  See Also:
    `Object.equals(Object)`

### toString

    public String toString()

  Overrides:
    `toString` in class `Object`
  See Also:
    `Object.toString()`

### hashCode

    public int hashCode()

  Overrides:
    `hashCode` in class `Object`
  See Also:
    `Object.hashCode()`

Copyright © 1999-2013 The Apache Software Foundation. All Rights Reserved.