FilenameURL.java

package paulscode.sound;

import java.net.URL;

/**
 * The FilenameURL class is designed to associate a String filename/identifier
 * with a URL.  Handles either case where user supplies a String path or user
 * supplies a URL instance.
 *<br><br>
 *<b><i>    SoundSystem License:</b></i><br><b><br>
 *    You are free to use this library for any purpose, commercial or otherwise.
 *    You may modify this library or source code, and distribute it any way you
 *    like, provided the following conditions are met:
 *<br>
 *    1) You may not falsely claim to be the author of this library or any
 *    unmodified portion of it.
 *<br>
 *    2) You may not copyright this library or a modified version of it and then
 *    sue me for copyright infringement.
 *<br>
 *    3) If you modify the source code, you must clearly document the changes
 *    made before redistributing the modified source code, so other users know
 *    it is not the original code.
 *<br>
 *    4) You are not required to give me credit for this library in any derived
 *    work, but if you do, you must also mention my website:
 *    http://www.paulscode.com
 *<br>
 *    5) I the author will not be responsible for any damages (physical,
 *    financial, or otherwise) caused by the use if this library or any part
 *    of it.
 *<br>
 *    6) I the author do not guarantee, warrant, or make any representations,
 *    either expressed or implied, regarding the use of this library or any
 *    part of it.
 * <br><br>
 *    Author: Paul Lamb
 * <br>
 *    http://www.paulscode.com
 * </b>
 */
public class FilenameURL
{
/**
 * Processes status messages, warnings, and error messages.
 */
    private SoundSystemLogger logger;

/**
 * Filename or identifier for the file.
 */
    private String filename = null;

/**
 * URL interface to the file.
 */
    private URL url = null;

/**
 * Constructor: Saves handles to the url and identifier.  The identifier should
 * look like a filename, and it must have the correct extension so SoundSystem
 * knows what format to use for the file referenced by the URL instance.
 * @param url URL interface to a file.
 * @param identifier Identifier (filename) for the file.
 */
    public FilenameURL( URL url, String identifier )
    {
        // grab a handle to the message logger:
        logger = SoundSystemConfig.getLogger();

        filename = identifier;
        this.url = url;
    }

/**
 * Constructor: Saves a handle to the filename (used later to generate a URL
 * instance).  The file may either be located within the
 * JAR or at an online location.  If the file is online, filename must begin
 * with "http://", since that is how SoundSystem recognizes URL names.
 * @param filename Name of the file.
 */
    public FilenameURL( String filename )
    {
        // grab a handle to the message logger:
        logger = SoundSystemConfig.getLogger();

        this.filename = filename;
        url = null;
    }

/**
 * Returns the filename/identifier.
 * @return Filename or identifier for the file.
 */
    public String getFilename()
    {
        return filename;
    }

/**
 * Returns the URL interface to the file.  If a URL was not originally specified
 * in the constructor, then the first time this method is called it creates a
 * URL instance using the previously specified filename.
 * @return URL interface to the file.
 */
    public URL getURL()
    {
        if( url == null )
        {
            // Check if the file is online or inside the JAR:
            if( filename.matches( SoundSystemConfig.PREFIX_URL ) )
            {
                // Online
                try
                {
                    url = new URL( filename );
                }
                catch( Exception e )
                {
                    errorMessage( "Unable to access online URL in " +
                                  "method 'getURL'" );
                    printStackTrace( e );
                    return null;
                }
            }
            else
            {
                // Inside the JAR
                url = getClass().getClassLoader().getResource(
                      SoundSystemConfig.getSoundFilesPackage() + filename );
            }
        }
        return url;
    }

/**
 * Prints an error message.
 * @param message Message to print.
 */
    private void errorMessage( String message )
    {
        logger.errorMessage( "MidiChannel", message, 0 );
    }

/**
 * Prints an exception's error message followed by the stack trace.
 * @param e Exception containing the information to print.
 */
    private void printStackTrace( Exception e )
    {
        logger.printStackTrace( e, 1 );
    }
}