org.mases.jcobridge

Class JCFileEventLog

java.lang.Object

org.mases.jcobridge.JCFileEventLog

All Implemented Interfaces:

IJCEventLog

public class JCFileEventLog
extends Object
implements IJCEventLog

File-based implementation of IJCEventLog that appends all bridge diagnostic messages to a text file.

Register an instance with JCOBridge.RegisterEventLog(org.mases.jcobridge.IJCEventLog) to redirect bridge events and fusion log entries to a file. Each message is written on its own line via a BufferedWriter. Write errors are silently swallowed to avoid masking bridge errors with logging failures.

The file is opened (and created if necessary) in the constructor and remains open for the lifetime of this instance. The caller is responsible for flushing or closing the underlying writer if unflushed data must be persisted before the process exits.

Example:

 JCOBridge bridge = JCOBridge.CreateNew();
 bridge.RegisterEventLog(new JCFileEventLog("/var/log/jcobridge.log"));
 

Since:

1.0.0.0

Author:

MASES S.R.L.

Constructor Summary

Constructors

Constructor and Description
JCFileEventLog(String fileName) Opens (or creates) the log file at the given path and prepares the buffered writer.

Method Summary

Modifier and Type	Method and Description
void	EventLog(String msg) Receives a general bridge diagnostic event message and appends it to the log file.
void	FusionLog(String msg) Receives a CLR assembly fusion log message and appends it to the log file.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JCFileEventLog

public JCFileEventLog(String fileName)
               throws IOException

Opens (or creates) the log file at the given path and prepares the buffered writer.

Parameters:

fileName - the path to the log file.

Throws:

IOException - if the file cannot be opened or created.

Method Detail

FusionLog

public void FusionLog(String msg)

Receives a CLR assembly fusion log message and appends it to the log file. Fusion log messages are emitted by the CLR assembly resolver when probing for assemblies — useful for diagnosing assembly-not-found or version-mismatch errors. Write errors are silently swallowed.

Specified by:

FusionLog in interface IJCEventLog

Parameters:

msg - the fusion log message from the CLR assembly resolver.

EventLog

public void EventLog(String msg)

Receives a general bridge diagnostic event message and appends it to the log file. Write errors are silently swallowed.

Specified by:

EventLog in interface IJCEventLog

Parameters:

msg - the diagnostic message from the JCOBridge runtime.