org.apache.commons.lang3

Class NotImplementedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.UnsupportedOperationException

org.apache.commons.lang3.NotImplementedException

All Implemented Interfaces:

Serializable

public class NotImplementedException
extends UnsupportedOperationException

Thrown to indicate that a block of code has not been implemented. This exception supplements UnsupportedOperationException by providing a more semantically rich description of the problem.

NotImplementedException represents the case where the author has yet to implement the logic at this point in the program. This can act as an exception based TODO tag.

 public void foo() {
   try {
     // do something that throws an Exception
   } catch (Exception ex) {
     // don't know what to do here yet
     throw new NotImplementedException("TODO", ex);
   }
 }
 

This class was originally added in Lang 2.0, but removed in 3.0.

Since:

3.2

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
NotImplementedException(String message) Constructs a NotImplementedException.
NotImplementedException(String message, String code) Constructs a NotImplementedException.
NotImplementedException(String message, Throwable cause) Constructs a NotImplementedException.
NotImplementedException(String message, Throwable cause, String code) Constructs a NotImplementedException.
NotImplementedException(Throwable cause) Constructs a NotImplementedException.
NotImplementedException(Throwable cause, String code) Constructs a NotImplementedException.

Method Summary

Modifier and Type	Method and Description
String	getCode() Obtain the not implemented code.

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

NotImplementedException

public NotImplementedException(String message)

Constructs a NotImplementedException.

Parameters:

message - description of the exception

Since:

3.2

NotImplementedException

public NotImplementedException(Throwable cause)

Constructs a NotImplementedException.

Parameters:

cause - cause of the exception

Since:

3.2

NotImplementedException

public NotImplementedException(String message,
                               Throwable cause)

Constructs a NotImplementedException.

Parameters:

message - description of the exception

cause - cause of the exception

Since:

3.2

NotImplementedException

public NotImplementedException(String message,
                               String code)

Constructs a NotImplementedException.

Parameters:

message - description of the exception

code - code indicating a resource for more information regarding the lack of implementation

Since:

3.2

NotImplementedException

public NotImplementedException(Throwable cause,
                               String code)

Constructs a NotImplementedException.

Parameters:

cause - cause of the exception

code - code indicating a resource for more information regarding the lack of implementation

Since:

3.2

NotImplementedException

public NotImplementedException(String message,
                               Throwable cause,
                               String code)

Constructs a NotImplementedException.

Parameters:

message - description of the exception

cause - cause of the exception

code - code indicating a resource for more information regarding the lack of implementation

Since:

3.2

Method Detail

getCode

public String getCode()

Obtain the not implemented code. This is an unformatted piece of text intended to point to further information regarding the lack of implementation. It might, for example, be an issue tracker ID or a URL.

Returns:

a code indicating a resource for more information regarding the lack of implementation