bloritsch 01/12/13 12:37:13
Modified: src/scratchpad/org/apache/avalon/excalibur/profile
AbstractProfilePoint.java CSVProfiler.java
EventsPerSampleProfilePoint.java
PeekValueProfilePoint.java Profilable.java
ProfilePoint.java Profiler.java
ValueProfilePoint.java
Log:
Add support for heirarchical names
Revision Changes Path
1.2 +1 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/AbstractProfilePoint.java
Index: AbstractProfilePoint.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/AbstractProfilePoint.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- AbstractProfilePoint.java 2001/12/13 19:36:47 1.1
+++ AbstractProfilePoint.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
/**
* The ProfilPoint interface is to mark objects that can be sampled by a
1.2 +1 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/CSVProfiler.java
Index: CSVProfiler.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/CSVProfiler.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- CSVProfiler.java 2001/12/13 19:36:47 1.1
+++ CSVProfiler.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
import java.io.File;
import java.io.IOException;
1.2 +1 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/EventsPerSampleProfilePoint.java
Index: EventsPerSampleProfilePoint.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/EventsPerSampleProfilePoint.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- EventsPerSampleProfilePoint.java 2001/12/13 19:36:47 1.1
+++ EventsPerSampleProfilePoint.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
/**
* The ProfilPoint interface is to mark objects that can be sampled by a
1.2 +1 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/PeekValueProfilePoint.java
Index: PeekValueProfilePoint.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/PeekValueProfilePoint.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- PeekValueProfilePoint.java 2001/12/13 19:36:47 1.1
+++ PeekValueProfilePoint.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
/**
* The ProfilPoint interface is to mark objects that can be sampled by a
1.2 +8 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/Profilable.java
Index: Profilable.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/Profilable.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Profilable.java 2001/12/13 19:36:47 1.1
+++ Profilable.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
/**
* The Profilable interface is to mark objects that can be sampled by a
Profiler.
@@ -17,6 +17,13 @@
*/
public interface Profilable
{
+ /**
+ * Override the default name for a Profilable. This is called by a
container
+ * override what the Profilable object thinks it's own name should be.
This
+ * approach makes it possible to have hierarchical naming schemes.
+ */
+ void setName( String name );
+
/**
* Obtain a reference to all the ProfilePoints that the Profilable
* object wishes to expose. All sampling is done directly through
1.2 +1 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/ProfilePoint.java
Index: ProfilePoint.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/ProfilePoint.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ProfilePoint.java 2001/12/13 19:36:47 1.1
+++ ProfilePoint.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
/**
* The ProfilPoint interface is to mark objects that can be sampled by a
1.2 +15 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/Profiler.java
Index: Profiler.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/Profiler.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Profiler.java 2001/12/13 19:36:47 1.1
+++ Profiler.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
import java.io.File;
import java.io.IOException;
@@ -17,6 +17,20 @@
* so that performance or resource usage can be assertained. The sample
duration
* is dependant on the Profiler's settings, and should never change during
the
* time the Profiler is running.
+ *
+ * <p>
+ * Please do respect that for more accurate statistical information, the
first
+ * and last sample must be thrown out. The first sample may have residual
+ * information from before the test, and the last sample may be from an
+ * incomplete timeslice. For instance, if the Profiler obtains a sample
once
+ * every second, and it stops itself 500ms after the previous sample, the
last
+ * sample will only represent 1/2 the typical timeslice.
+ * </p>
+ * <p>
+ * Please also bear in mind that Java has a non-deterministic scheduler,
and
+ * samples may not be taken exactly on the specified interval. This sample
+ * <em>jitter</em> is acceptable when averaged over a longer period of
time.
+ * </p>
*
* @author <a href="mailto:[EMAIL PROTECTED]">Berin Loritsch</a>
*/
1.2 +1 -1
jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/ValueProfilePoint.java
Index: ValueProfilePoint.java
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/profile/ValueProfilePoint.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ValueProfilePoint.java 2001/12/13 19:36:47 1.1
+++ ValueProfilePoint.java 2001/12/13 20:37:13 1.2
@@ -5,7 +5,7 @@
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE.txt file.
*/
-package org.apache.avalon.framework.profile;
+package org.apache.avalon.excalibur.profile;
/**
* The ProfilPoint interface is to mark objects that can be sampled by a
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
