jb2works.com
>
Reference Scanner
>
How to start
eng
|
de
Wie man Reference Scanner startet
System Requirement ist Sun's Java Runtime Environment Version 5 oder neuer,
fuer Win32, Win64, Linux32 oder Linux64.
Play around
Lade das Reference Scanner .zip File herunter und packe es irgendwohin aus.
Gehe hinein in den extrahierten 'jb2refscan' Folder, starte 'setup-example.bat' / linux: setup-example.sh.
Dieses Script gibt die erforderlichen JVM-Argumente fuer Reference Scanner auf der Konsole aus.
Es erzeugt und startet ein Unterscript 'run-example.bat' / linux: run-example.sh.
Gib nun in den Webbrowser ein: http://localhost:4040/.
Wie man die eigene Applikation startet
Um Reference Scanner fuer die eigene Java Applikation zu verwenden, addieren Sie einige wenige JVM Argumente zur
Run-Konfiguration. Es ist nicht erforderlich, irgend etwas am Class- oder Build-Path zu aendern.
Tip: Kopieren Sie erforderlichen Jvm-Argumente einfach vom Script 'run-example.bat'/.sh -
Siehe oben: 'Play around'.
Mandatory JVM Arguments fuer Windows
|
-javaagent:/path/to/jb2refscan.jar
-Xbootclasspath/p:/path/to/jb2agent.jar
-agentpath:/path/to/jb2agent32.dll // oder 64 bei Benutzung eines 64 bit JDK's
|
Mandatory JVM Arguments fuer Linux
|
-javaagent:/path/to/jb2refscan.jar
-Xbootclasspath/p:/path/to/jb2agent.jar
-agentpath:/path/to/libjb2agent32.so // oder 64 bei Benutzung eines 64 bit JDK's
|
Starten Sie die Applikation nach Anpassung der Run-Konfiguration geben Sie im lokalen Webbrowser ein:
http://localhost:4040/ .
Optionale JVM Args
|
-Drefscan.start.recording // um Call Graph Recording schon bei JVM Start zu starten
-Drefscan.port=XXXX // um einen anderen Port als Default 4040 anzugeben
|
Reference Scanner beinhaltet bei Default keine System-Calls um nicht mehr Information als noetig aufzuzeichnen:
System-Packages wie java.*, javax.*, com.sun.* werden nicht angezeigt.
Sie koennen diese Calls aber ebenfalls verfolgen: Benutzen Sie 'sysinclude' fuer System-Packages.
Sie koennen auch 'include' and 'exclude' fuer User Packages benutzen.
Zum Beispiel:
Optionale erweiterte Parameters fuer Call Graph Recording (Beispiele)
|
--agentpath:/path/to/libjb2agentXX.so=sysinclude=java,javax,com.sun
--agentpath:/path/to/libjb2agentXX.so=include=com.a.package
--agentpath:/path/to/libjb2agentXX.so=exclude=com.a.package
|
Von diesen Optionen haengt ab, welcher Bytecode injektiert wird.
| |
|
