android.system

Class GaiException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

android.system.GaiException

All Implemented Interfaces:

Serializable

public final class GaiException
extends RuntimeException

An unchecked exception thrown when getaddrinfo or getnameinfo fails. This exception contains the native error value, should sophisticated callers need to adjust their behavior based on the exact failure.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
int	error The native error value, for comparison with the GAI_ constants in OsConstants.

Constructor Summary

Constructors

Constructor and Description
GaiException(String functionName, int error) Constructs an instance with the given function name and error value.
GaiException(String functionName, int error, Throwable cause) Constructs an instance with the given function name, error value, and cause.

Method Summary

Modifier and Type	Method and Description
String	getMessage() Converts the stashed function name and error value to a human-readable string.
UnknownHostException	rethrowAsUnknownHostException()
UnknownHostException	rethrowAsUnknownHostException(String detailMessage)

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

error

public final int error

The native error value, for comparison with the GAI_ constants in OsConstants.

Constructor Detail

GaiException

public GaiException(String functionName,
                    int error)

Constructs an instance with the given function name and error value.

GaiException

public GaiException(String functionName,
                    int error,
                    Throwable cause)

Constructs an instance with the given function name, error value, and cause.

Method Detail

getMessage

public String getMessage()

Converts the stashed function name and error value to a human-readable string. We do this here rather than in the constructor so that callers only pay for this if they need it.

Overrides:

getMessage in class Throwable

rethrowAsUnknownHostException

public UnknownHostException rethrowAsUnknownHostException(String detailMessage)
                                                   throws UnknownHostException

Throws:

UnknownHostException

rethrowAsUnknownHostException

public UnknownHostException rethrowAsUnknownHostException()
                                                   throws UnknownHostException

Throws:

UnknownHostException