* governing permissions and limitations under the License.
 */
package org.codelibs.fess.util;

import org.dbflute.optional.OptionalEntity;

/**
 * Utility class for Optional operations.
 */
public class OptionalUtil {

    /**
     * Default constructor.
     */
    private OptionalUtil() {
        // Default constructor
    }

    /**

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.suggest.constants;

/**
 * This class contains constants used in the Fess Suggest module.
 * It is a utility class and should not be instantiated.
 */
public final class SuggestConstants {
    // Private constructor to prevent instantiation
    private SuggestConstants() {
    }

    /** An empty string constant. */

 * either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */
package org.codelibs.core.convert;

import java.math.BigInteger;

/**
 * Utility class for conversions related to {@link BigInteger}.
 *
 * @author higa
 */
public abstract class BigIntegerConversionUtil {

    /**
     * Do not instantiate.
     */

import org.apache.maven.execution.MavenSession;
import org.apache.maven.plugin.MojoExecution;

/**
 * Assists in firing execution events. <strong>Warning:</strong> This is an internal utility interface that is only
 * public for technical reasons, it is not part of the public API. In particular, this interface can be changed or
 * deleted without prior notice.
 *
 */
public interface ExecutionEventCatapult {

 * limitations under the License.
 */

package com.google.common.collect;

import java.util.Random;
import org.jspecify.annotations.NullUnmarked;

/**
 * Utility class for being able to seed a {@link Random} value with a passed in seed from a
 * benchmark parameter.
 *
 * <p>TODO: Remove this class once Caliper has a better way.
 *
 * @author Nicholaus Shupe
 */
@NullUnmarked

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;

import org.codelibs.core.exception.IORuntimeException;

/**
 * Utility class for {@link OutputStream} operations.
 *
 * @author shot
 */
public abstract class OutputStreamUtil {

    /**
     * Do not instantiate.
     */
    protected OutputStreamUtil() {
    }

        validationMessagesLambda.message(messages);
        sessionManager.errors().saveMessages(messages);
    }

    /**
     * Copies properties from source bean to destination bean.
     * This is a utility method that wraps BeanUtil.copyBeanToBean with custom options.
     *
     * @param src the source bean object
     * @param dest the destination bean object
     * @param option a consumer function to configure copy options

import java.io.IOException;
import java.net.JarURLConnection;
import java.util.jar.JarFile;

import org.codelibs.core.exception.IORuntimeException;

/**
 * Utility class for {@link JarURLConnection}.
 *
 * @author higa
 */
public abstract class JarURLConnectionUtil {

    /**
     * Do not instantiate.
     */
    protected JarURLConnectionUtil() {
    }

# ADR-0008 - Use NullAway for null checking

## Date

2025-08-06

## Context

Our codebase uses `null` extensively to represent an absence of value or optionality of the argument.
We utilize nullness annotations in Java code and somewhat rely on IDE warnings to guide us.
However, the Java code we have is not fully annotated, which causes several consequences:
* IDE warnings can be misleading

package com.google.common.testing;

import com.google.common.annotations.GwtCompatible;
import java.util.logging.Level;
import java.util.logging.Logger;
import org.jspecify.annotations.NullMarked;

/**
 * Simple utility for when you want to create a {@link TearDown} that may throw an exception but
 * should not fail a test when it does. (The behavior of a {@code TearDown} that throws an exception