Package daikon.tools

Class DtracePartitioner

Object

DtracePartitioner

All Implemented Interfaces:

Closeable, AutoCloseable, Iterator<String>, Partitioner<String,String>

public class DtracePartitioner
extends Object
implements Closeable, Partitioner<String,String>, Iterator<String>

This class partitions Daikon trace files so that invocations of the same program point are grouped together for use with random selection.

Constructor Summary

Constructors

Constructor	Description
DtracePartitioner(String filename)

Method Summary

Modifier and Type	Method	Description
String	assignToBucket(String invocation)	Returns the program point name given by the input invocation.
void	close()	Releases resources held by this.
boolean	hasNext()
String	next()
List<String>	patchValues(List<String> enters)	Same as patchValues(List, boolean) with second arg=false.
List<String>	patchValues(List<String> enters, boolean includeUnreturnedEnters)	Finds the exits that correspond to Enters.
void	remove()	Not implemented, because this class does not modify the underlying trace file.

Methods inherited from class Object

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

Methods inherited from interface Iterator

forEachRemaining

Constructor Detail

DtracePartitioner

public DtracePartitioner(String filename)

Parameters:

filename - the Daikon trace file to be partitioned

Method Detail

close

public void close(@GuardSatisfied DtracePartitioner this)
           throws IOException

Releases resources held by this.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

hasNext

public boolean hasNext(@GuardSatisfied DtracePartitioner this)

Specified by:

hasNext in interface Iterator<String>

remove

public void remove(@GuardSatisfied DtracePartitioner this)

Not implemented, because this class does not modify the underlying trace file.

Specified by:

remove in interface Iterator<String>

next

public String next(@GuardSatisfied DtracePartitioner this)

Specified by:

next in interface Iterator<String>

assignToBucket

public String assignToBucket(String invocation)

Returns the program point name given by the input invocation.

Specified by:

assignToBucket in interface Partitioner<String,String>

patchValues

public List<String> patchValues(List<String> enters)

Same as patchValues(List, boolean) with second arg=false.

Parameters:

enters - a list of program point names

Returns:

an ArrayList containing all of the elements of 'enters'. The original order is NOT guaranteed.

patchValues

public List<String> patchValues(List<String> enters,
                                boolean includeUnreturnedEnters)

Finds the exits that correspond to Enters.

Modifies: none

Parameters:

enters - a list of program point names

includeUnreturnedEnters - ensures that any ENTER ppt invocations will definitely have a corresponding EXIT ppt invocation following them

Returns:

an ArrayList containing all of the elements of 'enters'. The original order is NOT guaranteed.