org.eurekastreams.commons.io.ResourceInputStream.java Source code

Introduction

Here is the source code for org.eurekastreams.commons.io.ResourceInputStream.java

Source

/*
 * Copyright (c) 2009-2010 Lockheed Martin Corporation
 *
 * 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 org.eurekastreams.commons.io;

import java.io.IOException;
import java.io.InputStream;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

/**
 * Parse a resource (packaged file) as an InputStream. The current class's class
 * loader is used to find the resource by name and wrap it as an InputStream.
 */
public class ResourceInputStream extends InputStream {
    /**
     * Logger.
     */
    private Log log = LogFactory.getLog(ResourceInputStream.class);

    /**
     * The name of the resource, kept for logging.
     */
    private String resourceName;

    /**
     * The wrapped copy of the resource InputStream.
     */
    private InputStream inputStream;

    /**
     * Constructor that takes the inputStream - useful for unit testing.
     *
     * @param theInputStream
     *            the InputStream to wrap
     */
    protected ResourceInputStream(final InputStream theInputStream) {
        inputStream = theInputStream;
    }

    /**
     * Constructor taking the resource name to load.
     *
     * @param theResourceName
     *            the resource name/path to load.
     */
    public ResourceInputStream(final String theResourceName) {
        resourceName = theResourceName;

        if (log.isInfoEnabled()) {
            log.info("Creating InputStream out of the resource with path: " + resourceName);
        }
        inputStream = ResourceInputStream.class.getResourceAsStream(resourceName);
    }

    /**
     * Reads the next byte of data from the input stream.
     *
     * @return the next byte of data from the input stream.
     * @throws IOException
     *             on error
     */
    @Override
    public int read() throws IOException {
        return inputStream.read();
    }

    /**
     * Returns the number of bytes that can be read (or skipped over) from this
     * input stream without blocking by the next caller of a method for this
     * input stream.
     *
     * @return the number of bytes that can be read (or skipped over) from this
     *         input stream without blocking by the next caller of a method for
     *         this input stream.
     * @throws IOException
     *             on error
     */
    @Override
    public int available() throws IOException {
        return inputStream.available();
    }

    /**
     * Closes this input stream and releases any system resources associated
     * with the stream.
     *
     * @throws IOException
     *             on error
     */
    @Override
    public void close() throws IOException {
        if (log.isInfoEnabled()) {
            log.info("Closing the InputStream out of the resource with path: " + resourceName);
        }
        inputStream.close();
    }

    /**
     * Marks the current position in this input stream.
     *
     * @param readlimit
     *            allow this many bytes to be read before the mark position gets
     *            invalidated
     */
    @Override
    public synchronized void mark(final int readlimit) {
        inputStream.mark(readlimit);
    }

    /**
     * Tests if this input stream supports the 'mark' and 'reset' methods.
     *
     * @return whether the input stream supports the 'mark' and 'reset' methods.
     */
    @Override
    public boolean markSupported() {
        return inputStream.markSupported();
    }

    /**
     * Reads up to len bytes of data from the input stream into an array of
     * bytes.
     *
     * @param b
     *            buffer to store the bytes in
     * @param off
     *            the starting offset
     * @param len
     *            the number of bytes to load
     * @return the number of bytes read
     * @throws IOException
     *             on error
     */
    @Override
    public int read(final byte[] b, final int off, final int len) throws IOException {
        return inputStream.read(b, off, len);
    }

    /**
     * Reads some number of bytes from the input stream and stores them into the
     * buffer array b.
     *
     * @param b
     *            buffer to store the bytes in
     * @return the number of bytes read
     * @throws IOException
     *             on error
     */
    @Override
    public int read(final byte[] b) throws IOException {
        return inputStream.read(b);
    }

    /**
     * Repositions the stream to the position at the time the mark method was
     * last called on this input stream.
     *
     * @throws IOException
     *             on error
     */
    @Override
    public synchronized void reset() throws IOException {
        inputStream.reset();
    }

    /**
     * Skips over and discards n bytes of data from this input stream.
     *
     * @param n
     *            the number of bytes to skip over and discard
     * @return the actual number of bytes skipped.
     * @throws IOException
     *             on error
     */
    @Override
    public long skip(final long n) throws IOException {
        return inputStream.skip(n);
    }

}