billingengine.java

Sun公司Dream项目

/*
 * 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]
 */ 

/*
 * $(@)BillingEngine.java $Revision: 1.1.1.1 $ $Date: 2006/03/15 13:12:10 $
 * 
 * Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
 */
/**
 *
 * @version: 1.0
 * @date: Sept 19, 2002
 *
 */
package com.sun.sjc.idtv.vod.server.billing;

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

/**
 * Remote interface for the <code>BillingEngineBean</code>. The remote interface, <code>BillingEngine</code>
 * defines all possible business methods for the bean.
 *
 * @see BillingEngineHome
 * @see BillingEngineBean
 */
public interface BillingEngine extends EJBObject {
 
    /**
     * Rent a movie.
     * @param subscriber the subscriber.
     * @param movie the movie.
     * @return true if the account balance allows the rental
     * @exception RemoteException
     */
   public boolean rentMovie(Subscriber subscriber, Movie movie) throws RemoteException, java.sql.SQLException;

    /**
     * Get the account balance for a given subscriber.
     * @param subscriber the subscriber.
     * @return account balance
     * @exception RemoteException
     */
   public float getAccountBalance(Subscriber subscriber) throws RemoteException, java.sql.SQLException;

    /**
     * Set the account balance for a given subscriber.
     * @param subscriber the subscriber.
     * @exception RemoteException
     */
   public void setAccountBalance(Subscriber subscriber, float balance) throws RemoteException, java.sql.SQLException;

    /**
     * Get the account movement history for a given subscriber.
     * @param subscriber the subscriber.
     * @param start start date for the history.
     * @param end end date for the history.
     * @return movement history
     * @exception RemoteException
     */
   public String[] getHistory(Subscriber subscriber, Date start, Date end) throws RemoteException, java.sql.SQLException;

}