-
Notifications
You must be signed in to change notification settings - Fork 30
/
Copy pathassertj-swing-launch.html
230 lines (190 loc) · 10.3 KB
/
assertj-swing-launch.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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="AssertJ site">
<meta name="author" content="Joel Costigliola">
<title>AssertJ / Fluent assertions for java</title>
<!-- CSS -->
<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Inconsolata|Source+Code+Pro|Open+Sans|Ubuntu|Varela+Round|Karla">
<link href="css/bootstrap.min.css" rel="stylesheet">
<link href="font-awesome/css/font-awesome.min.css" rel="stylesheet">
<script src="highlight/highlight.pack.js"></script>
<link rel="stylesheet" href="highlight/styles/railscasts.css">
<script>hljs.initHighlightingOnLoad();</script>
<link href="css/assertj.min.css" rel="stylesheet">
<link rel="shortcut icon" href="favicon.png" />
</head>
<body>
<nav class="navbar navbar-inverse navbar-fixed-top" role="navigation">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-ex1-collapse">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<!-- You'll want to use a responsive image option so this logo looks good on devices - I recommend using something like retina.js (do a quick Google search for it and you'll find it) -->
<a class="navbar-brand" href="index.html">AssertJ</a>
</div>
<!-- Collect the nav links, forms, and other content for toggling -->
<div class="collapse navbar-collapse navbar-ex1-collapse">
<ul class="nav navbar-nav navbar-right">
<li><a href="assertj-core-quick-start.html">Quick start</a></li>
<li><a href="assertj-news.html">News</a></li>
<li><a href="assertj-core.html">Core</a></li>
<li><a href="assertj-assertions-generator.html">Assertions generator</a></li>
<li><a href="assertj-guava.html">Guava</a></li>
<li><a href="assertj-joda-time.html">Joda-Time</a></li>
<li><a href="assertj-db.html">DB</a></li>
<li><a href="assertj-neo4j.html">Neo4j</a></li>
<li><a href="assertj-swing.html">Swing</a></li>
<li><a href="assertj-help.html">Help</a></li>
</ul>
</div>
</div>
</nav>
<div class="container">
<div class="row" >
<div class="col-md-2 assertj-sidebar-menu">
<div class="bs-sidebar hidden-print affix-top" role="complementary">
<ul class="bs-sidenav nav ">
<li class="sidenav-header">About</li>
<li><a href="assertj-swing.html">Overview</a></li>
<li><a href="assertj-swing-quick-start.html">Quick start</a></li>
<li><a href="assertj-swing-news.html">News & releases</a></li>
<li><a href="swing/api/index.html">Javadoc</a></li>
<li><a href="assertj-swing.html#code">Code & issues <i class="fa fa-github"></i></a></li>
<li><a href="assertj-swing.html#contributing">Contributing</a></li>
<li class="sidenav-header">Working with it</li>
<li><a href="assertj-swing-getting-started.html">Getting started</a></li>
<li><a href="assertj-swing-basics.html">Basics</a></li>
<li><a href="assertj-swing-edt.html">EDT</a></li>
<li><a href="assertj-swing-lookup.html">Component lookup</a></li>
<li><a href="assertj-swing-launch.html">Launching</a></li>
<li><a href="assertj-swing-input.html">Input simulation</a></li>
<li><a href="assertj-swing-running.html">Running tests</a></li>
<li><a href="assertj-swing-troubleshooting.html">Troubleshooting</a></li>
<li><a href="assertj-swing-advanced.html">Advanced features</a></li>
<li class="sidenav-header">Migrating</li>
<li><a href="assertj-swing-migrating.html">From Fest</a></li>
</ul>
</div>
</div>
<div class="col-lg-10 col-md-10 col-sm-10 text-left" >
<h1 class="page-header">Launching</h1>
<h3 class="page-header"><span id="applications"></span>Applications from a <code>main()</code> method</h3>
<p>AssertJ Swing supports launching an application from its <code>main()</code> method. It is quite
easy, and requires only one line of code. You only need to use the
<a href="swing/api/org/assertj/swing/launcher/ApplicationLauncher.html" target="_blank"><code>ApplicationLauncher</code></a>.</p>
<p>Let's assume we have the following application</p>
<pre><code class="language-java">public class JavaApp {
public static void main(String[] args) {
SwingUtilities.invokeLater(new Runnable() {
public void run() {
JFrame frame = new JFrame("Java Application");
frame.setPreferredSize(new Dimension(200, 200));
frame.pack();
frame.setVisible(true);
}
});
}
}</code></pre>
<p>We can launch this application programmatically either by the main class or its fully qualified name:</p>
<pre><code class="language-java">//import static org.assertj.swing.launcher.ApplicationLauncher.*;
// 1. by class object without arguments
application(JavaApp.class).start();
// 2. by class object with arguments
application(JavaApp.class).withArgs("arg1", "arg2").start();
// 3. by qualified name without arguments
application("com.mycompany.JavaApp").start();
// 4. by qualified name with arguments
application("com.mycompany.JavaApp").withArgs("arg1", "arg2").start();</code></pre>
<p>Once the application is started, we can get a reference of its <code>JFrame</code>. In this example we're
using a <code>WindowFinder</code>. For more information about <code>WindowFinder</code>, please visit
<a href="assertj-swing-lookup.html#long-duration">Testing Long-Duration Tasks</a>.
<pre><code class="language-java">// import static org.assertj.swing.finder.WindowFinder.findFrame;
FrameFixture frame = findFrame(new GenericTypeMatcher<Frame>() {
protected boolean isMatching(Frame frame) {
return "Java Application".equals(frame.getTitle()) && frame.isShowing();
}
}).using(robot);</code></pre>
<h3 class="page-header"><span id="applets"></span>Applets</h3>
<p>AssertJ Swing provides its own <em>applet viewer</em> to support GUI testing of Java applets. Testing an
applet involves three steps: start the applet, the actual test and resource cleanup.</p>
<h4>Start the applet</h4>
<p>There are two ways to start an applet:</p>
<h5>Using an <code>AppletLauncher</code> to start an <code>AppletViewer</code></h5>
<p>The class <code>AppletLauncher</code> provides a fluent interface for launching an applet:</p>
<pre><code class="language-java">AppletViewer viewer = AppletLauncher.applet("org.assertj.swing.applet.MyApplet").start();
// or
AppletViewer viewer = AppletLauncher.applet(MyApplet.class).start();
// or
AppletViewer viewer = AppletLauncher.applet(new MyApplet()).start();</code></pre>
<p>In addition, we can pass parameters to the applet. This works as if you'd specify them in the
<code>param</code> tag of the embedding <code>HTML</code>:</p>
<pre class="pre-scrollable"><code class="language-java">AppletViewer viewer = AppletLauncher.applet(new MyApplet())
.withParameters(
name("bgcolor").value("blue"),
name("color").value("red"),
name("pause").value("200")
)
.start();
// or
Map<String, String> parameters = new HashMap<String, String>();
parameters.put("bgcolor", "blue");
parameters.put("color", "red");
parameters.put("pause", "200");
AppletViewer viewer = AppletLauncher.applet(new MyApplet()).withParameters(parameters).start();</code></pre>
<h5>Starting an <code>AppletViewer</code> directly</h5>
<p>The <code>AppletLauncher</code> provides a simple and compact API to start applets in an
<code>AppletViewer</code>. The created <code>AppletViewer</code> uses basic implementations of
<code>AppletStub</code> and <code>AppletContext</code> though. If you need to test an applet with more
advanced implementations of <code>AppletStub</code> or <code>AppletContext</code>, you can use
<code>AppletViewer</code> directly, passing your own <code>AppletStub</code> (which will return your own
<code>AppletContext</code>).</p>
<pre><code class="language-java">AppletViewer viewer = AppletViewer.newViewer(new MyApplet(), new MyAppletStub());</code></pre>
<h4>Test the applet</h4>
<p>Once we have an <code>AppletViewer</code> up and running the applet to test, we simply can <em>wrap</em>
the <code>AppletViewer</code> with a <code>FrameFixture</code> and start testing.</p>
<pre class="pre-scrollable"><code class="language-java">private AppletViewer viewer;
private FrameFixture applet;
@BeforeMethod public void setUp() {
viewer = // get the viewer using AppletLauncher or create a new AppletViewer
applet = new FrameFixture(viewer);
applet.show();
}
@Test public void shouldChangeLabelOnButtonClick() {
applet.button("ok").click();
applet.label("text").requireText("Hello");
}
@AfterMethod public void tearDown() {
viewer.unloadApplet();
applet.cleanUp();
}</code></pre>
<h4>Resource cleanup</h4>
<p>As our previous example showed, in addition to call <code>cleanUp()</code> we need to unload the applet by
calling <code>unloadApplet</code> in the <code>AppletViewer</code> used in our test.</p>
</div>
</div>
</div>
<br>
<!--
<div class="container">
<footer>
<div class="row">
<div class="col-lg-12">
<p>AssertJ - Licensed under the Apache License, Version 2.0.</p>
</div>
</div>
</footer>
</div>
-->
<script src="js/jquery-1.10.2.js"></script>
<script src="js/bootstrap.js"></script>
<script src="js/modern-business.js"></script>
<script src="js/assertj.js"></script>
</body>
</html>