gecko-dev/grendel/storage/mdb/nsIMdbErrorHook.java
1999-11-02 01:51:54 +00:00

57 lines
2.4 KiB
Java

/* -*- Mode: java; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* The contents of this file are subject to the Mozilla Public
* License Version 1.1 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.mozilla.org/MPL/
*
* 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 language governing
* rights and limitations under the License.
*
* The Original Code is the Grendel mail/news client.
*
* The Initial Developer of the Original Code is Netscape Communications
* Corporation. Portions created by Netscape are
* Copyright (C) 1997 Netscape Communications Corporation. All
* Rights Reserved.
*
* Contributor(s):
*
* Created: Mauro Botelho <mabotelh@email.com>, 20 Mar 1999.
*/
package grendel.storage.mdb;
/*| nsIMdbErrorHook: a base class for clients of this API to subclass, in order
**| to provide a callback installable in nsIMdbEnv for error notifications. If
**| apps that subclass nsIMdbErrorHook wish to maintain a reference to the env
**| that contains the hook, then this should be a weak ref to avoid cycles.
**|
**|| OnError: when nsIMdbEnv has an error condition that causes the total count
**| of errors to increase, then nsIMdbEnv should call OnError() to report the
**| error in some fashion when an instance of nsIMdbErrorHook is installed. The
**| variety of string flavors is currently due to the uncertainty here in the
**| nsIMdbBlob and nsIMdbCell interfaces. (Note that overloading by using the
**| same method name is not necessary here, and potentially less clear.)
|*/
public interface nsIMdbErrorHook { // env callback handler to report errors
// { ===== begin error methods =====
public int OnErrorString(nsIMdbEnv ev, String inAscii);
// public int OnErrorYarn(nsIMdbEnv ev, mdbYarn inYarn);
// } ===== end error methods =====
// { ===== begin warning methods =====
public int OnWarningString(nsIMdbEnv ev, String inAscii);
// public int OnWarningYarn(nsIMdbEnv ev, mdbYarn inYarn);
// } ===== end warning methods =====
// { ===== begin abort hint methods =====
public int OnAbortHintString(nsIMdbEnv ev, String inAscii);
// public int OnAbortHintYarn(nsIMdbEnv ev, mdbYarn inYarn);
// } ===== end abort hint methods =====
};