one.microstream.meta

Class NotImplementedYetError

java.lang.Object

java.lang.Throwable

java.lang.Error

one.microstream.meta.NotImplementedYetError

All Implemented Interfaces:

Serializable

public class NotImplementedYetError
extends Error

Error that indicates that a piece of code (e.g. a method declared by an interface) should be, but is not implemented yet.

This error has to be seen as a kind of "meta construct", because it should never appear or even be necessary to exist in completed programs. Nevertheless, a construct like that is needed (and badly missing in JDK), because software, even perfectly planned ones, are growing work pieces and as such need a way to indicate currently existing construction sites. Even if it's only for testing and not for employing unfinsihed work-in-process software.

The current strategies of IDEs (or their default templates), to just return 0 / false / null and add a TO DO marker is fine for the developer, but nothing than a serious, hardly runtime-traceable bug for testing / wip-software.
The missing indicator error is currently substituted by an UnsupportedOperationException, which is merely a workaround and abuse of an exception that is supposed to indicate something else (namely that the requested procedure is not supported in a completed software).
To resolve this workaround and do it properly, a not implemented exception has to exist.

Still, the goal of every (completed) software has to be to never use this class (which is kind of funny, of course).

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
NotImplementedYetError()
NotImplementedYetError(String message)
NotImplementedYetError(String message, Throwable cause)
NotImplementedYetError(Throwable cause)

Method Summary

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

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

Constructor Detail

NotImplementedYetError

public NotImplementedYetError()

NotImplementedYetError

public NotImplementedYetError(String message,
                              Throwable cause)

NotImplementedYetError

public NotImplementedYetError(String message)

NotImplementedYetError

public NotImplementedYetError(Throwable cause)