ErrorMessages.java

// Copyright (c) FIRST and other WPILib contributors.
// Open Source Software; you can modify and/or share it under the terms of
// the WPILib BSD license file in the root directory of this project.
 
package org.wpilib.util;

public final class ErrorMessages {
  private ErrorMessages() {
    throw new UnsupportedOperationException("This is a utility class!");
  }

  @SuppressWarnings("PMD.AvoidThrowingNullPointerException")
  public static <T> T requireNonNullParam(T obj, String paramName, String methodName) {
    if (obj == null) {
      throw new NullPointerException(
          "Parameter "
              + paramName
              + " in method "
              + methodName
              + " was null when it should not have been!  Check the stacktrace to find the"
              + " responsible line of code - usually, it is the first line of user-written code"
              + " indicated in the stacktrace.  Make sure all objects passed to the method in"
              + " question were properly initialized - note that this may not be obvious if it"
              + " is being called under dynamically-changing conditions!  Please do not seek"
              + " additional technical assistance without doing this first!");
    }
    return obj;
  }
}