airlinereservationlocalobject.java

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

/* 
 * WebLogic Server Unleashed
 * 
 */


package com.wlsunleashed.ejb.session.stateless;

import java.util.Properties;

import javax.ejb.EJBLocalObject;


/**
 * This class  reprents the Local object interface  to the AirlineReservation
 * Stateless Session EJB
 * 
 * @version 1.0
 */
public interface AirlineReservationLocalObject extends EJBLocalObject {
    /**
     * Returns the flight information as a property file.
     * 
     * @param flightNumber int: The flight number to be looked up
     * 
     * @return Properties: The flight information
     * 
     * @exception AirlineReservationException Thrown when any business
     *            exception or high-level sub-system exception occurs
     */
    Properties getFlightInfo(int flightNumber)
                      throws AirlineReservationException;

    /**
     * TODO
     *
     * @param origin TODO
     * @param destination TODO
     *
     * @return TODO
     *
     * @exceptions AirlineReservationException TODO
     */
    /**
     * Returns a list of flight numbers that operate between the given sets of
     * cities
     * 
     */
    int[] getFlightNumbers(String origin, String destination)
                    throws AirlineReservationException;

    /**
     * Reserves the number of seats on the given flight.
     * 
     * @param flightNumber int: The flight number to be looked up
     * @param numSeats int: The number of seats to be reserved.
     * 
     * @throws AirlineReservationException Thrown when any business exception
     *         or high-level sub-system exception occurs
     */
    void reserveSeats(int flightNumber, int numSeats)
               throws AirlineReservationException;
}