javax.media.MediaProxy Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of mhp-1.1.2 Show documentation

MHP 1.1.2 stubs

The newest version!

/*
 * @(#)MediaProxy.java	1.11 98/03/28
 *
 * Copyright 1996-1998 by Sun Microsystems, Inc.,
 * 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
 * All rights reserved.
 *
 * This software is the confidential and proprietary information
 * of Sun Microsystems, Inc. ("Confidential Information").  You
 * shall not disclose such Confidential Information and shall use
 * it only in accordance with the terms of the license agreement
 * you entered into with Sun.
 */

package javax.media;

import javax.media.protocol.DataSource;
import java.io.IOException;

/*
 * Typically, a MediaProxy reads a text configuration file
 * that contains all of the information needed to 
 * make a connection to a server and obtain media data.
 * To produce a Player from a MediaLocator
 * referencing the configuration file,
 * Manger:
 * 
 * constructs a DataSource
 * for the protocol described by the MediaLocator
 * 
constructs a MediaProxy to read
 * the configuration file using the content-type of the
 * DataSource
 * 
 obtains a new DataSource
 * from the MediaProxy
 * 
constructs the Player using the content-type of the new
 * DataSource
 * 
 */
public interface MediaProxy extends MediaHandler {

    /**
     * Obtain the new DataSource.
     * The DataSource is already connected.
     *
     * @exception IOException Thrown when if there are IO
     * problems in reading the the original or new
     * DataSource.
     *
     * @exception NoDataSourceException Thrown if this proxy
     * can't produce a DataSource.
     * 
     * @return the new DataSource for this content.
     */
    public DataSource getDataSource()
	throws IOException, NoDataSourceException;

}