org.ocap.shared.dvr.ServiceRecordingSpec Maven / Gradle / Ivy

package org.ocap.shared.dvr;

import java.util.Date;
import javax.tv.service.Service;
import java.lang.IllegalArgumentException;

/**
 * Specifies a recording request in terms of a Service.
 * When instances of this class are passed to RecordingManager.record(..),
 * the following additional failure mode shall apply - if the end time 
 * (computed as the start time + the duration) is in the past when the 
 * record method is called, the record method shall throw an IllegalArgumentException.

 * When an instance of this recording spec is passed in as a parameter to 
 * the RecordingRequest.reschedule(..) method, an IllegalArgumentException shall
 * be thrown if either of the following apply;

 * if the source is different from the source specified in the current 
 * recording spec for the recording request and if the recording request 
 * is in progress state.
 * 
if the properties parameter of the instance is an instance of an application defined class
 * 
 * When instances of this class are passed to RecordingManager.record(..),
 * if the start time is in the past and either
 * none of the content concerned is already recorded
 * 
some of the content concerned is already recorded but the implementation 
 * does not support including already recorded content in a scheduled recording
 * 
 * then the current time shall be used as the start time and the duration
 * reduced accordingly. The present document does not require implementations
 * to include already recorded content in scheduled recordings however GEM
 * recording specifications may require this.
 */

public class ServiceRecordingSpec extends RecordingSpec
{
    /**
     * Constructor.
     * @param source the service to be recorded
     * @param startTime Start time of the recording. Changes to this parameter
     * after the constructor returns shall have no effect on the actual
     * start time of the recording.
     * @param duration Length of time to record in milli-seconds.
     * @param properties The definition of how the recording is to be done.
     * @throws IllegalArgumentException if the source is not a broadcast service or
     * if the duration is negative
     */
    public ServiceRecordingSpec(Service source,
                                Date startTime,
                                long duration,
                                RecordingProperties properties)
    throws IllegalArgumentException
    {
        super(properties);
    }

    /**
     * Returns the source of the recording
     * @return the source passed into the constructor
     */
    public javax.tv.service.Service getSource()
    {
        return null;
    }

    /**
     * Returns the start time passed as an argument to the constructor. 
     * @return a copy of the start time passed into the constructor
     */
    public Date getStartTime()
    {
        return null ;
    }

    /**
     * Returns the duration passed as an argument to the constructor. 
     * @return the duration passed into the constructor
     */
    public long getDuration()
    {
        return 0 ;
    }
}