/*
 * Copyright (c) 2013, 2019 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0, which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception, which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 */

package org.glassfish.jersey.message.internal;

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

import org.glassfish.jersey.internal.LocalizationMessages;

A "dev/null" output stream - an output stream implementation that discards all the data written to it. This implementation is not thread-safe. Note that once a null output stream instance is closed, any subsequent attempts to write the data to the closed stream result in an IOException being thrown.
Author:Miroslav Fuksa, Marek Potociar
/** * A {@code "dev/null"} output stream - an output stream implementation that discards all the * data written to it. This implementation is not thread-safe. * * Note that once a null output stream instance is {@link #close() closed}, any subsequent attempts * to write the data to the closed stream result in an {@link java.io.IOException} being thrown. * * @author Miroslav Fuksa * @author Marek Potociar */
public class NullOutputStream extends OutputStream { private boolean isClosed; @Override public void write(int b) throws IOException { checkClosed(); } @Override public void write(byte[] b, int off, int len) throws IOException { checkClosed(); if (b == null) { throw new NullPointerException(); } else if ((off < 0) || (off > b.length) || (len < 0) || ((off + len) > b.length) || ((off + len) < 0)) { throw new IndexOutOfBoundsException(); } } @Override public void flush() throws IOException { checkClosed(); } private void checkClosed() throws IOException { if (isClosed) { throw new IOException(LocalizationMessages.OUTPUT_STREAM_CLOSED()); } } @Override public void close() throws IOException { isClosed = true; } }