javax.media.MediaLocator Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of fmj Show documentation
Freedom for Media in Java
There is a newer version: 1.0.2-jitsi
package javax.media;

import java.io.*;

/**
 * Standard JMF class -- see this class in the JMF Javadoc. Coding complete.
 *
 * @author Ken Larson
 * @author Lyubomir Marinov
 */
public class MediaLocator implements Serializable
{
    private static final long serialVersionUID = -6747425113475481405L;

    private String locatorString;

    public MediaLocator(java.net.URL url)
    {
        this.locatorString = url.toExternalForm(); // TODO: is this correct?
    }

    public MediaLocator(String locatorString)
    {
        if (locatorString == null)
            throw new NullPointerException("locatorString");
        this.locatorString = locatorString;
    }

    /**
     * Determines whether a specific object is equal by value to this object.
     *
     * @param obj the object to compare by value to this object
     * @return true if the specified obj is equal by value to
     * this object; otherwise, false
     */
    @Override
    public boolean equals(Object obj)
    {
        if (null == obj)
            return false;
        if (this == obj)
            return true;

        if (!(obj instanceof MediaLocator))
            return false;

        MediaLocator ml = (MediaLocator) obj;

        return
            (locatorString == null)
                ? (ml.locatorString == null)
                : locatorString.equals(ml.locatorString);
    }

    public String getProtocol()
    {
        int colonIndex = locatorString.indexOf(':');
        if (colonIndex < 0)
            return "";
        return locatorString.substring(0, colonIndex);
    }

    public String getRemainder()
    {
        int colonIndex = locatorString.indexOf(':');
        if (colonIndex < 0)
            return "";
        return locatorString.substring(colonIndex + 1);
    }

    public java.net.URL getURL() throws java.net.MalformedURLException
    {
        return new java.net.URL(locatorString);
    }
    /**
     * Gets a hash code value for this object for the benefit of hashtables.
     *
     * @return a hash code value for this object for the benefit of hashtables
     */
    @Override
    public int hashCode()
    {
        return (locatorString == null) ? 0 : locatorString.hashCode();
    }

    public String toExternalForm()
    {
        return locatorString;
    }

    @Override
    public String toString()
    {
        return locatorString;
    }
}