com.tagtraum.perf.gcviewer.imp

Class AbstractDataReaderSun

java.lang.Object

com.tagtraum.perf.gcviewer.imp.AbstractDataReader

com.tagtraum.perf.gcviewer.imp.AbstractDataReaderSun

All Implemented Interfaces:

DataReader

Direct Known Subclasses:

DataReaderSun1_3_1, DataReaderSun1_6_0, DataReaderSun1_6_0G1

public abstract class AbstractDataReaderSun
extends AbstractDataReader

The AbstractDataReaderSun is the base class of most Sun / Oracle parser implementations.

It contains a lot of helper methods to do the actual parsing of the details of a gc event. New parsers for Sun / Oracle gc algorithms should derive from this class.

Author:

Hendrik Schreiber, Joerg Wuethrich

Field Summary

Fields

Modifier and Type	Field and Description
protected GcLogType	gcLogType the log type allowing for small differences between different versions of the gc logs
protected static String	LOG_INFORMATION_COMMANDLINE_FLAGS
protected static String	LOG_INFORMATION_HOTSPOT
protected static String	LOG_INFORMATION_MEMORY
protected static String	LOG_INFORMATION_OPENJDK
protected static List<String>	LOG_INFORMATION_STRINGS
protected static String	LOGFILE_ROLLING_BEGIN
protected static String	LOGFILE_ROLLING_END

Fields inherited from class com.tagtraum.perf.gcviewer.imp.AbstractDataReader

gcResource, in

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDataReaderSun(GCResource gcResource, InputStream in, GcLogType gcLogType) Create an instance of this class passing an inputStream and the type of the logfile.

Method Summary

Modifier and Type	Method and Description
protected boolean	contains(String line, List<String> lineContainsStrings, boolean trimLine) Tests if line starts with one of the strings in lineStartStrings.
protected AbstractGCEvent.ExtendedType	extractTypeFromParsedString(String typeName)
protected double	getTimestamp(String line, ParseInformation pos, ZonedDateTime datestamp) If the next thing in line is a timestamp, it is parsed and returned.
protected boolean	hasNextDetail(String line, ParseInformation pos)
protected boolean	nextCharIsBracket(String line, ParseInformation pos)
protected boolean	nextIsDatestamp(String line, ParseInformation pos) Returns true if text at parsePosition is a datestamp.
protected boolean	nextIsTimestamp(String line, ParseInformation pos) Returns true, if next "token" is a timestamp.
protected ZonedDateTime	parseDatestamp(String line, ParseInformation pos) Parses a datestamp in line at pos.
protected void	parseDetailEventsIfExist(String line, ParseInformation pos, GCEvent event) Parses detail events if any exist at current pos in line.
protected abstract AbstractGCEvent<?>	parseLine(String line, ParseInformation pos)
protected double	parsePause(String line, ParseInformation pos)
protected AbstractGCEvent.ExtendedType	parseType(String line, ParseInformation pos)
protected String	parseTypeString(String line, ParseInformation pos)
protected void	setMemory(AbstractGCEvent<?> event, String line, ParseInformation pos)
protected void	setMemoryAndPauses(GCEvent event, String line) Convenience method to parse memory information followed by a pause time.
protected void	setMemoryAndPauses(GCEvent event, String line, ParseInformation pos) Parses memory information in the format <number>KB-><number>KB(<number>KB), <number>ms
protected void	setMemoryExtended(GCEvent event, String line, ParseInformation pos) Parses a memory information with the following form: 8192K[(16M)]->7895K[(16M)] ("[...]" means optional).
protected void	skipLines(LineNumberReader in, ParseInformation pos, List<String> lineStartStrings) Skips a block of lines containing information like they are generated by -XX:+PrintHeapAtGC or -XX:+PrintAdaptiveSizePolicy.
protected boolean	startsWith(String line, List<String> lineStartStrings, boolean trimLine) Tests if line starts with one of the strings in lineStartStrings.

Methods inherited from class com.tagtraum.perf.gcviewer.imp.AbstractDataReader

getDataReaderTools, getLogger, read, shouldContinue

Methods inherited from class java.lang.Object

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

Field Detail

LOG_INFORMATION_OPENJDK

protected static final String LOG_INFORMATION_OPENJDK

See Also:

Constant Field Values

LOG_INFORMATION_HOTSPOT

protected static final String LOG_INFORMATION_HOTSPOT

See Also:

Constant Field Values

LOG_INFORMATION_MEMORY

protected static final String LOG_INFORMATION_MEMORY

See Also:

Constant Field Values

LOG_INFORMATION_COMMANDLINE_FLAGS

protected static final String LOG_INFORMATION_COMMANDLINE_FLAGS

See Also:

Constant Field Values

LOGFILE_ROLLING_BEGIN

protected static final String LOGFILE_ROLLING_BEGIN

See Also:

Constant Field Values

LOGFILE_ROLLING_END

protected static final String LOGFILE_ROLLING_END

See Also:

Constant Field Values

LOG_INFORMATION_STRINGS

protected static final List<String> LOG_INFORMATION_STRINGS

gcLogType

protected GcLogType gcLogType

the log type allowing for small differences between different versions of the gc logs

Constructor Detail

AbstractDataReaderSun

protected AbstractDataReaderSun(GCResource gcResource,
                                InputStream in,
                                GcLogType gcLogType)
                         throws UnsupportedEncodingException

Create an instance of this class passing an inputStream and the type of the logfile.

Parameters:

gcResource - information about the resource to be parsed

