Package com.iizix.server
Class BinaryTrace
java.lang.Object
com.iizix.server.BinaryTrace
This class is used to trace binary data to an output stream.
- Author:
- Christopher Mindus
Constructor Summary
ConstructorsMethod Summary
Modifier and TypeMethodDescriptionstatic voiddump(SessionInfo si, byte[] buf) static voiddump(SessionInfo si, byte[] buf, boolean isEBCDIC) static voiddump(SessionInfo si, byte[] buf, int length) static voiddump(SessionInfo si, byte[] buf, int length, boolean isEBCDIC) static voiddump(SessionInfo si, byte[] buf, int startingPosition, int length) static voiddump(SessionInfo si, byte[] buf, int startingPosition, int length, boolean isEBCDIC) static voiddump(SessionInfo si, String header) static voiddump(SessionInfo si, String[] headers) static voiddump(SessionInfo si, String header, byte[] buf) static voiddump(SessionInfo si, String header, byte[] buf, boolean isEBCDIC) static voiddump(SessionInfo si, String header, byte[] buf, int length) static voiddump(SessionInfo si, String header, byte[] buf, int length, boolean isEBCDIC) static voiddump(SessionInfo si, String header, byte[] buf, int startingPosition, int length) static voiddump(SessionInfo si, String header, byte[] buf, int startingPosition, int length, boolean isEBCDIC) static voiddump(SessionInfo si, String mainHeading, String[] headers) static voidPrints a line of text to stderr even if redirection is present.static voiderrPrintln(String text) Prints a line of text to stderr even if redirection is present.static longGets the maximum file size of a trace file.static StringgetThousandFormattedNumber(int nn) Gets a thousand-formatted positive number.static StringgetThousandFormattedNumber(long nn) Gets a thousand-formatted positive number.static longGets the current trace file length.static StringThe current trace file name.static voidPrints a line of text to the screen even if redirection is present.static voidPrints a line of text to the screen even if redirection is present.static booleanChanges the trace files.static booleansetMaximumFileSize(long size) Sets the maximum file size of a trace file.static voidsetScreenOutputRedirection(boolean redirect) Redirects stdout and stderr to trace file, or restores the original settings.static voidSets the trace file name.static voidsetTraceFileName(String fn, boolean doAppend) Sets the trace file name.static voidsetupTraceFileNames(String fn1, String fn2) Sets up the two file names used when rotating trace files.
Constructor Details
BinaryTrace
public BinaryTrace()
Method Details
dump
public static void dump(SessionInfo si, String header, byte[] buf, int startingPosition, int length, boolean isEBCDIC) dump
public static void dump(SessionInfo si, byte[] buf, int startingPosition, int length, boolean isEBCDIC) dump
dump
dump
dump
dump
public static void dump(SessionInfo si, String header, byte[] buf, int startingPosition, int length) dump
dump
dump
dump
dump
dump
dump
dump
setupTraceFileNames
Sets up the two file names used when rotating trace files. Note that this method doesn't check if the file names are identical, it is assumed that they aren't.Note: No assignment of file name for tracing is done at this point, call
setTraceFileNamein order to perform this.setTraceFileName
Sets the trace file name. If file name is null, the standard output System.out will be used.- Throws:
IOException- if an I/O error occurs.
setTraceFileName
Sets the trace file name. If file name is null, the standard output System.out will be used.- Throws:
IOException- if an I/O error occurs.
getTraceFileName
The current trace file name.- Returns:
- null if no trace file has been set.
getTraceFileLength
public static long getTraceFileLength()Gets the current trace file length.- Returns:
- -1 if no file is used.
rotateTraceFiles
public static boolean rotateTraceFiles()Changes the trace files.- Returns:
- false for failure, true for success.
setMaximumFileSize
public static boolean setMaximumFileSize(long size) Sets the maximum file size of a trace file. If set to zero, no limit is used.- Returns:
- true successful, false for invalid size (100 KB minimum [102400]).
getMaximumFileSize
public static long getMaximumFileSize()Gets the maximum file size of a trace file. If set to zero, no limit is used.getThousandFormattedNumber
Gets a thousand-formatted positive number.getThousandFormattedNumber
Gets a thousand-formatted positive number.setScreenOutputRedirection
public static void setScreenOutputRedirection(boolean redirect) Redirects stdout and stderr to trace file, or restores the original settings. The output, if redirected, is placed in the trace files.print
Prints a line of text to the screen even if redirection is present.println
Prints a line of text to the screen even if redirection is present.errPrint
Prints a line of text to stderr even if redirection is present.errPrintln
Prints a line of text to stderr even if redirection is present.