com.igormaznitsa.meta.common.utils.GetUtils Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jcp Show documentation
Powerful multi-pass preprocessor to process directives situated in C-styled commentaries
There is a newer version: 7.1.2
/*
 * Copyright 2015 Igor Maznitsa.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.igormaznitsa.meta.common.utils;

import static com.igormaznitsa.meta.common.utils.Assertions.assertFalse;
import static com.igormaznitsa.meta.common.utils.Assertions.assertNotNull;

import com.igormaznitsa.meta.annotation.Weight;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.ThreadSafe;

import com.igormaznitsa.meta.annotation.Constraint;

/**
 * Auxiliary methods to get values.
 *
 * @since 1.0
 */
@ThreadSafe
@Weight(Weight.Unit.LIGHT)
public final class GetUtils {

  private GetUtils () {
  }

  /**
   * Get value and ensure that the value is not null
   *
   * @param  type of value
   * @param value the value
   * @param defaultValue the default value to be returned if the value is null
   * @return not null value
   * @throws AssertionError if both the value and the default value are null
   * @since 1.0
   */
  @Nonnull
  public static  T ensureNonNull (@Nullable final T value, @Nonnull final T defaultValue) {
    return value == null ? Assertions.assertNotNull(defaultValue) : value;
  }

  /**
   * Get value if it is not null.
   *
   * @param  type of value
   * @param value the value
   * @return the value if it is not null
   * @throws AssertionError if the value is null
   * @since 1.0
   */
  @Nonnull
  public static  T ensureNonNull (@Nonnull final T value) {
    return Assertions.assertNotNull(value);
  }

  /**
   * Find the first non-null value in an array and return that.
   *
   * @param  type of value
   * @param objects array to find value
   * @throws AssertionError if the array is null or it doesn't contain a
   * non-null value
   * @return the first non-null value from the array
   * @since 1.0
   */
  @Nonnull
  public static  T findFirstNonNull (@Nonnull final T... objects) {
    for (final T obj : ensureNonNull(objects)) {
      if (obj != null) {
        return obj;
      }
    }
    throw Assertions.fail("Can't find non-null item in array");
  }
  
  /**
   * Get non-null non-empty string.
   * @param value a base string
   * @param dflt default string to be provided if value is null or empty
   * @return non-nullable non-empty string
   * @since 1.1.1
   */
  @Nonnull
  public static String ensureNonNullAndNonEmpty(@Nullable final String value, @Nonnull @Constraint("notEmpty(X)") final String dflt) {
    String result = value;
    if (result == null || result.isEmpty()) {
      assertFalse("Default value must not be empty",assertNotNull("Default value must not be null",dflt).isEmpty());
      result = dflt;
    }
    return result;
  }
  
  /**
   * Ensure that a string will not be null.
   * @param value value to be checked
   * @return the value if it is not null or empty string if the value is null
   * @since 1.1.1
   */
  @Nonnull
  public static String ensureNonNullStr(@Nullable final String value) {
    return value == null ? "" : value;
  }
}