001: /*
002: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
003: *
004: * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
005: *
006: * The contents of this file are subject to the terms of either the GNU
007: * General Public License Version 2 only ("GPL") or the Common
008: * Development and Distribution License("CDDL") (collectively, the
009: * "License"). You may not use this file except in compliance with the
010: * License. You can obtain a copy of the License at
011: * http://www.netbeans.org/cddl-gplv2.html
012: * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
013: * specific language governing permissions and limitations under the
014: * License. When distributing the software, include this License Header
015: * Notice in each file and include the License file at
016: * nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
017: * particular file as subject to the "Classpath" exception as provided
018: * by Sun in the GPL Version 2 section of the License file that
019: * accompanied this code. If applicable, add the following below the
020: * License Header, with the fields enclosed by brackets [] replaced by
021: * your own identifying information:
022: * "Portions Copyrighted [year] [name of copyright owner]"
023: *
024: * Contributor(s):
025: * The Original Software is NetBeans. The Initial Developer of the Original
026: * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
027: * Microsystems, Inc. All Rights Reserved.
028: *
029: * If you wish your version of this file to be governed by only the CDDL
030: * or only the GPL Version 2, indicate your decision by adding
031: * "[Contributor] elects to include this software in this distribution
032: * under the [CDDL or GPL Version 2] license." If you do not indicate a
033: * single choice of license, a recipient has the option to distribute
034: * your version of this file under either the CDDL, the GPL Version 2 or
035: * to extend the choice of license to its licensees as provided above.
036: * However, if you add GPL Version 2 code and therefore, elected the GPL
037: * Version 2 license, then the option applies only if the new code is
038: * made subject to such option by the copyright holder.
039: */
040:
041: package org.netbeans.lib.profiler.ui.cpu;
042:
043: import org.netbeans.lib.profiler.results.CCTNode;
044: import org.netbeans.lib.profiler.results.cpu.CPUResultsSnapshot;
045:
046: /**
047: * This interface declares actions that the user may initiate when browsing profiling results.
048: * For example, the user may move the cursor to some method and request the tool to show its source
049: * code, etc.
050: *
051: * @author Ian Formanek
052: * @author Misha Dmitriev
053: */
054: public interface CPUResUserActionsHandler {
055: //~ Inner Classes ------------------------------------------------------------------------------------------------------------
056:
057: public static class Adapter implements CPUResUserActionsHandler {
058: //~ Methods --------------------------------------------------------------------------------------------------------------
059:
060: public void addMethodToRoots(String className,
061: String methodName, String methodSig) {
062: throw new UnsupportedOperationException();
063: }
064:
065: public void find(Object source, String findString) {
066: throw new UnsupportedOperationException();
067: }
068:
069: public void showReverseCallGraph(CPUResultsSnapshot snapshot,
070: int threadId, int methodId, int view,
071: int sortingColumn, boolean sortingOrder) {
072: throw new UnsupportedOperationException();
073: }
074:
075: public void showSourceForMethod(String className,
076: String methodName, String methodSig) {
077: throw new UnsupportedOperationException();
078: }
079:
080: public void showSubtreeCallGraph(CPUResultsSnapshot snapshot,
081: CCTNode node, int view, int sortingColumn,
082: boolean sortingOrder) {
083: throw new UnsupportedOperationException();
084: }
085:
086: public void viewChanged(int viewType) {
087: }
088: }
089:
090: //~ Methods ------------------------------------------------------------------------------------------------------------------
091:
092: public void addMethodToRoots(String className, String methodName,
093: String methodSig);
094:
095: public void find(Object source, String findString);
096:
097: public void showReverseCallGraph(CPUResultsSnapshot snapshot,
098: int threadId, int methodId, int view, int sortingColumn,
099: boolean sortingOrder);
100:
101: /**
102: * Display the source for the given method. className should never be null, but methodName and methodSig
103: * may be null (for example, if we are viewing results at class level). In that case, just the class
104: * source code should be displayed.
105: * @param className The fully qualified class name in VM format ("org/profiler/Main");
106: * @param methodName The method name
107: * @param methodSig The method signature in VM format
108: */
109: public void showSourceForMethod(String className,
110: String methodName, String methodSig);
111:
112: public void showSubtreeCallGraph(CPUResultsSnapshot snapshot,
113: CCTNode node, int view, int sortingColumn,
114: boolean sortingOrder);
115:
116: /**
117: * Called when a view type change has been initiated from within a results component and the change should perhaps
118: * be reflected in other views / ui as well.
119: *
120: * @param viewType the new view type
121: */
122: public void viewChanged(int viewType);
123: }
|