-
Notifications
You must be signed in to change notification settings - Fork 4
/
newIntro.html
130 lines (116 loc) · 6.18 KB
/
newIntro.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>MaintainJ generates UML sequence and class diagram at runtime</title>
</head>
<body>
<p><b><font face="Verdana" size="3">MaintainJ Introduction</font></b></p>
<p><font face="Verdana" size="2">MaintainJ generates UML sequence and class diagram at
runtime for a use case. This happens in three steps:</font></p>
<p><b><font face="Verdana" size="2">1. Instrument Code</font></b></p>
<p><font face="Verdana" size="2">This step, inserts log statements before every
method call in the class files. Source code is unchanged. You can choose the
packages that will be instrumented. All classes and sub-packages under the
chosen packages will be instrumented. This can be done either at runtime or
build-time.</font></p>
<p><font face="Verdana" size="2">a) <u>Runtime Instrumentation</u> - Runtime instrumentation
is easy and very quick to get started. The following table lists the application
server and JRE configurations on which MaintainJ runtime instrumentation is supported.
J2SE applications (Swing or non-GUI) are supported on almost all JREs.</font></p>
<table border="1" cellpadding="0" cellspacing="0" bordercolor="#C0C0C0" width="100%" style="border-collapse: collapse">
<tr>
<td >
<p align="left"><b><font face="Verdana" size="2">Server </font></b></td>
<td align="right" ><b><font face="Verdana" size="2">JRE </font></b></td>
<td align="center" ><b><font face="Verdana" size="2">Sun's JRE</font></b></td>
<td align="center" ><b><font face="Verdana" size="2">BEA's JRockit</font></b></td>
<td align="center" ><b><font face="Verdana" size="2">IBM JRE</font></b></td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">J2SE Apps</font></b></td>
<td align="center"><font face="Verdana" size="2">1.4, 1.5 , 1.6</font></td>
<td align="center"><font face="Verdana" size="2">1.4 and 1.5</font></td>
<td align="center"><font face="Verdana" size="2">1.5</font></td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">Tomcat 4</font></b></td>
<td align="center"><font face="Verdana" size="2">1.4</font></td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">Tomcat 5 & 6</font></b></td>
<td align="center"><font face="Verdana" size="2">1.5, 1.6</font></td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">JBoss 3</font></b></td>
<td align="center"><font face="Verdana" size="2">1.4</font></td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">JBoss 4</font></b></td>
<td align="center"><font face="Verdana" size="2">1.5, 1.6</font></td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">WebLogic 8</font></b></td>
<td align="center"><font face="Verdana" size="2">1.4</font></td>
<td align="center"><font face="Verdana" size="2">JRockit 1.4</font></td>
<td align="center"> </td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">WebLogic 9</font></b></td>
<td align="center"><font face="Verdana" size="2">1.5</font></td>
<td align="center"><font face="Verdana" size="2">JRockit 1.5</font></td>
<td align="center"> </td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">WebSphere 5</font></b></td>
<td align="center"><font face="Verdana" size="2">1.4</font></td>
<td align="center"> </td>
<td align="center"><font face="Verdana" size="2">1.4</font></td>
</tr>
<tr>
<td colspan="2" ><b><font face="Verdana" size="2">WebSphere 6</font></b></td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"><font face="Verdana" size="2">1.5</font></td>
</tr>
</table>
<p><font face="Verdana" size="2">Runtime instrumented applications are slow to
service the first request but perform with little overhead after that. </font></p>
<p><font face="Verdana" size="2"><u>b) Build-time Instrumentation</u> - Use
build-time instrumentation if runtime instrumentation is not supported for your
configuration. MaintainJ Instrumentation
Wizard supports build-time instrumentation for J2SE, J2EE and Eclipse
applications. Instrumentation Wizard supports J2EE applications when they are
deployed directly from Eclipse WTP (Web Tools Platform) based IDEs or RAD 6. If
the J2EE applications are built and deployed using Ant scripts, the Ant scripts
need to be changed.</font></p>
<p><b><font face="Verdana" size="2">2. Generate Trace Files</font></b></p>
<p><font face="Verdana" size="2">Run the instrumented Java code. Define the
start and end points of a use case. Call trace for the use case will be logged
to the given trace file (.ser file).</font></p>
<p><font face="Verdana" size="2"><u>a) J2EE Applications</u> - A JSP is provided
to Start and Tracing. You need to click a 'Start Tracing' button before a use
case starts and click 'Stop Tracing' at the end of the use case. The call trace
will be logged to the given file name when 'Stop Tracing' is clicked.</font></p>
<p><font face="Verdana" size="2"><u>b) J2SE and Eclipse Applications</u> - A
Swing window where you can start and stop tracing opens when your instrumented
application starts. Click a 'Start Tracing' button before a use case starts and
'Stop Tracing' at the end of the use case. The call trace will be logged to the
given file name when 'Stop Tracing' is clicked. </font></p>
<p><b><font face="Verdana" size="2">3. View the Diagrams</font></b><font face="Verdana" size="2">
</font></p>
<p><font face="Verdana" size="2">Just copy or move the trace files to any
project in Eclipse workspace to view the diagrams.</font></p>
<p> </p>
</body>
</html>