86 lines
4.0 KiB
Java
86 lines
4.0 KiB
Java
/*
|
|
* Copyright (c) 2018. Ernesto Castellotti <erny.castell@gmail.com>
|
|
* This file is part of JTdlib.
|
|
*
|
|
* JTdlib is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License.
|
|
*
|
|
* JTdlib is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with JTdlib. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
package it.tdlight.jni;
|
|
|
|
/**
|
|
* Class used for managing internal TDLib logging.
|
|
* Use TdApi.*Log* methods instead.
|
|
*/
|
|
public class NativeLog {
|
|
|
|
private static final FatalErrorCallbackPtr defaultFatalErrorCallbackPtr = System.err::println;
|
|
private static FatalErrorCallbackPtr fatalErrorCallback = defaultFatalErrorCallbackPtr;
|
|
|
|
/**
|
|
* Sets file path for writing TDLib internal log. By default TDLib writes logs to the System.err.
|
|
* Use this method to write the log to a file instead.
|
|
*
|
|
* @deprecated As of TDLib 1.4.0 in favor of {@link TdApi.SetLogStream}, to be removed in the future.
|
|
* @param filePath Path to a file for writing TDLib internal log. Use an empty path to
|
|
* switch back to logging to the System.err.
|
|
* @return whether opening the log file succeeded.
|
|
*/
|
|
@Deprecated
|
|
public static native boolean setFilePath(String filePath);
|
|
|
|
/**
|
|
* Changes the maximum size of TDLib log file.
|
|
*
|
|
* @deprecated As of TDLib 1.4.0 in favor of {@link TdApi.SetLogStream}, to be removed in the future.
|
|
* @param maxFileSize The maximum size of the file to where the internal TDLib log is written
|
|
* before the file will be auto-rotated. Must be positive. Defaults to 10 MB.
|
|
*/
|
|
@Deprecated
|
|
public static native void setMaxFileSize(long maxFileSize);
|
|
|
|
/**
|
|
* Changes TDLib log verbosity.
|
|
*
|
|
* @deprecated As of TDLib 1.4.0 in favor of {@link TdApi.SetLogVerbosityLevel}, to be removed in the future.
|
|
* @param verbosityLevel New value of log verbosity level. Must be non-negative.
|
|
* Value 0 corresponds to fatal errors,
|
|
* value 1 corresponds to java.util.logging.Level.SEVERE,
|
|
* value 2 corresponds to java.util.logging.Level.WARNING,
|
|
* value 3 corresponds to java.util.logging.Level.INFO,
|
|
* value 4 corresponds to java.util.logging.Level.FINE,
|
|
* value 5 corresponds to java.util.logging.Level.FINER,
|
|
* value greater than 5 can be used to enable even more logging.
|
|
* Default value of the log verbosity level is 5.
|
|
*/
|
|
@Deprecated
|
|
public static native void setVerbosityLevel(int verbosityLevel);
|
|
|
|
/**
|
|
* This function is called from the JNI when a fatal error happens to provide a better error message.
|
|
* The function does not return.
|
|
*
|
|
* @param errorMessage Error message.
|
|
*/
|
|
private static synchronized void onFatalError(String errorMessage) {
|
|
new Thread(() -> NativeLog.fatalErrorCallback.onFatalError(errorMessage)).start();
|
|
}
|
|
|
|
/**
|
|
* Sets the callback that will be called when a fatal error happens. None of the TDLib methods can be called from the callback. The TDLib will crash as soon as callback returns. By default the callback set to print in stderr.
|
|
* @param fatalErrorCallback Callback that will be called when a fatal error happens. Pass null to restore default callback.
|
|
*/
|
|
public static synchronized void setFatalErrorCallback(FatalErrorCallbackPtr fatalErrorCallback) {
|
|
NativeLog.fatalErrorCallback = ObjectsUtils.requireNonNullElse(fatalErrorCallback, defaultFatalErrorCallbackPtr);
|
|
}
|
|
}
|