airlineshoppingcartremoteobject.java

BEA WebLogic Server 8.1大全 = BEA webLogic server 8.1 unleashed (美) Mark Artiges等著 袁毅 ... [等] 译 eng

/* 
 * WebLogic Server Unleashed
 * 
 */


package com.wlsunleashed.ejb.session.stateful;

import java.rmi.RemoteException;
import java.util.Properties;

import javax.ejb.EJBObject;


/**
 * This class Represents a remote interface for  the AirlineShoppingCart EJB
 * Stateful session bean
 * 
 * @version 1.0
 */
public interface AirlineShoppingCartRemoteObject extends EJBObject {
    /**
     * Sets the destination requested
     * 
     * @param destination String
     * 
     * @throws RemoteException Thrown when any remote exception occurs while
     *         processing the request
     */
    void setDestination(String destination)
                 throws RemoteException;

    /**
     * Returns flight information
     * 
     * @return A Properties object containing all flight informations
     * 
     * @throws RemoteException Thrown when any remote exception occurs while
     *         processing the request
     * @throws AirlineShoppingCartException when any error occurs while
     *         performing this operation
     */
    Properties getFlightInfo()
                      throws RemoteException, AirlineShoppingCartException;

    /**
     * Sets the flight number requested
     * 
     * @param flightNum The flight number
     * 
     * @throws RemoteException Thrown when any remote exception occurs while
     *         processing the request
     */
    void setFlightNumber(int flightNum)
                  throws RemoteException;

    /**
     * Sets the number of seats requested
     * 
     * @param numSeats The number of seats
     * 
     * @throws RemoteException Thrown when any remote exception occurs while
     *         processing the request
     */
    void setNumSeats(int numSeats)
              throws RemoteException;

    /**
     * Sets the origin requested
     * 
     * @param origin The origin airport
     * 
     * @throws RemoteException Thrown when any remote exception occurs while
     *         processing the request
     */
    void setOrigin(String origin)
            throws RemoteException;

    /**
     * Returns the total cost
     * 
     * @return double The total cost after reservations
     * 
     * @throws RemoteException Thrown when any remote exception occurs while
     *         processing the request
     */
    double getTotalCost()
                 throws RemoteException;

    /**
     * Reserve seats
     * 
     * @throws RemoteException Thrown when any remote exception occurs while
     *         processing the request
     * @throws AirlineShoppingCartException when any business exception 
     *         occurs while performing this operation
     */
    void reserveSeats()
               throws RemoteException, AirlineShoppingCartException;

    /**
     * A method that searches for flights based on the set criteria and 
     * returns a list of flight numbers found
     *
     * @return An array of flight numbers
     *
     * @exceptions RemoteException Thrown when any remote exception occurs while
     *          processing the request
     * @throws AirlineShoppingCartException when any business exception 
     *         occurs while performing this operation
     */
    int[] searchFlights()
                 throws RemoteException, AirlineShoppingCartException;
}