in - inputstream to the log file

gcLogType - type of the logfile

Throws:

UnsupportedEncodingException - if ASCII is not supported

Method Detail

setMemoryAndPauses

protected void setMemoryAndPauses(GCEvent event,
                                  String line)
                           throws ParseException

Convenience method to parse memory information followed by a pause time.

Parameters:

event - event where the result should be written to

line - line to be parsed (from the beginning)

Throws:

ParseException - is thrown to report any problems the parser runs into

See Also:

setMemoryAndPauses(GCEvent, String, ParseInformation)

setMemoryAndPauses

protected void setMemoryAndPauses(GCEvent event,
                                  String line,
                                  ParseInformation pos)
                           throws ParseException

Parses memory information in the format <number>KB-><number>KB(<number>KB), <number>ms

Parameters:

event - event where result of parsing is to be stored

line - line to be parsed

pos - position where parsing should start

Throws:

ParseException - is thrown to report any problems the parser runs into

setMemoryExtended

protected void setMemoryExtended(GCEvent event,
                                 String line,
                                 ParseInformation pos)
                          throws ParseException

Parses a memory information with the following form: 8192K[(16M)]->7895K[(16M)] ("[...]" means optional).

Parameters:

event - event, where parsed information should be stored

line - line to be parsed

pos - current parse position; all characters between current position and next digits will be skipped

Throws:

ParseException - parsing was not possible

setMemory

protected void setMemory(AbstractGCEvent<?> event,
                         String line,
                         ParseInformation pos)
                  throws ParseException

Throws:

ParseException

parsePause

protected double parsePause(String line,
                            ParseInformation pos)
                     throws ParseException

Throws:

ParseException

hasNextDetail

protected boolean hasNextDetail(String line,
                                ParseInformation pos)
                         throws ParseException

Throws:

ParseException

nextCharIsBracket

protected boolean nextCharIsBracket(String line,
                                    ParseInformation pos)
                             throws ParseException

Throws:

ParseException

parseTypeString

protected String parseTypeString(String line,
                                 ParseInformation pos)
                          throws ParseException

Throws:

ParseException

parseType

protected AbstractGCEvent.ExtendedType parseType(String line,
                                                 ParseInformation pos)
                                          throws ParseException

Throws:

ParseException

extractTypeFromParsedString

protected AbstractGCEvent.ExtendedType extractTypeFromParsedString(String typeName)

nextIsTimestamp

protected boolean nextIsTimestamp(String line,
                                  ParseInformation pos)

Returns true, if next "token" is a timestamp.

Parameters:

line - line to be parsed

pos - current position in line

Returns:

true if next is timestamp, false otherwise

getTimestamp

protected double getTimestamp(String line,
                              ParseInformation pos,
                              ZonedDateTime datestamp)
                       throws ParseException

If the next thing in line is a timestamp, it is parsed and returned. If there is no timestamp present, the timestamp is calculated

Parameters:

line - current line

pos - current parse positition

datestamp - datestamp that may have been parsed

Returns:

timestamp (either parsed or derived from datestamp)

Throws:

ParseException - it seemed to be a timestamp but still couldn't be parsed

parseLine

protected abstract AbstractGCEvent<?> parseLine(String line,
                                                ParseInformation pos)
                                         throws ParseException

Throws:

ParseException

startsWith

protected boolean startsWith(String line,
                             List<String> lineStartStrings,
                             boolean trimLine)

Tests if line starts with one of the strings in lineStartStrings. If trimLine is true, then line is trimmed first.

Parameters:

line - line to be checked against

lineStartStrings - list of strings to check

trimLine - if true then trim line

Returns:

true, if line starts with one of the strings in lineStartStrings

See Also:

contains(String, List, boolean)

contains

protected boolean contains(String line,
                           List<String> lineContainsStrings,
                           boolean trimLine)

Tests if line starts with one of the strings in lineStartStrings. If trimLine is true, then line is trimmed first.

Parameters:

line - line to be checked against

lineContainsStrings - list of strings to check

trimLine - if true then trim line

Returns:

true, if line contains one of the strings in lineContainsStrings

See Also:

startsWith(String, List, boolean)

parseDatestamp

protected ZonedDateTime parseDatestamp(String line,
                                       ParseInformation pos)
                                throws ParseException

Parses a datestamp in line at pos.

Parameters:

line - current line.

pos - current parse position.

Returns:

returns parsed datestamp if found one, null otherwise.

Throws:

ParseException - if line could not be parsed.

nextIsDatestamp

protected boolean nextIsDatestamp(String line,
                                  ParseInformation pos)

Returns true if text at parsePosition is a datestamp.

Parameters:

line - current line

pos - current parse position

Returns:

true if in current line at current parse position we have a datestamp

parseDetailEventsIfExist

protected void parseDetailEventsIfExist(String line,
                                        ParseInformation pos,
                                        GCEvent event)
                                 throws ParseException

Parses detail events if any exist at current pos in line.

Parameters:

line - current line

pos - current parse position

event - enclosing event

Throws:

ParseException - some problem when parsing the detail event

skipLines

protected void skipLines(LineNumberReader in,
                         ParseInformation pos,
                         List<String> lineStartStrings)
                  throws IOException

Skips a block of lines containing information like they are generated by -XX:+PrintHeapAtGC or -XX:+PrintAdaptiveSizePolicy.

Parameters:

in - inputStream of the current log to be read

pos - current parse position

lineStartStrings - lines starting with these strings should be ignored

Throws:

IOException - problem with reading from the file