com.goldencode.p2j.persist

Class P2JQueryStatistics

java.lang.Object

com.goldencode.p2j.persist.P2JQueryStatistics

public class P2JQueryStatistics
extends java.lang.Object

Class responsible with storing information about P2J Queries. For the moment, only CompoundQuery and RandomAccessQuery support this type of storing statistics.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	P2JQueryStatistics.Key A hashable key comprised of both location information and an FQL string.
private static class	P2JQueryStatistics.Location Helper class which stores location information regarding the construction of a P2J query.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.Map<P2JQuery,P2JQueryStatistics.Location>	locations Map that stores the location of queries.
private static java.util.Map<P2JQueryStatistics.Key,P2JQueryStatistics>	statistics Transient map of query instances to information about where they were constructed.
private double	time The execution time of this query until this moment.
private long	useCount Number of times query was executed at this location (across query instances).

Constructor Summary

Constructors

Modifier	Constructor and Description
private	P2JQueryStatistics() Default constructor.

Method Summary

Modifier and Type	Method and Description
private static P2JQueryStatistics.Location	gatherQueryDetails() Function that navigates the stack trace, identifies details of a query (such as file name, method name, line number) and creates a Location based on those findings.
static java.lang.String	getLocationFormattedOutput(P2JQuery query) Function that returns the location of a query (if one exists), in a ready to be printed format.
static P2JQueryStatistics	getStatistics(P2JQuery query, java.lang.String fql) Function that retrieves/creates the statistics of a query.
double	getTime() Getter for the time field.
long	getUseCount() Get the number of times the FQL query was executed at this location, across all query instances constructed at the same location.
void	increaseTime(double time) Method for increasing the total time of this query by a specified amount.
void	incrementUseCount() Increment by one the number of times the FQL query was executed at this location, across all query instances constructed at the same location.

Methods inherited from class java.lang.Object

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

Field Detail

statistics

private static final java.util.Map<P2JQueryStatistics.Key,P2JQueryStatistics> statistics

Transient map of query instances to information about where they were constructed.

locations

private static final java.util.Map<P2JQuery,P2JQueryStatistics.Location> locations

Map that stores the location of queries.

useCount

private long useCount

Number of times query was executed at this location (across query instances).

time

private double time

The execution time of this query until this moment.

Constructor Detail

P2JQueryStatistics

private P2JQueryStatistics()

Default constructor.

Method Detail

getStatistics

public static P2JQueryStatistics getStatistics(P2JQuery query,
                                               java.lang.String fql)

Function that retrieves/creates the statistics of a query.

Parameters:

query - The query in use.

fql - The FQL of the query.

Returns:

P2JQueryStatistics An instance of P2JQueryStatistics denoting the statistics of the given query.

getLocationFormattedOutput

public static java.lang.String getLocationFormattedOutput(P2JQuery query)

Function that returns the location of a query (if one exists), in a ready to be printed format.

Parameters:

query - The given query.

Returns:

String The formatted string that denotes the location of the query, or null if no such location exists.

getUseCount

public long getUseCount()

Get the number of times the FQL query was executed at this location, across all query instances constructed at the same location.

Returns:

long Query execution count.

incrementUseCount

public void incrementUseCount()

Increment by one the number of times the FQL query was executed at this location, across all query instances constructed at the same location.

getTime

public double getTime()

Getter for the time field.

Returns:

double The execution time of the query until this moment.

increaseTime

public void increaseTime(double time)

Method for increasing the total time of this query by a specified amount.

Parameters:

time - The time that will be added to the total time.

gatherQueryDetails

private static P2JQueryStatistics.Location gatherQueryDetails()

Function that navigates the stack trace, identifies details of a query (such as file name, method name, line number) and creates a Location based on those findings.

Returns:

Location The location of a query.