freenet.client

Class InsertException

java.lang.Object

java.lang.Throwable

java.lang.Exception

freenet.client.InsertException

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public class InsertException
extends java.lang.Exception
implements java.lang.Cloneable

Thrown when a high-level insert fails. For most failures, there will not be a stack trace, or it will be inaccurate.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InsertException.InsertExceptionMode

Field Summary

Fields

Modifier and Type	Field and Description
FailureCodeTracker	errorCodes Collect errors when there are multiple failures.
java.lang.String	extra Extra detail message
InsertException.InsertExceptionMode	mode Failure mode, see the constants below.
static int	UPPER_LIMIT_ERROR_CODE There will never be more error codes than this constant.
FreenetURI	uri If a non-serious error, the URI we expect the insert to go to if it had succeeded.

Constructor Summary

Constructors

Constructor and Description
InsertException(InsertException.InsertExceptionMode mode)
InsertException(InsertException.InsertExceptionMode mode, FailureCodeTracker errorCodes, FreenetURI expectedURI)
InsertException(InsertException.InsertExceptionMode m, FreenetURI expectedURI)
InsertException(InsertException.InsertExceptionMode mode, java.lang.String message, FailureCodeTracker errorCodes, FreenetURI expectedURI)
InsertException(InsertException.InsertExceptionMode m, java.lang.String msg, FreenetURI expectedURI)
InsertException(InsertException.InsertExceptionMode mode, java.lang.String message, java.lang.Throwable e, FreenetURI expectedURI)
InsertException(InsertException.InsertExceptionMode mode, java.lang.Throwable e, FreenetURI expectedURI)
InsertException(InsertException e)
InsertException(TooManyFilesInsertException e)

Method Summary

Modifier and Type	Method and Description
InsertException	clone()
static InsertException	construct(FailureCodeTracker errors) Construct an InsertException from a bunch of error codes, typically from a splitfile insert.
static InsertException	constructFrom(LowLevelPutException e)
static java.lang.String	getMessage(InsertException.InsertExceptionMode mode) Get the (localised) short name of this failure mode.
InsertException.InsertExceptionMode	getMode() Get the failure mode.
static java.lang.String	getShortMessage(InsertException.InsertExceptionMode mode) Get the (localised) long explanation for this failure mode.
boolean	isFatal() Is this error fatal? Non-fatal errors are errors which are likely to go away with more retries, or at least for which there is some point retrying.
static boolean	isFatal(InsertException.InsertExceptionMode mode)

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Field Detail

mode

public final InsertException.InsertExceptionMode mode

Failure mode, see the constants below.

errorCodes

public FailureCodeTracker errorCodes

Collect errors when there are multiple failures. The error mode will be FATAL_ERRORS_IN_BLOCKS or TOO_MANY_RETRIES_IN_BLOCKS i.e. a splitfile failed.

uri

public FreenetURI uri

If a non-serious error, the URI we expect the insert to go to if it had succeeded.

extra

public final java.lang.String extra

Extra detail message

UPPER_LIMIT_ERROR_CODE

public static final int UPPER_LIMIT_ERROR_CODE

There will never be more error codes than this constant. Must not change, used for some data structures.

See Also:

Constant Field Values

Constructor Detail

InsertException

public InsertException(InsertException.InsertExceptionMode m,
                       java.lang.String msg,
                       FreenetURI expectedURI)

InsertException

public InsertException(InsertException.InsertExceptionMode m,
                       FreenetURI expectedURI)

InsertException

public InsertException(InsertException.InsertExceptionMode mode,
                       java.lang.Throwable e,
                       FreenetURI expectedURI)

InsertException

public InsertException(InsertException.InsertExceptionMode mode,
                       java.lang.String message,
                       java.lang.Throwable e,
                       FreenetURI expectedURI)

InsertException

public InsertException(InsertException.InsertExceptionMode mode,
                       FailureCodeTracker errorCodes,
                       FreenetURI expectedURI)

InsertException

public InsertException(InsertException.InsertExceptionMode mode,
                       java.lang.String message,
                       FailureCodeTracker errorCodes,
                       FreenetURI expectedURI)

InsertException

public InsertException(InsertException.InsertExceptionMode mode)

InsertException

public InsertException(InsertException e)

InsertException

public InsertException(TooManyFilesInsertException e)

Method Detail

getMode

public InsertException.InsertExceptionMode getMode()

Get the failure mode.

constructFrom

public static InsertException constructFrom(LowLevelPutException e)

getMessage

public static java.lang.String getMessage(InsertException.InsertExceptionMode mode)

Get the (localised) short name of this failure mode.

getShortMessage

public static java.lang.String getShortMessage(InsertException.InsertExceptionMode mode)

Get the (localised) long explanation for this failure mode.

isFatal

public boolean isFatal()

Is this error fatal? Non-fatal errors are errors which are likely to go away with more retries, or at least for which there is some point retrying.

isFatal

public static boolean isFatal(InsertException.InsertExceptionMode mode)

construct

public static InsertException construct(FailureCodeTracker errors)

Construct an InsertException from a bunch of error codes, typically from a splitfile insert.

clone

public InsertException clone()

Overrides:

clone in class java.lang.Object