DisabledOutputStream.java

/*
 * Copyright (C) 2009-2010, Google Inc. and others
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Distribution License v. 1.0 which is available at
 * https://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

package org.eclipse.jgit.util.io;

import java.io.IOException;
import java.io.OutputStream;

import org.eclipse.jgit.internal.JGitText;

/**
 * An OutputStream which always throws IllegalStateExeption during write.
 */
public final class DisabledOutputStream extends OutputStream {
	/** The canonical instance which always throws IllegalStateException. */
	public static final DisabledOutputStream INSTANCE = new DisabledOutputStream();

	private DisabledOutputStream() {
		// Do nothing, but we want to hide our constructor to prevent
		// more than one instance from being created.
	}

	/** {@inheritDoc} */
	@Override
	public void write(int b) throws IOException {
		// We shouldn't be writing output at this stage, there
		// is nobody listening to us.
		//
		throw new IllegalStateException(JGitText.get().writingNotPermitted);
	}
}