airlineshoppingcartlocalobject.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.util.Properties;

import javax.ejb.EJBLocalObject;


/**
 * This class represents a local object for the  Airline Shopping Cart EJB
 * 
 * @version 1.0
 */
public interface AirlineShoppingCartLocalObject extends EJBLocalObject {
    /**
     * Sets the destination requested
     * 
     * @param destination String
     */
    void setDestination(String destination);

    /**
     * Returns flight information
     * 
     * @return A Properties object containing all flight informations
     * 
     * @throws AirlineShoppingCartException when any error occurs while
     *         performing this operation
     */
    Properties getFlightInfo()
                      throws AirlineShoppingCartException;

    /**
     * Sets the flight number requested
     * 
     * @param flightNum The flight number
     */
    void setFlightNumber(int flightNum);

    /**
     * Sets the number of seats requested
     * 
     * @param numSeats The number of Seats
     */
    void setNumSeats(int numSeats);

    /**
     * Sets the origin requested
     * 
     * @param origin The origin airport
     */
    void setOrigin(String origin);

    /**
     * Returns the total cost
     * 
     * @return double The total cost after reservations
     */
    double getTotalCost();

    /**
     * Reserve seats
     * 
     * @throws AirlineShoppingCartException when any error occurs while
     *         performing this operation
     */
    void reserveSeats()
               throws 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 AirlineShoppingCartException;
}