JProfiler 도움말Download

JProfiler에서의 스크립트

JProfiler의 내장 스크립트 편집기를 사용하면 JProfiler GUI의 다양한 위치에서 사용자 정의 로직을 입력할 수 있습니다. 여기에는 사용자 정의 프로브 구성, 분할 메소드, 힙 워커 필터 등이 포함됩니다.

편집 영역 위의 상자는 스크립트의 사용 가능한 매개변수와 반환 유형을 보여줍니다. 메뉴에서 도움말→Javadoc 개요 보기를 호출하여 com.jprofiler.api.* 패키지의 클래스에 대한 추가 정보를 얻을 수 있습니다.

여러 패키지는 완전한 클래스 이름을 사용하지 않고도 사용할 수 있습니다. 이러한 패키지는 다음과 같습니다:

  • java.util.*
  • java.io.*

완전한 클래스 이름 사용을 피하기 위해 텍스트 영역의 첫 줄에 여러 import 문을 넣을 수 있습니다.

모든 스크립트는 스크립트의 연속 호출 간에 상태를 저장할 수 있는 com.jprofiler.api.agent.ScriptContext의 인스턴스를 전달받습니다.

최대 편집기 기능을 얻으려면 일반 설정에서 JDK를 구성하는 것이 좋습니다. 기본적으로 JProfiler가 실행되는 JRE가 사용됩니다. 이 경우 코드 완성은 JRE의 클래스에 대한 매개변수 이름과 Javadoc을 제공하지 않습니다.

스크립트 유형

스크립트는 표현식일 수 있습니다. 표현식은 후행 세미콜론이 없으며 필요한 반환 유형으로 평가됩니다. 예를 들어, 

object.toString().contains("test")

힙 워커의 나가는 참조 뷰에서 필터 스크립트로 작동합니다.

또는 스크립트는 일련의 Java 문으로 구성되며 마지막 문으로 필요한 반환 유형의 return 문이 포함됩니다: 

import java.lang.management.ManagementFactory;
return ManagementFactory.getRuntimeMXBean().getUptime();

위의 예는 스크립트 텔레메트리에 적합합니다. JProfiler는 표현식이나 스크립트를 입력했는지 자동으로 감지합니다.

이전에 입력한 스크립트를 재사용하려면 스크립트 기록에서 선택할 수 있습니다.  기록 보기 도구 모음 버튼을 클릭하면 이전에 사용한 모든 스크립트가 표시됩니다. 스크립트는 스크립트 서명별로 정리되며 현재 스크립트 서명이 기본적으로 선택됩니다.

코드 완성

CTRL-Space를 누르면 코드 완성 제안이 포함된 팝업이 나타납니다. 또한, 점(".")을 입력하면 다른 문자가 입력되지 않을 경우 지연 후에 이 팝업이 표시됩니다. 지연 시간은 편집기 설정에서 구성할 수 있습니다. 팝업이 표시되는 동안 Backspace로 문자를 계속 입력하거나 삭제할 수 있으며 팝업은 이에 따라 업데이트됩니다. "Camel-hump" 완성이 지원됩니다. 예를 들어, NPE를 입력하고 CTRL-Space를 누르면 java.lang.NullPointerException을 포함한 다른 클래스가 제안됩니다. 자동으로 import되지 않는 클래스를 수락하면 완전한 이름이 삽입됩니다.

자동 완성 팝업은 다음을 제안할 수 있습니다:

  • 변수 및 스크립트 매개변수. 스크립트 매개변수는 굵은 글꼴로 표시됩니다.
  • import 문을 입력할 때 패키지
  • 클래스
  • 클래스가 컨텍스트일 때 필드
  • 클래스 또는 메소드의 매개변수 목록이 컨텍스트일 때 메소드

구성된 세션 클래스 경로나 구성된 JDK에 포함되지 않은 클래스가 있는 매개변수는 [unresolved]로 표시되며 일반 java.lang.Object 유형으로 변경됩니다. 이러한 매개변수에 메소드를 호출하고 코드 완성을 받으려면 누락된 JAR 파일을 애플리케이션 설정의 클래스 경로에 추가하십시오.

문제 분석

입력한 코드는 실시간으로 분석되어 오류 및 경고 조건을 확인합니다. 오류는 편집기에서 빨간색 밑줄로 표시되고 오른쪽 여백에 빨간색 줄무늬로 표시됩니다. 사용되지 않는 변수 선언과 같은 경고는 편집기에서 노란색 배경으로 표시되고 여백에 노란색 줄무늬로 표시됩니다. 편집기에서 오류나 경고 위에 마우스를 올리거나 여백 영역의 줄무늬 위에 마우스를 올리면 오류 또는 경고 메시지가 표시됩니다.

오른쪽 여백 상단의 상태 표시기는 코드에 경고나 오류가 없으면 녹색, 경고가 있으면 노란색, 오류가 발견되면 빨간색입니다. 편집기 설정에서 문제 분석의 임계값을 구성할 수 있습니다.

대화 상자의 오른쪽 상단 모서리에 있는 여백 아이콘이 녹색이면 편집기 설정에서 오류 분석을 비활성화하지 않는 한 스크립트가 컴파일됩니다. 일부 상황에서는 실제 컴파일을 시도해 볼 수 있습니다. 메뉴에서 코드→테스트 컴파일을 선택하면 스크립트를 컴파일하고 별도의 대화 상자에 오류를 표시합니다. 확인 버튼으로 스크립트를 저장해도 스크립트가 바로 사용되지 않는 한 스크립트의 구문적 정확성을 테스트하지 않습니다.

키 바인딩

SHIFT-F1을 누르면 커서 위치의 요소를 설명하는 Javadoc 페이지가 브라우저에서 열립니다. Java 런타임 라이브러리에 대한 Javadoc은 코드 편집기의 일반 설정에서 유효한 Javadoc 위치가 있는 JDK가 구성된 경우에만 표시할 수 있습니다.

Java 코드 편집기의 모든 키 바인딩은 구성할 수 있습니다. 창 메뉴에서 설정→키 맵을 선택하여 키 맵 편집기를 표시합니다. 키 바인딩은 파일 $HOME/.jprofiler15/editor_keymap.xml에 저장됩니다. 이 파일은 기본 키 맵이 복사된 경우에만 존재합니다. JProfiler 설치를 다른 컴퓨터로 마이그레이션할 때 이 파일을 복사하여 키 바인딩을 보존할 수 있습니다.