providerobserver.java

Java Telephony API .java程序

/*
#pragma ident "@(#)ProviderObserver.java	1.1      96/11/01     SMI"

 * Copyright (c) 1996 Sun Microsystems, Inc. All Rights Reserved.
 *
 * Permission to use, copy, modify, and distribute this software
 * and its documentation for NON-COMMERCIAL purposes and without
 * fee is hereby granted provided that this copyright notice
 * appears in all copies. Please refer to the file "copyright.html"
 * for further important copyright and licensing information.
 *
 * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
 * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
 * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
 * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
 * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
 * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
 */

package java.telephony;
import  java.telephony.events.ProvEv;

/**
 * The ProviderObserver interface reports all state changes on the Provider
 * object as events. Applications instantiate an object which implements
 * this interface and uses the <EM>Provider.addObserver()</EM> method to begin
 * the delivery of events to this object. Applications may use the
 * <EM>Provider.removeObserver()</EM> method to discontinue the delivery of
 * events to an observer object. A list of observers on the Provider object can
 * be obtained via the <EM>Provider.getObservers()</EM> method
 * <p>
 * The ProviderObserver interface has one method:
 * <EM>providerChangedEvent()</EM>. This method takes a single argument, an
 * array of ProvEv objects. Applications iterate over this array for the
 * individual events. All Provider events must extend the
 * java.telephony.events.ProvEv interface.
 * <p>
 * The ProviderObserver reports a list of events because several state changes
 * may occur at once. To maintain the consistency between the state changes
 * in the call model and the events reported to the application, several
 * events may need to be delivered at once.
 * <p>
 * The ProviderObserver interface reports the following events. The hyper-links
 * below provide access to the specifications for these events.
 * <p>
 * @see java.telephony.events.ProvEv
 * @see java.telephony.events.ProvInServiceEv
 * @see java.telephony.events.ProvOutOfServiceEv
 * @see java.telephony.events.ProvShutdownEv
 */

public interface ProviderObserver {

  /**
   * Reports all events on the ProviderObserver interface. This method takes
   * an array of ProvEv object as its argument which reports all these state
   * changes which have occurred on the Provider object.
   * <p>
   * @param eventList The list of Provider events.
   */
  public void providerChangedEvent(ProvEv[] eventList);
}