Tarball conversion

1 files changed, 34 insertions, 0 deletions

diff --git a/lang/java/src/com/sleepycat/db/MessageHandler.java b/lang/java/src/com/sleepycat/db/MessageHandler.java
new file mode 100644
index 00000000..16cdea2b
--- /dev/null
+++ b/lang/java/src/com/sleepycat/db/MessageHandler.java
@@ -0,0 +1,34 @@
+/*-
+ * See the file LICENSE for redistribution information.
+ *
+ * Copyright (c) 1997, 2012 Oracle and/or its affiliates.  All rights reserved.
+ *
+ * $Id$
+ */
+package com.sleepycat.db;
+
+/**
+An interface specifying a callback function to be called to display
+informational messages.
+*/
+public interface MessageHandler {
+    /**
+    A callback function to be called to display informational messages.
+    <p>
+    There are interfaces in the Berkeley DB library which either directly
+    output informational messages or statistical information, or configure
+    the library to output such messages when performing other operations,
+    {@link com.sleepycat.db.EnvironmentConfig#setVerboseDeadlock EnvironmentConfig.setVerboseDeadlock} for example.
+    <p>
+    The {@link com.sleepycat.db.EnvironmentConfig#setMessageHandler EnvironmentConfig.setMessageHandler} and
+    {@link com.sleepycat.db.DatabaseConfig#setMessageHandler DatabaseConfig.setMessageHandler} methods are used to
+    display these messages for the application.
+    <p>                 
+    @param environment  
+    The enclosing database environment handle.
+    <p>
+    @param message
+    An informational message string.
+    */
+    void message(Environment environment, String message);
+}