diff options
Diffstat (limited to 'pki/base/common/src/com/netscape/certsrv/logging/AuditEvent.java')
-rw-r--r-- | pki/base/common/src/com/netscape/certsrv/logging/AuditEvent.java | 347 |
1 files changed, 0 insertions, 347 deletions
diff --git a/pki/base/common/src/com/netscape/certsrv/logging/AuditEvent.java b/pki/base/common/src/com/netscape/certsrv/logging/AuditEvent.java deleted file mode 100644 index aa0077b06..000000000 --- a/pki/base/common/src/com/netscape/certsrv/logging/AuditEvent.java +++ /dev/null @@ -1,347 +0,0 @@ -// --- BEGIN COPYRIGHT BLOCK --- -// This program is free software; you can redistribute it and/or modify -// it under the terms of the GNU General Public License as published by -// the Free Software Foundation; version 2 of the License. -// -// This program 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 General Public License along -// with this program; if not, write to the Free Software Foundation, Inc., -// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. -// -// (C) 2007 Red Hat, Inc. -// All rights reserved. -// --- END COPYRIGHT BLOCK --- -package com.netscape.certsrv.logging; - -import java.text.MessageFormat; -import java.util.Locale; - -import com.netscape.certsrv.base.EBaseException; -import com.netscape.certsrv.base.MessageFormatter; - -/** - * The log event object that carries message detail of a log event - * that goes into the Transaction log. Note that the name of this - * class "AuditEvent" is legacy and has nothing to do with the signed - * audit log events, whcih are represented by SignedAuditEvent. - * - * @version $Revision$, $Date$ - * @see java.text.MessageFormat - * @see com.netscape.certsrv.logging.LogResources - */ -public class AuditEvent implements IBundleLogEvent { - - /** - * - */ - private static final long serialVersionUID = -844306657733902324L; - - protected Object mParams[] = null; - - private String mEventType = null; - private String mMessage = null; - private int mLevel = -1; - private int mNTEventType = -1; - private int mSource = -1; - private boolean mMultiline = false; - private long mTimeStamp = System.currentTimeMillis(); - - /** - * The bundle name for this event. - */ - private String mBundleName = LogResources.class.getName(); - private static final String INVALID_LOG_LEVEL = "log level: {0} is invalid, should be 0-6"; - - /** - * Constructs a message event - * <P> - * - * @param msgFormat the message string - */ - public AuditEvent(String msgFormat) { - mMessage = msgFormat; - mParams = null; - } - - /** - * Constructs a message with a parameter. For example, - * - * <PRE> - * new AuditEvent("failed to load {0}", fileName); - * </PRE> - * <P> - * - * @param msgFormat details in message string format - * @param param message string parameter - */ - public AuditEvent(String msgFormat, String param) { - this(msgFormat); - mParams = new String[1]; - mParams[0] = param; - } - - /** - * Constructs a message from an exception. It can be used to carry - * a system exception that may contain information about - * the context. For example, - * - * <PRE> - * try { - * ... - * } catch (IOExeption e) { - * logHandler.log(new AuditEvent("Encountered System Error {0}", e); - * } - * </PRE> - * <P> - * - * @param msgFormat exception details in message string format - * @param exception system exception - */ - public AuditEvent(String msgFormat, Exception exception) { - this(msgFormat); - mParams = new Exception[1]; - mParams[0] = exception; - } - - /** - * Constructs a message from a base exception. This will use the msgFormat - * from the exception itself. - * - * <PRE> - * try { - * ... - * } catch (Exception e) { - * logHandler.log(new AuditEvent(e)); - * } - * </PRE> - * <P> - * - * @param e CMS exception - */ - public AuditEvent(Exception e) { - this(e.getMessage()); - if (e instanceof EBaseException) { - mParams = ((EBaseException) e).getParameters(); - } else { - mParams = new Exception[1]; - mParams[0] = e; - } - } - - /** - * Constructs a message event with a list of parameters - * that will be substituted into the message format. - * <P> - * - * @param msgFormat message string format - * @param params list of message format parameters - */ - public AuditEvent(String msgFormat, Object params[]) { - this(msgFormat); - mParams = params; - } - - /** - * Returns the current message format string. - * <P> - * - * @return details message - */ - public String getMessage() { - return mMessage; - } - - /** - * Returns a list of parameters. - * <P> - * - * @return list of message format parameters - */ - public Object[] getParameters() { - return mParams; - } - - /** - * Returns localized message string. This method should - * only be called if a localized string is necessary. - * <P> - * - * @return details message - */ - public String toContent() { - return toContent(Locale.getDefault()); - } - - /** - * Returns the string based on the given locale. - * <P> - * - * @param locale locale - * @return details message - */ - public String toContent(Locale locale) { - return MessageFormatter.getLocalizedString(locale, getBundleName(), - getMessage(), - getParameters()); - } - - /** - * Gets the resource bundle name for this class instance. This should - * be overridden by subclasses who have their own resource bundles. - * - * @param bundle String that represents the resource bundle name to be set - */ - public void setBundleName(String bundle) { - mBundleName = bundle; - } - - /** - * Retrieves bundle name. - * - * @return a String that represents the resource bundle name - */ - protected String getBundleName() { - return mBundleName; - } - - /** - * Retrieves log source. - * - * @return an integer that indicates the component source - * where this message event was triggered - */ - public int getSource() { - return mSource; - } - - /** - * Sets log source. - * - * @param source an integer that represents the component source - * where this message event was triggered - */ - public void setSource(int source) { - mSource = source; - } - - /** - * Retrieves log level. - * The log level of an event represents its relative importance - * or severity within CMS. - * - * @return Integer log level value. - */ - public int getLevel() { - return mLevel; - } - - /** - * Retrieves NT specific log event type. - * - * @return Integer NTEventType value. - */ - public int getNTEventType() { - return mNTEventType; - } - - /** - * Sets log level, NT log event type. - * For certain log levels the NT log event type gets - * set as well. - * - * @param level Integer log level value. - */ - public void setLevel(int level) { - mLevel = level; - switch (level) { - case ILogger.LL_DEBUG: - case ILogger.LL_INFO: - mNTEventType = ILogger.NT_INFO; - break; - - case ILogger.LL_WARN: - mNTEventType = ILogger.NT_WARN; - break; - - case ILogger.LL_FAILURE: - case ILogger.LL_MISCONF: - case ILogger.LL_CATASTRPHE: - case ILogger.LL_SECURITY: - mNTEventType = ILogger.NT_ERROR; - break; - - default: - ConsoleError.send(new SystemEvent(INVALID_LOG_LEVEL, - Integer.toString(level))); - break; - } - } - - /** - * Retrieves log multiline attribute. - * - * @return Boolean whether or not this event is multiline. - * A multiline message simply consists of more than one line. - */ - public boolean getMultiline() { - return mMultiline; - } - - /** - * Sets log multiline attribute. A multiline message consists of - * more than one line. - * - * @param multiline Boolean multiline value. - */ - public void setMultiline(boolean multiline) { - mMultiline = multiline; - } - - /** - * Retrieves event time stamp. - * - * @return Long integer of the time the event was created. - */ - public long getTimeStamp() { - return mTimeStamp; - } - - /** - * Retrieves log event type. Each type of event - * has an associated String type value. - * - * @return String containing the type of event. - */ - public String getEventType() { - return mEventType; - } - - /** - * Sets log event type. Each type of event - * has an associated String type value. - * - * @param eventType String containing the type of event. - */ - public void setEventType(String eventType) { - mEventType = eventType; - } - - /** - * Return string representation of log message. - * - * @return String containing log message. - */ - public String toString() { - if (getBundleName() == null) { - MessageFormat detailMessage = new MessageFormat(mMessage); - - return detailMessage.format(mParams); - //return getMessage(); - } else - return toContent(); - } -} |