1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104
|
/* ***** BEGIN LICENSE BLOCK *****
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
*
* 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 gContactSync.
*
* The Initial Developer of the Original Code is
* Josh Geenen <gcontactsync@pirules.org>.
* Portions created by the Initial Developer are Copyright (C) 2008-2009
* the Initial Developer. All Rights Reserved.
*
* Contributor(s):
*
* Alternatively, the contents of this file may be used under the terms of
* either the GNU General Public License Version 2 or later (the "GPL"), or
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
* in which case the provisions of the GPL or the LGPL are applicable instead
* of those above. If you wish to allow use of your version of this file only
* under the terms of either the GPL or the LGPL, and not to allow others to
* use your version of this file under the terms of the MPL, indicate your
* decision by deleting the provisions above and replace them with the notice
* and other provisions required by the GPL or the LGPL. If you do not delete
* the provisions above, a recipient may use your version of this file under
* the terms of any one of the MPL, the GPL or the LGPL.
*
* ***** END LICENSE BLOCK ***** */
if (!com) var com = {}; // A generic wrapper variable
// A wrapper for all GCS functions and variables
if (!com.gContactSync) com.gContactSync = {};
/**
* A simple class that logs messages.
* @class
*/
com.gContactSync.LOGGER = {
/** The number of errors logged */
mErrorCount: 0,
/** The number of warnings logged */
mWarningCount: 0,
/** The console service (for logging to the error console) */
mConsoleService: Components.classes['@mozilla.org/consoleservice;1']
.getService(Components.interfaces.nsIConsoleService),
/**
* Appends the message to the log file and adds a newline character after the
* message.
* @param aMessage {string} The message to append.
*/
LOG: function LOGGER_LOG(aMessage) {
if (!aMessage)
return;
// this can fail if called before FileIO is initialized
try {
if (com.gContactSync.Preferences.mSyncPrefs.enableLogging.value)
com.gContactSync.FileIO.appendToFile(com.gContactSync.FileIO.mLogFile,
aMessage + "\n");
} catch (e) {}
},
/**
* Logs the message if verbose logging is enabled.
* @param aMessage {string} The message to log.
*/
VERBOSE_LOG: function LOGGER_VERBOSE_LOG(aMessage) {
if (com.gContactSync.Preferences.mSyncPrefs.verboseLog.value)
this.LOG(aMessage);
},
/**
* Logs an error and increments the error count.
* @param aMessage {string} The error message.
* @param aError {string} Optional. The exception caught.
*/
LOG_ERROR: function LOGGER_LOG_ERROR(aMessage, aError) {
var str = "***ERROR: " + aMessage;
if (aError)
str += "\nError Message:\n" + aError;
str += com.gContactSync.StringBundle.getStr("pleaseReport");
this.LOG(str);
this.mErrorCount++;
this.mConsoleService.logStringMessage("gContactSync: " + str);
},
/**
* Logs a warning and updates the warning count.
* @param aWarningMessage {string} The warning message with info about the
* problem.
* @param aError {string} Optional. The exception caught.
*/
LOG_WARNING: function LOGGER_LOG_WARNING(aWarningMessage, aError) {
var str = "***WARNING: " + aWarningMessage;
if (aError)
str += "\nError Message:\n" + aError;
//str += "\n" + com.gContactSync.StringBundle.getStr("pleaseReport");
this.LOG(str);
this.mWarningCount++;
}
};
|