cmisstack.java

来自「CmisJavaApi」· Java 代码 · 共 80 行

/*
 * The contents of this file are subject to the Dyade Public License, 
 * as defined by the file DYADE_PUBLIC_LICENSE.TXT
 *
 * You may not use this file except in compliance with the License. You may
 * obtain a copy of the License on the Dyade web site (www.dyade.fr).
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
 * the specific terms governing rights and limitations under the License.
 *
 * The Original Code is CmisJava API, including the java package 
 * fr.dyade.cmis, released September 5, 2000.
 *
 * The Initial Developer of the Original Code is Dyade. The Original Code and
 * portions created by Dyade are Copyright Bull and Copyright INRIA. 
 * All Rights Reserved.
 */

/*      Copyright 1996-2000 by Institut National de Recherche en Informatique 
 *                             et en Automatique (INRIA)
 *          All rights reserved.  See COPYRIGHT in top-level directory.
 *
 *      Authors: Laurent Andrey, Olivier Festor
 */

//  $Id: CMISStack.java,v 1.2 2000/09/05 13:04:23 festor Exp $
//  $Source: /local/resedas/CVS-Repository/CmisJavaApi/src/fr/dyade/cmis/api/CMISStack.java,v $
//
package fr.dyade.cmis.api;

import fr.dyade.cmis.api.operation.event.CMISEventSource;
import fr.dyade.cmis.api.operation.event.InternalErrorListener;

/**
  * This interface is intended to be an abstract representation of
  * the CMIS service implementation.
  * It extends <code>{@link fr.dyade.cmis.api.operation.event.CMISEventSource}</code>
  * because a stack is the event source from indication, 
  * and some error related events in this awt-event-model-like api.
  *  @see fr.dyade.cmis.api.CMISManagerStack
  *  @see fr.dyade.cmis.api.CMISAgentStack
  *  @version cvs $Id: CMISStack.java,v 1.2 2000/09/05 13:04:23 festor Exp $
  */
public abstract interface CMISStack extends CMISEventSource {    
      public short BOTHSIDE        = 0;
      public short MANAGERSIDEONLY = 1;
      public short AGENTSIDEONLY   = 2;
      /** Set the role (agent/manager) of a stack
	* The use of a CMIS stack can be restricted to strict role at run time.
	* Anyway a stack can implements any role by implementing
	* CMISManagerStack or/and CMISAgentStack interface(s).
	* @throws CMISException if role can not be changed on current instance.
	*/
      public void setRole( short pRole ) throws CMISException;
      /** Get the actual role of a stack;
	*  @return the role code.
	*/
      public short getRole();
      /** Set the  synchronous error handler.
	* This "last chance" error handler is call when asynchronous error reporting
	* via <code>{@link InternalErrorListener}</code> is unsafe or not appropriated.
	* One and only one synchrounous error handler is setable.
	* @param pHandler the handler to use.
	*/
      public void setSynchronousErrorHandler( ErrorHandler pHandler );

      /** Add an "asynchrounous" listener for internal runtime stack error seen as event.
	* More one listener can be handled by the stack.
	* @param pListener a new listener to call on error event
	* @see fr.dyade.cmis.api.operation.event.InternalErrorEvent
	*/
      public void addInternalErrorListener( InternalErrorListener pListener );
      /** Remove a listener internal runtime stack error.
	* @param pListener the listener to remove
	*/
      public void removeInternalErrorListener( InternalErrorListener pListener );
} // CMISStack