public static boolean isActive() 
{
        return active;
}

Determine if profiling is being activated, by searching for a system property 'xwork.profile.activate', default to false (profiling is off).

 public static  void pop(String name) 
{
        if (!isActive())
            return;
        ProfilingTimerBean currentTimer = (ProfilingTimerBean) current.get();
        //if the timers are matched up with each other (ie push("a"); pop("a"));
        if (currentTimer != null && name != null && name.equals(currentTimer.getResource()))
        {
            currentTimer.setEndTime();
            ProfilingTimerBean parent = currentTimer.getParent();
            //if we are the root timer, then print out the times
            if (parent == null)
            {
                printTimes(currentTimer);
                current.set(null); //for those servers that use thread pooling
            }
            else
            {
                current.set(parent);
            }
        }
        else
        {
            //if timers are not matched up, then print what we have, and then print warning.
            if (currentTimer != null)
            {
                printTimes(currentTimer);
                current.set(null); //prevent printing multiple times
                LOG.warn("Unmatched Timer.  Was expecting " + currentTimer.getResource() + ", instead got " + name);
            }
        }
}

End a preformance profiling with the name given. Deal with profile hierarchy automatically, so caller don't have to be concern about it.

 public static T profile(String name,
    ProfilingBlock<T> block) throws Exception 
{
    	UtilTimerStack.push(name);
    	try {
    		return block.doProfiling();
    	}
    	finally {
    		UtilTimerStack.pop(name);
    	}
}

A convenience method that allows block of code subjected to profiling to be executed and avoid the need of coding boiler code that does pushing (UtilTimeBean.push(...)) and poping (UtilTimerBean.pop(...)) in a try ... finally ... block.

Example of usage:

	 // we need a returning result
  String result = UtilTimerStack.profile("purchaseItem: ", 
      new UtilTimerStack.ProfilingBlock() {
           public String doProfiling() {
              getMyService().purchaseItem(....)
              return "Ok";
           }
      });

or

  // we don't need a returning result
  UtilTimerStack.profile("purchaseItem: ", 
      new UtilTimerStack.ProfilingBlock() {
           public String doProfiling() {
              getMyService().purchaseItem(....)
              return null;
           }
      });

 public static  void push(String name) 
{
        if (!isActive())
            return;
        //create a new timer and start it
        ProfilingTimerBean newTimer = new ProfilingTimerBean(name);
        newTimer.setStartTime();
        //if there is a current timer - add the new timer as a child of it
        ProfilingTimerBean currentTimer = (ProfilingTimerBean) current.get();
        if (currentTimer != null)
        {
            currentTimer.addChild(newTimer);
        }
        //set the new timer to be the current timer
        current.set(newTimer);
}

Create and start a performance profiling with the name given. Deal with profile hierarchy automatically, so caller don't have to be concern about it.

 public static  void setActive(boolean active) 
{
        if (active)
            System.setProperty(ACTIVATE_PROPERTY, "true");
        else
        	System.clearProperty(ACTIVATE_PROPERTY);
        UtilTimerStack.active = active;
}

Turn profiling on or off.