/*
 * The contents of this file are subject to the terms
 * of the Common Development and Distribution License
 * (the "License").  You may not use this file except
 * in compliance with the License.
 *
 * You can obtain a copy of the license at
 * http://www.opensource.org/licenses/cddl1.php
 * See the License for the specific language governing
 * permissions and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL
 * HEADER in each file and include the License file at
 * http://www.opensource.org/licenses/cddl1.php.  If 
 * applicable, add the following below this CDDL HEADER, 
 * with the fields enclosed by brackets "[]" replaced 
 * with your own identifying information: 
 * Portions Copyright [yyyy]
 * [name of copyright owner]
 */ 

/*
 * $(@)RTSPStoredSessionEngine.java $Revision: 1.1.1.1 $ $Date: 2006/03/15 13:12:10 $
 * 
 * Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
 */
 
package com.sun.sjc.idtv.vod.server.rtspsession;

import java.util.*;
import javax.ejb.EJBObject;
import java.rmi.RemoteException;
import java.sql.*;
import com.sun.sjc.idtv.vod.shared.data.*;

/**
 * Remote interface for the <code>RTSPStoredSessionEngineBean</code>. The remote
 * interface, <code>RTSPStoredSessionEngine</code> defines all possible business
 * methods for the bean.
 *
 * @see RTSPStoredSessionEngineBean
 * @see RTSPStoredSessionEngineHome 
 */

public interface RTSPStoredSessionEngine extends EJBObject {

    /**
     *  stores a single RTSP session into the database
     * @param rtspSessionObject - information on the RTSP session
     * @return void
     * @exception RemoteException
     * @exception SQLException 
     */
    
    public void storeRTSPSession(RTSPSessionObject rtspSessionObject) throws RemoteException, SQLException;
    
    /**
     * gets all of the stored RTSP sessions from the database for a given user
     * @param userId - id of user
     * @return rtspSessionObjects - array of RTSPSessionObject containing all of the RTSP sessions of a specified user
     * @exception RemoteException
     * @exception SQLException
     */
     
    public RTSPSessionObject[] getStoredRTSPSessions(String userId) throws RemoteException,
    SQLException;
}