airlinereservationremoteobject.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.rmi.RemoteException;

import java.util.Properties;

import javax.ejb.EJBObject;


/**
 * This class represents he Remote interface to  the ReservationProcessor
 * Stateless Session EJB
 * 
 * @version 1.0
 */
public interface AirlineReservationRemoteObject extends EJBObject {
    /**
     * Returns the flight information as a property file.
     * 
     * @param flightNumber The flight number to be looked up
     * 
     * @return Properties The flight information
     * 
     * @throws RemoteException Thrown when anything goes wrong  when attempting
     *         to invoke this method over RMI
     * @throws AirlineReservationException Thrown when any business exception
     *         or high-level sub-system exception occurs
     */
    Properties getFlightInfo(int flightNumber)
                      throws RemoteException, AirlineReservationException;

    /**
     * TODO
     *
     * @param origin TODO
     * @param destination TODO
     *
     * @return TODO
     *
     * @exceptions RemoteException 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 RemoteException, AirlineReservationException;

    /**
     * Reserves the number of seats on the given flight.
     * 
     * @param flightNumber The flight number to be looked up
     * @param numSeats The number of seats to be reserved.
     * 
     * @throws RemoteException Thrown when anything goes wrong  when attempting
     *         to invoke this method over RMI
     * @throws AirlineReservationException Thrown when any business exception
     *         or high-level sub-system exception occurs
     */
    void reserveSeats(int flightNumber, int numSeats)
               throws RemoteException, AirlineReservationException;
}