/* * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (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.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.apache.log4j.nt; import org.apache.log4j.AppenderSkeleton; import org.apache.log4j.Layout; import org.apache.log4j.TTCCLayout; import org.apache.log4j.helpers.LogLog; import org.apache.log4j.spi.LoggingEvent; /** Append to the NT event log system.
WARNING This appender can only be installed and used on a Windows system.
Do not forget to place the file NTEventLogAppender.dll in a
directory that is on the PATH of the Windows system. Otherwise, you
will get a java.lang.UnsatisfiedLinkError.
@author Chris Taylor
@author Jim Cakalic */
public class NTEventLogAppender extends AppenderSkeleton {
private int _handle = 0;
private String source = null;
private String server = null;
public NTEventLogAppender() {
this(null, null, null);
}
public NTEventLogAppender(String source) {
this(null, source, null);
}
public NTEventLogAppender(String server, String source) {
this(server, source, null);
}
public NTEventLogAppender(Layout layout) {
this(null, null, layout);
}
public NTEventLogAppender(String source, Layout layout) {
this(null, source, layout);
}
public NTEventLogAppender(String server, String source, Layout layout) {
if (source == null) {
source = "Log4j";
}
if (layout == null) {
this.layout = new TTCCLayout();
} else {
this.layout = layout;
}
try {
_handle = registerEventSource(server, source);
} catch (Exception e) {
e.printStackTrace();
_handle = 0;
}
}
public
void close() {
// unregister ...
}
public
void activateOptions() {
if (source != null) {
try {
_handle = registerEventSource(server, source);
} catch (Exception e) {
LogLog.error("Could not register event source.", e);
_handle = 0;
}
}
}
public void append(LoggingEvent event) {
StringBuffer sbuf = new StringBuffer();
sbuf.append(layout.format(event));
if(layout.ignoresThrowable()) {
String[] s = event.getThrowableStrRep();
if (s != null) {
int len = s.length;
for(int i = 0; i < len; i++) {
sbuf.append(s[i]);
}
}
}
// Normalize the log message level into the supported categories
int nt_category = event.getLevel().toInt();
// Anything above FATAL or below DEBUG is labeled as INFO.
//if (nt_category > FATAL || nt_category < DEBUG) {
// nt_category = INFO;
//}
reportEvent(_handle, sbuf.toString(), nt_category);
}
public
void finalize() {
deregisterEventSource(_handle);
_handle = 0;
}
/**
The Source option which names the source of the event. The
current value of this constant is Source.
*/
public
void setSource(String source) {
this.source = source.trim();
}
public
String getSource() {
return source;
}
/**
The NTEventLogAppender
requires a layout. Hence,
this method always returns true
. */
public
boolean requiresLayout() {
return true;
}
native private int registerEventSource(String server, String source);
native private void reportEvent(int handle, String message, int level);
native private void deregisterEventSource(int handle);
static {
System.loadLibrary("NTEventLogAppender");
}
}