-
Notifications
You must be signed in to change notification settings - Fork 2
Expand file tree
/
Copy pathjava-review.html
More file actions
639 lines (594 loc) · 64.8 KB
/
java-review.html
File metadata and controls
639 lines (594 loc) · 64.8 KB
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
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>Android Development: Lecture Notes</title>
<meta name="description" content="Lecture Notes for INFO 448: Android Development.">
<meta name="generator" content="bookdown 0.5 and GitBook 2.6.7">
<meta property="og:title" content="Android Development: Lecture Notes" />
<meta property="og:type" content="book" />
<meta property="og:url" content="https://info448.github.io/" />
<meta property="og:image" content="https://info448.github.io/img/android_icon_transparent.png" />
<meta property="og:description" content="Lecture Notes for INFO 448: Android Development." />
<meta name="github-repo" content="info448/book" />
<meta name="twitter:card" content="summary" />
<meta name="twitter:title" content="Android Development: Lecture Notes" />
<meta name="twitter:description" content="Lecture Notes for INFO 448: Android Development." />
<meta name="twitter:image" content="https://info448.github.io/img/android_icon_transparent.png" />
<meta name="author" content="Joel Ross">
<meta name="date" content="2018-11-19">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<link rel="shortcut icon" href="img/android_icon_transparent.png" type="image/x-icon">
<link rel="prev" href="multi-touch.html">
<link rel="next" href="java-swing.html">
<script src="libs/jquery-2.2.3/jquery.min.js"></script>
<link href="libs/gitbook-2.6.7/css/style.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-bookdown.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-highlight.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-search.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-fontsettings.css" rel="stylesheet" />
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-98444716-1', 'auto');
ga('send', 'pageview');
</script>
<style type="text/css">
div.sourceCode { overflow-x: auto; }
table.sourceCode, tr.sourceCode, td.lineNumbers, td.sourceCode {
margin: 0; padding: 0; vertical-align: baseline; border: none; }
table.sourceCode { width: 100%; line-height: 100%; }
td.lineNumbers { text-align: right; padding-right: 4px; padding-left: 4px; color: #aaaaaa; border-right: 1px solid #aaaaaa; }
td.sourceCode { padding-left: 5px; }
code > span.kw { color: #007020; font-weight: bold; } /* Keyword */
code > span.dt { color: #902000; } /* DataType */
code > span.dv { color: #40a070; } /* DecVal */
code > span.bn { color: #40a070; } /* BaseN */
code > span.fl { color: #40a070; } /* Float */
code > span.ch { color: #4070a0; } /* Char */
code > span.st { color: #4070a0; } /* String */
code > span.co { color: #60a0b0; font-style: italic; } /* Comment */
code > span.ot { color: #007020; } /* Other */
code > span.al { color: #ff0000; font-weight: bold; } /* Alert */
code > span.fu { color: #06287e; } /* Function */
code > span.er { color: #ff0000; font-weight: bold; } /* Error */
code > span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
code > span.cn { color: #880000; } /* Constant */
code > span.sc { color: #4070a0; } /* SpecialChar */
code > span.vs { color: #4070a0; } /* VerbatimString */
code > span.ss { color: #bb6688; } /* SpecialString */
code > span.im { } /* Import */
code > span.va { color: #19177c; } /* Variable */
code > span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
code > span.op { color: #666666; } /* Operator */
code > span.bu { } /* BuiltIn */
code > span.ex { } /* Extension */
code > span.pp { color: #bc7a00; } /* Preprocessor */
code > span.at { color: #7d9029; } /* Attribute */
code > span.do { color: #ba2121; font-style: italic; } /* Documentation */
code > span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
code > span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
code > span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
</style>
<link rel="stylesheet" href="css/style.css" type="text/css" />
</head>
<body>
<div class="book without-animation with-summary font-size-2 font-family-1" data-basepath=".">
<div class="book-summary">
<nav role="navigation">
<ul class="summary">
<li><a href="./" class="title">Android Development</a></li>
<li class="divider"></li>
<li class="chapter" data-level="" data-path="index.html"><a href="index.html"><i class="fa fa-check"></i>About this Book</a></li>
<li class="part"><span><b>I Lectures</b></span></li>
<li class="chapter" data-level="1" data-path="introduction.html"><a href="introduction.html"><i class="fa fa-check"></i><b>1</b> Introduction</a><ul>
<li class="chapter" data-level="1.1" data-path="introduction.html"><a href="introduction.html#android-history"><i class="fa fa-check"></i><b>1.1</b> Android History</a><ul>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#android-versions"><i class="fa fa-check"></i>Android Versions</a></li>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#legal-battles"><i class="fa fa-check"></i>Legal Battles</a></li>
</ul></li>
<li class="chapter" data-level="1.2" data-path="introduction.html"><a href="introduction.html#building-apps"><i class="fa fa-check"></i><b>1.2</b> Building Apps</a><ul>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#creating-a-project"><i class="fa fa-check"></i>Creating a Project</a></li>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#running-the-app"><i class="fa fa-check"></i>Running the App</a></li>
</ul></li>
<li class="chapter" data-level="1.3" data-path="introduction.html"><a href="introduction.html#app-source-code"><i class="fa fa-check"></i><b>1.3</b> App Source Code</a><ul>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#xml-resources"><i class="fa fa-check"></i>XML Resources</a></li>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#the-manifest"><i class="fa fa-check"></i>The Manifest</a></li>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#java-activities"><i class="fa fa-check"></i>Java Activities</a></li>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#gradle-scripts"><i class="fa fa-check"></i>Gradle Scripts</a></li>
</ul></li>
<li class="chapter" data-level="1.4" data-path="introduction.html"><a href="introduction.html#logging-adb"><i class="fa fa-check"></i><b>1.4</b> Logging & ADB</a><ul>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#log-methods"><i class="fa fa-check"></i>Log Methods</a></li>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#logcat"><i class="fa fa-check"></i>Logcat</a></li>
<li class="chapter" data-level="" data-path="introduction.html"><a href="introduction.html#toast"><i class="fa fa-check"></i>Toast</a></li>
</ul></li>
<li class="chapter" data-level="1.5" data-path="introduction.html"><a href="introduction.html#adding-interaction"><i class="fa fa-check"></i><b>1.5</b> Adding Interaction</a></li>
<li class="chapter" data-level="1.6" data-path="introduction.html"><a href="introduction.html#kotlin-setup"><i class="fa fa-check"></i><b>1.6</b> Kotlin</a></li>
</ul></li>
<li class="chapter" data-level="2" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html"><i class="fa fa-check"></i><b>2</b> Resources and Layouts</a><ul>
<li class="chapter" data-level="2.1" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#resources"><i class="fa fa-check"></i><b>2.1</b> Resources</a><ul>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#r"><i class="fa fa-check"></i>R</a></li>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#alternative-resources"><i class="fa fa-check"></i>Alternative Resources</a></li>
</ul></li>
<li class="chapter" data-level="2.2" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#views"><i class="fa fa-check"></i><b>2.2</b> Views</a><ul>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#view-properties"><i class="fa fa-check"></i>View Properties</a></li>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#views-and-java"><i class="fa fa-check"></i>Views and Java</a></li>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#practice"><i class="fa fa-check"></i>Practice</a></li>
</ul></li>
<li class="chapter" data-level="2.3" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#layouts"><i class="fa fa-check"></i><b>2.3</b> Layouts</a><ul>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#linearlayout"><i class="fa fa-check"></i>LinearLayout</a></li>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#relativelayout"><i class="fa fa-check"></i>RelativeLayout</a></li>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#constraintlayout"><i class="fa fa-check"></i>ConstraintLayout</a></li>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#other-layouts"><i class="fa fa-check"></i>Other Layouts</a></li>
<li class="chapter" data-level="" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#combining-and-inflating-layouts"><i class="fa fa-check"></i>Combining and Inflating Layouts</a></li>
</ul></li>
<li class="chapter" data-level="2.4" data-path="resources-and-layouts.html"><a href="resources-and-layouts.html#inputs"><i class="fa fa-check"></i><b>2.4</b> Inputs</a></li>
</ul></li>
<li class="chapter" data-level="3" data-path="activities.html"><a href="activities.html"><i class="fa fa-check"></i><b>3</b> Activities</a><ul>
<li class="chapter" data-level="3.1" data-path="activities.html"><a href="activities.html#making-activities"><i class="fa fa-check"></i><b>3.1</b> Making Activities</a></li>
<li class="chapter" data-level="3.2" data-path="activities.html"><a href="activities.html#the-activity-lifecycle"><i class="fa fa-check"></i><b>3.2</b> The Activity Lifecycle</a><ul>
<li class="chapter" data-level="" data-path="activities.html"><a href="activities.html#overriding-the-callback-methods"><i class="fa fa-check"></i>Overriding the Callback Methods</a></li>
<li class="chapter" data-level="" data-path="activities.html"><a href="activities.html#saving-and-restoring-activity-state"><i class="fa fa-check"></i>Saving and Restoring Activity State</a></li>
</ul></li>
<li class="chapter" data-level="3.3" data-path="activities.html"><a href="activities.html#context"><i class="fa fa-check"></i><b>3.3</b> Context</a></li>
<li class="chapter" data-level="3.4" data-path="activities.html"><a href="activities.html#multiple-activities"><i class="fa fa-check"></i><b>3.4</b> Multiple Activities</a><ul>
<li class="chapter" data-level="" data-path="activities.html"><a href="activities.html#activity-intents"><i class="fa fa-check"></i>Intents</a></li>
<li class="chapter" data-level="" data-path="activities.html"><a href="activities.html#back-tasks"><i class="fa fa-check"></i>Back & Tasks</a></li>
<li class="chapter" data-level="" data-path="activities.html"><a href="activities.html#up-navigation"><i class="fa fa-check"></i>Up Navigation</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="4" data-path="data-views.html"><a href="data-views.html"><i class="fa fa-check"></i><b>4</b> Data-Driven Views</a><ul>
<li class="chapter" data-level="4.1" data-path="data-views.html"><a href="data-views.html#listviews-and-adapters"><i class="fa fa-check"></i><b>4.1</b> ListViews and Adapters</a></li>
<li class="chapter" data-level="4.2" data-path="data-views.html"><a href="data-views.html#networking-with-volley"><i class="fa fa-check"></i><b>4.2</b> Networking with Volley</a><ul>
<li class="chapter" data-level="" data-path="data-views.html"><a href="data-views.html#using-volley"><i class="fa fa-check"></i>Using Volley</a></li>
<li class="chapter" data-level="" data-path="data-views.html"><a href="data-views.html#requestqueue-singletons"><i class="fa fa-check"></i>RequestQueue Singletons</a></li>
<li class="chapter" data-level="" data-path="data-views.html"><a href="data-views.html#downloading-images"><i class="fa fa-check"></i>Downloading Images</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="5" data-path="material-design.html"><a href="material-design.html"><i class="fa fa-check"></i><b>5</b> Material Design</a><ul>
<li class="chapter" data-level="5.1" data-path="material-design.html"><a href="material-design.html#the-material-design-language"><i class="fa fa-check"></i><b>5.1</b> The Material Design Language</a></li>
<li class="chapter" data-level="5.2" data-path="material-design.html"><a href="material-design.html#material-styles-icons"><i class="fa fa-check"></i><b>5.2</b> Material Styles & Icons</a></li>
<li class="chapter" data-level="5.3" data-path="material-design.html"><a href="material-design.html#design-support-libraries"><i class="fa fa-check"></i><b>5.3</b> Design Support Libraries</a><ul>
<li class="chapter" data-level="" data-path="material-design.html"><a href="material-design.html#widgets"><i class="fa fa-check"></i>Widgets</a></li>
<li class="chapter" data-level="" data-path="material-design.html"><a href="material-design.html#coordinator-layout"><i class="fa fa-check"></i>Coordinator Layout</a></li>
</ul></li>
<li class="chapter" data-level="5.4" data-path="material-design.html"><a href="material-design.html#animations"><i class="fa fa-check"></i><b>5.4</b> Animations</a></li>
<li class="chapter" data-level="" data-path="material-design.html"><a href="material-design.html#resources-1"><i class="fa fa-check"></i>Resources</a></li>
</ul></li>
<li class="chapter" data-level="6" data-path="fragments.html"><a href="fragments.html"><i class="fa fa-check"></i><b>6</b> Fragments</a><ul>
<li class="chapter" data-level="6.1" data-path="fragments.html"><a href="fragments.html#creating-a-fragment"><i class="fa fa-check"></i><b>6.1</b> Creating a Fragment</a><ul>
<li class="chapter" data-level="" data-path="fragments.html"><a href="fragments.html#activity-to-fragment-communication"><i class="fa fa-check"></i>Activity-to-Fragment Communication</a></li>
</ul></li>
<li class="chapter" data-level="6.2" data-path="fragments.html"><a href="fragments.html#dynamic-fragments"><i class="fa fa-check"></i><b>6.2</b> Dynamic Fragments</a><ul>
<li class="chapter" data-level="" data-path="fragments.html"><a href="fragments.html#instantiating-fragments"><i class="fa fa-check"></i>Instantiating Fragments</a></li>
<li class="chapter" data-level="" data-path="fragments.html"><a href="fragments.html#transactions"><i class="fa fa-check"></i>Transactions</a></li>
<li class="chapter" data-level="" data-path="fragments.html"><a href="fragments.html#inter-fragment-communication"><i class="fa fa-check"></i>Inter-Fragment Communication</a></li>
<li class="chapter" data-level="" data-path="fragments.html"><a href="fragments.html#the-back-stack"><i class="fa fa-check"></i>The Back Stack</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="7" data-path="intents.html"><a href="intents.html"><i class="fa fa-check"></i><b>7</b> Intents</a><ul>
<li class="chapter" data-level="7.1" data-path="intents.html"><a href="intents.html#intents-for-another-activity-explicit"><i class="fa fa-check"></i><b>7.1</b> Intents for Another Activity (Explicit)</a><ul>
<li class="chapter" data-level="" data-path="intents.html"><a href="intents.html#extras"><i class="fa fa-check"></i>Extras</a></li>
</ul></li>
<li class="chapter" data-level="7.2" data-path="intents.html"><a href="intents.html#intents-for-another-app-implicit"><i class="fa fa-check"></i><b>7.2</b> Intents for Another App (Implicit)</a></li>
<li class="chapter" data-level="7.3" data-path="intents.html"><a href="intents.html#intents-for-a-response"><i class="fa fa-check"></i><b>7.3</b> Intents for a Response</a></li>
<li class="chapter" data-level="7.4" data-path="intents.html"><a href="intents.html#listening-for-intents"><i class="fa fa-check"></i><b>7.4</b> Listening for Intents</a></li>
<li class="chapter" data-level="7.5" data-path="intents.html"><a href="intents.html#broadcasts-and-receivers"><i class="fa fa-check"></i><b>7.5</b> Broadcasts and Receivers</a></li>
<li class="chapter" data-level="7.6" data-path="intents.html"><a href="intents.html#menus"><i class="fa fa-check"></i><b>7.6</b> Menus</a><ul>
<li class="chapter" data-level="" data-path="intents.html"><a href="intents.html#action-views"><i class="fa fa-check"></i>Action Views</a></li>
<li class="chapter" data-level="" data-path="intents.html"><a href="intents.html#context-menus"><i class="fa fa-check"></i>Context Menus</a></li>
</ul></li>
<li class="chapter" data-level="7.7" data-path="intents.html"><a href="intents.html#an-intent-example-sms"><i class="fa fa-check"></i><b>7.7</b> An Intent Example: SMS</a></li>
</ul></li>
<li class="chapter" data-level="8" data-path="notifications-settings.html"><a href="notifications-settings.html"><i class="fa fa-check"></i><b>8</b> Notifications & Settings</a><ul>
<li class="chapter" data-level="8.1" data-path="notifications-settings.html"><a href="notifications-settings.html#dialogs"><i class="fa fa-check"></i><b>8.1</b> Dialogs</a><ul>
<li class="chapter" data-level="" data-path="notifications-settings.html"><a href="notifications-settings.html#dialogfragments"><i class="fa fa-check"></i>DialogFragments</a></li>
</ul></li>
<li class="chapter" data-level="8.2" data-path="notifications-settings.html"><a href="notifications-settings.html#notifications"><i class="fa fa-check"></i><b>8.2</b> Notifications</a><ul>
<li class="chapter" data-level="8.2.1" data-path="notifications-settings.html"><a href="notifications-settings.html#tap-actions"><i class="fa fa-check"></i><b>8.2.1</b> Tap Actions</a></li>
</ul></li>
<li class="chapter" data-level="8.3" data-path="notifications-settings.html"><a href="notifications-settings.html#settings"><i class="fa fa-check"></i><b>8.3</b> Settings</a><ul>
<li class="chapter" data-level="" data-path="notifications-settings.html"><a href="notifications-settings.html#sharedpreferences"><i class="fa fa-check"></i>SharedPreferences</a></li>
<li class="chapter" data-level="" data-path="notifications-settings.html"><a href="notifications-settings.html#preference-settings"><i class="fa fa-check"></i>Preference Settings</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="9" data-path="loaders.html"><a href="loaders.html"><i class="fa fa-check"></i><b>9</b> Providers and Loaders</a><ul>
<li class="chapter" data-level="9.1" data-path="loaders.html"><a href="loaders.html#content-providers-intro"><i class="fa fa-check"></i><b>9.1</b> Content Providers</a></li>
<li class="chapter" data-level="9.2" data-path="loaders.html"><a href="loaders.html#cursors"><i class="fa fa-check"></i><b>9.2</b> Cursors</a></li>
<li class="chapter" data-level="9.3" data-path="loaders.html"><a href="loaders.html#loaders"><i class="fa fa-check"></i><b>9.3</b> Loaders</a></li>
<li class="chapter" data-level="9.4" data-path="loaders.html"><a href="loaders.html#other-provider-actions"><i class="fa fa-check"></i><b>9.4</b> Other Provider Actions</a></li>
</ul></li>
<li class="chapter" data-level="10" data-path="files-and-permissions.html"><a href="files-and-permissions.html"><i class="fa fa-check"></i><b>10</b> Files and Permissions</a><ul>
<li class="chapter" data-level="10.1" data-path="files-and-permissions.html"><a href="files-and-permissions.html#file-storage-locations"><i class="fa fa-check"></i><b>10.1</b> File Storage Locations</a></li>
<li class="chapter" data-level="10.2" data-path="files-and-permissions.html"><a href="files-and-permissions.html#permissions"><i class="fa fa-check"></i><b>10.2</b> Permissions</a></li>
<li class="chapter" data-level="10.3" data-path="files-and-permissions.html"><a href="files-and-permissions.html#external-storage"><i class="fa fa-check"></i><b>10.3</b> External Storage</a></li>
<li class="chapter" data-level="10.4" data-path="files-and-permissions.html"><a href="files-and-permissions.html#internal-storage-cache"><i class="fa fa-check"></i><b>10.4</b> Internal Storage & Cache</a></li>
<li class="chapter" data-level="10.5" data-path="files-and-permissions.html"><a href="files-and-permissions.html#example-saving-pictures"><i class="fa fa-check"></i><b>10.5</b> Example: Saving Pictures</a><ul>
<li class="chapter" data-level="10.5.1" data-path="files-and-permissions.html"><a href="files-and-permissions.html#fileproviders"><i class="fa fa-check"></i><b>10.5.1</b> FileProviders</a></li>
</ul></li>
<li class="chapter" data-level="10.6" data-path="files-and-permissions.html"><a href="files-and-permissions.html#sharing-files"><i class="fa fa-check"></i><b>10.6</b> Sharing Files</a></li>
</ul></li>
<li class="chapter" data-level="11" data-path="databases.html"><a href="databases.html"><i class="fa fa-check"></i><b>11</b> Providers and Databases</a><ul>
<li class="chapter" data-level="11.1" data-path="databases.html"><a href="databases.html#review-providers-and-loaders"><i class="fa fa-check"></i><b>11.1</b> Review: Providers and Loaders</a></li>
<li class="chapter" data-level="11.2" data-path="databases.html"><a href="databases.html#sqlite-databases"><i class="fa fa-check"></i><b>11.2</b> SQLite Databases</a></li>
<li class="chapter" data-level="11.3" data-path="databases.html"><a href="databases.html#implementing-a-contentprovider"><i class="fa fa-check"></i><b>11.3</b> Implementing a ContentProvider</a><ul>
<li class="chapter" data-level="" data-path="databases.html"><a href="databases.html#uris-and-types"><i class="fa fa-check"></i>URIs and Types</a></li>
<li class="chapter" data-level="" data-path="databases.html"><a href="databases.html#query-methods"><i class="fa fa-check"></i>Query Methods</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="12" data-path="location.html"><a href="location.html"><i class="fa fa-check"></i><b>12</b> Location</a><ul>
<li class="chapter" data-level="12.1" data-path="location.html"><a href="location.html#localization-techniques"><i class="fa fa-check"></i><b>12.1</b> Localization Techniques</a><ul>
<li class="chapter" data-level="" data-path="location.html"><a href="location.html#gps"><i class="fa fa-check"></i>GPS</a></li>
<li class="chapter" data-level="" data-path="location.html"><a href="location.html#cell-tower-localization"><i class="fa fa-check"></i>Cell Tower Localization</a></li>
<li class="chapter" data-level="" data-path="location.html"><a href="location.html#wifi-localization"><i class="fa fa-check"></i>WiFi Localization</a></li>
<li class="chapter" data-level="" data-path="location.html"><a href="location.html#representing-location"><i class="fa fa-check"></i>Representing Location</a></li>
</ul></li>
<li class="chapter" data-level="12.2" data-path="location.html"><a href="location.html#android-location"><i class="fa fa-check"></i><b>12.2</b> Android Location</a><ul>
<li class="chapter" data-level="" data-path="location.html"><a href="location.html#google-play-services"><i class="fa fa-check"></i>Google Play Services</a></li>
<li class="chapter" data-level="" data-path="location.html"><a href="location.html#accessing-location"><i class="fa fa-check"></i>Accessing Location</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="13" data-path="services.html"><a href="services.html"><i class="fa fa-check"></i><b>13</b> Threads and Services</a><ul>
<li class="chapter" data-level="13.1" data-path="services.html"><a href="services.html#threads-and-processes"><i class="fa fa-check"></i><b>13.1</b> Threads and Processes</a><ul>
<li class="chapter" data-level="" data-path="services.html"><a href="services.html#java-threads"><i class="fa fa-check"></i>Java Threads</a></li>
<li class="chapter" data-level="" data-path="services.html"><a href="services.html#android-threads"><i class="fa fa-check"></i>Android Threads</a></li>
</ul></li>
<li class="chapter" data-level="13.2" data-path="services.html"><a href="services.html#intentservices"><i class="fa fa-check"></i><b>13.2</b> IntentServices</a><ul>
<li class="chapter" data-level="" data-path="services.html"><a href="services.html#the-service-lifecycle"><i class="fa fa-check"></i>The Service Lifecycle</a></li>
</ul></li>
<li class="chapter" data-level="13.3" data-path="services.html"><a href="services.html#example-a-music-service"><i class="fa fa-check"></i><b>13.3</b> Example: A Music Service</a><ul>
<li class="chapter" data-level="" data-path="services.html"><a href="services.html#mediaplayer"><i class="fa fa-check"></i>MediaPlayer</a></li>
<li class="chapter" data-level="" data-path="services.html"><a href="services.html#creating-a-service"><i class="fa fa-check"></i>Creating a Service</a></li>
</ul></li>
<li class="chapter" data-level="13.4" data-path="services.html"><a href="services.html#foreground-services"><i class="fa fa-check"></i><b>13.4</b> Foreground Services</a></li>
<li class="chapter" data-level="13.5" data-path="services.html"><a href="services.html#bound-services"><i class="fa fa-check"></i><b>13.5</b> Bound Services</a></li>
</ul></li>
<li class="chapter" data-level="14" data-path="sensors.html"><a href="sensors.html"><i class="fa fa-check"></i><b>14</b> Sensors</a><ul>
<li class="chapter" data-level="14.1" data-path="sensors.html"><a href="sensors.html#motion-sensors"><i class="fa fa-check"></i><b>14.1</b> Motion Sensors</a><ul>
<li class="chapter" data-level="" data-path="sensors.html"><a href="sensors.html#accessing-sensors"><i class="fa fa-check"></i>Accessing Sensors</a></li>
<li class="chapter" data-level="" data-path="sensors.html"><a href="sensors.html#composite-sensors"><i class="fa fa-check"></i>Composite Sensors</a></li>
</ul></li>
<li class="chapter" data-level="14.2" data-path="sensors.html"><a href="sensors.html#rotation"><i class="fa fa-check"></i><b>14.2</b> Rotation</a><ul>
<li class="chapter" data-level="" data-path="sensors.html"><a href="sensors.html#coordinates"><i class="fa fa-check"></i>Coordinates</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="15" data-path="graphics.html"><a href="graphics.html"><i class="fa fa-check"></i><b>15</b> Graphics and Touch</a><ul>
<li class="chapter" data-level="15.1" data-path="graphics.html"><a href="graphics.html#drawing-graphics"><i class="fa fa-check"></i><b>15.1</b> Drawing Graphics</a><ul>
<li class="chapter" data-level="" data-path="graphics.html"><a href="graphics.html#custom-views"><i class="fa fa-check"></i>Custom Views</a></li>
<li class="chapter" data-level="" data-path="graphics.html"><a href="graphics.html#surfaceviews"><i class="fa fa-check"></i>SurfaceViews</a></li>
</ul></li>
<li class="chapter" data-level="15.2" data-path="graphics.html"><a href="graphics.html#touch-and-gestures"><i class="fa fa-check"></i><b>15.2</b> Touch and Gestures</a><ul>
<li class="chapter" data-level="" data-path="graphics.html"><a href="graphics.html#advanced-gestures"><i class="fa fa-check"></i>Advanced Gestures</a></li>
</ul></li>
<li class="chapter" data-level="15.3" data-path="graphics.html"><a href="graphics.html#property-animation"><i class="fa fa-check"></i><b>15.3</b> Property Animation</a></li>
</ul></li>
<li class="part"><span><b>II Additional Topics (Labs)</b></span></li>
<li class="chapter" data-level="16" data-path="styles-themes.html"><a href="styles-themes.html"><i class="fa fa-check"></i><b>16</b> Styles & Themes</a><ul>
<li class="chapter" data-level="16.1" data-path="styles-themes.html"><a href="styles-themes.html#defining-styles"><i class="fa fa-check"></i><b>16.1</b> Defining Styles</a><ul>
<li class="chapter" data-level="" data-path="styles-themes.html"><a href="styles-themes.html#style-inheritance"><i class="fa fa-check"></i>Style Inheritance</a></li>
<li class="chapter" data-level="" data-path="styles-themes.html"><a href="styles-themes.html#built-in-styles"><i class="fa fa-check"></i>Built-in Styles</a></li>
<li class="chapter" data-level="" data-path="styles-themes.html"><a href="styles-themes.html#styles-for-text-views"><i class="fa fa-check"></i>Styles for Text Views</a></li>
</ul></li>
<li class="chapter" data-level="16.2" data-path="styles-themes.html"><a href="styles-themes.html#themes"><i class="fa fa-check"></i><b>16.2</b> Themes</a><ul>
<li class="chapter" data-level="" data-path="styles-themes.html"><a href="styles-themes.html#material-themes"><i class="fa fa-check"></i>Material Themes</a></li>
<li class="chapter" data-level="" data-path="styles-themes.html"><a href="styles-themes.html#theme-attributes"><i class="fa fa-check"></i>Theme Attributes</a></li>
</ul></li>
<li class="chapter" data-level="" data-path="styles-themes.html"><a href="styles-themes.html#resources-2"><i class="fa fa-check"></i>Resources</a></li>
</ul></li>
<li class="chapter" data-level="17" data-path="fragment-viewpager.html"><a href="fragment-viewpager.html"><i class="fa fa-check"></i><b>17</b> Fragments: ViewPager</a><ul>
<li class="chapter" data-level="17.1" data-path="fragment-viewpager.html"><a href="fragment-viewpager.html#define-a-searchfragment"><i class="fa fa-check"></i><b>17.1</b> Define a SearchFragment</a></li>
<li class="chapter" data-level="17.2" data-path="fragment-viewpager.html"><a href="fragment-viewpager.html#add-the-viewpager-and-adapter"><i class="fa fa-check"></i><b>17.2</b> Add the ViewPager and Adapter</a></li>
<li class="chapter" data-level="17.3" data-path="fragment-viewpager.html"><a href="fragment-viewpager.html#add-user-interaction"><i class="fa fa-check"></i><b>17.3</b> Add User Interaction</a></li>
</ul></li>
<li class="chapter" data-level="18" data-path="bluetooth.html"><a href="bluetooth.html"><i class="fa fa-check"></i><b>18</b> Bluetooth</a></li>
<li class="chapter" data-level="19" data-path="maps.html"><a href="maps.html"><i class="fa fa-check"></i><b>19</b> Maps</a><ul>
<li class="chapter" data-level="19.1" data-path="maps.html"><a href="maps.html#create-a-map-activity"><i class="fa fa-check"></i><b>19.1</b> Create a Map Activity</a><ul>
<li class="chapter" data-level="" data-path="maps.html"><a href="maps.html#getting-an-api-key"><i class="fa fa-check"></i>Getting an API Key</a></li>
<li><a href="maps.html#the-supportmapfragment">The <code>SupportMapFragment</code></a></li>
</ul></li>
<li class="chapter" data-level="19.2" data-path="maps.html"><a href="maps.html#specifying-the-user-interface"><i class="fa fa-check"></i><b>19.2</b> Specifying the User Interface</a></li>
<li class="chapter" data-level="19.3" data-path="maps.html"><a href="maps.html#markers-and-drawings"><i class="fa fa-check"></i><b>19.3</b> Markers and Drawings</a><ul>
<li class="chapter" data-level="" data-path="maps.html"><a href="maps.html#drawing-shapes"><i class="fa fa-check"></i>Drawing Shapes</a></li>
</ul></li>
</ul></li>
<li class="chapter" data-level="20" data-path="memory.html"><a href="memory.html"><i class="fa fa-check"></i><b>20</b> Memory Management</a><ul>
<li class="chapter" data-level="20.1" data-path="memory.html"><a href="memory.html#memory-allocation"><i class="fa fa-check"></i><b>20.1</b> Memory Allocation</a></li>
<li class="chapter" data-level="20.2" data-path="memory.html"><a href="memory.html#the-memory-monitor"><i class="fa fa-check"></i><b>20.2</b> The Memory Monitor</a><ul>
<li class="chapter" data-level="" data-path="memory.html"><a href="memory.html#garbage-collection"><i class="fa fa-check"></i>Garbage Collection</a></li>
</ul></li>
<li class="chapter" data-level="20.3" data-path="memory.html"><a href="memory.html#memory-leaks"><i class="fa fa-check"></i><b>20.3</b> Memory Leaks</a></li>
</ul></li>
<li class="chapter" data-level="21" data-path="multi-touch.html"><a href="multi-touch.html"><i class="fa fa-check"></i><b>21</b> Multi-Touch</a><ul>
<li class="chapter" data-level="21.1" data-path="multi-touch.html"><a href="multi-touch.html#identifying-fingers"><i class="fa fa-check"></i><b>21.1</b> Identifying Fingers</a></li>
<li class="chapter" data-level="21.2" data-path="multi-touch.html"><a href="multi-touch.html#drawing-touches"><i class="fa fa-check"></i><b>21.2</b> Drawing Touches</a></li>
<li class="chapter" data-level="21.3" data-path="multi-touch.html"><a href="multi-touch.html#moving-fingers"><i class="fa fa-check"></i><b>21.3</b> Moving Fingers</a></li>
<li class="chapter" data-level="21.4" data-path="multi-touch.html"><a href="multi-touch.html#other-multi-touch-gestures"><i class="fa fa-check"></i><b>21.4</b> Other Multi-Touch Gestures</a></li>
</ul></li>
<li class="appendix"><span><b>Appendix</b></span></li>
<li class="chapter" data-level="A" data-path="java-review.html"><a href="java-review.html"><i class="fa fa-check"></i><b>A</b> Java Review</a><ul>
<li class="chapter" data-level="A.1" data-path="java-review.html"><a href="java-review.html#building-apps-with-gradle"><i class="fa fa-check"></i><b>A.1</b> Building Apps with Gradle</a></li>
<li class="chapter" data-level="A.2" data-path="java-review.html"><a href="java-review.html#class-basics"><i class="fa fa-check"></i><b>A.2</b> Class Basics</a></li>
<li class="chapter" data-level="A.3" data-path="java-review.html"><a href="java-review.html#inheritance"><i class="fa fa-check"></i><b>A.3</b> Inheritance</a></li>
<li class="chapter" data-level="A.4" data-path="java-review.html"><a href="java-review.html#interfaces"><i class="fa fa-check"></i><b>A.4</b> Interfaces</a></li>
<li class="chapter" data-level="A.5" data-path="java-review.html"><a href="java-review.html#polymorphism"><i class="fa fa-check"></i><b>A.5</b> Polymorphism</a></li>
<li class="chapter" data-level="A.6" data-path="java-review.html"><a href="java-review.html#abstract-methods-and-classes"><i class="fa fa-check"></i><b>A.6</b> Abstract Methods and Classes</a></li>
<li class="chapter" data-level="A.7" data-path="java-review.html"><a href="java-review.html#generics"><i class="fa fa-check"></i><b>A.7</b> Generics</a></li>
<li class="chapter" data-level="A.8" data-path="java-review.html"><a href="java-review.html#nested-classes"><i class="fa fa-check"></i><b>A.8</b> Nested Classes</a></li>
</ul></li>
<li class="chapter" data-level="B" data-path="java-swing.html"><a href="java-swing.html"><i class="fa fa-check"></i><b>B</b> Java Swing Framework</a><ul>
<li class="chapter" data-level="B.1" data-path="java-swing.html"><a href="java-swing.html#events"><i class="fa fa-check"></i><b>B.1</b> Events</a></li>
<li class="chapter" data-level="B.2" data-path="java-swing.html"><a href="java-swing.html#layouts-and-composites"><i class="fa fa-check"></i><b>B.2</b> Layouts and Composites</a></li>
</ul></li>
<li class="chapter" data-level="C" data-path="publishing.html"><a href="publishing.html"><i class="fa fa-check"></i><b>C</b> Publishing</a><ul>
<li class="chapter" data-level="C.1" data-path="publishing.html"><a href="publishing.html#signing-an-app"><i class="fa fa-check"></i><b>C.1</b> Signing an App</a><ul>
<li><a href="publishing.html#release-.apk">Release <code>.apk</code></a></li>
</ul></li>
</ul></li>
<li class="divider"></li>
<li><a href="https://github.com/rstudio/bookdown" target="blank">Published with bookdown</a></li>
</ul>
</nav>
</div>
<div class="book-body">
<div class="body-inner">
<div class="book-header" role="navigation">
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i><a href="./">Android Development: Lecture Notes</a>
</h1>
</div>
<div class="page-wrapper" tabindex="-1" role="main">
<div class="page-inner">
<section class="normal" id="section-">
<div id="java-review" class="section level1">
<h1><span class="header-section-number">A</span> Java Review</h1>
<p>Android applications are written primarily in the Java Language. This appendix contains a review of some Java fundamentals needed when developing for Android, presented as a set of practice exercises.</p>
<p class="alert alert-info">
The code for these exercises can be found at <a href="https://github.com/info448/appendix-java-review" class="uri">https://github.com/info448/appendix-java-review</a>.
</p>
<div id="building-apps-with-gradle" class="section level2">
<h2><span class="header-section-number">A.1</span> Building Apps with Gradle</h2>
<p>Consider the included <code>Dog</code> class found in the <code>src/main/java/edu/info448/review/</code> folder. This is a very basic class representing a Dog. You can instantiate and call methods on this class by building and running the <code>Tester</code> class found in the same folder. - You can just use any text editor, like <em>VS Code</em>, <em>Atom</em>, or <em>Sublime Text</em> to view and edit these files.</p>
<p>You’ve probably run Java programs using an IDE, but let’s consider what is involved in building this app “by hand”, or just using the JDK tools. There are two main steps to running a Java program:</p>
<ol style="list-style-type: decimal">
<li><p><strong>Compiling</strong> This converts the Java source code (in <code>.java</code> files) into JVM bytecode that can be understood by the virtual machine (in <code>.class</code>) files.</p></li>
<li><p><strong>Running</strong> This actually loads the bytecode into the virtual machine and executes the <code>main()</code> method.</p></li>
</ol>
<p>Compiling is done with the <code>javac</code> (“java compile”) command. For example, from inside the code repo’s directory, you can compile both the <code>.java</code> files with:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="co"># Compile all .java files</span>
<span class="ex">javac</span> src/main/java/edu/info448/review/*.java</code></pre></div>
<p>Running is then done with the <code>java</code> command: you specify the full package name of the class you wish to run, as well as the <a href="https://docs.oracle.com/javase/tutorial/essential/environment/paths.html">classpath</a> so that Java knows where to go find classes it depends on:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="co"># Runs the Tester#main() method with the `src/main/java` folder as the classpath</span>
<span class="ex">java</span> -classpath ./src/main/java edu.info448.review.Tester</code></pre></div>
<p><strong><em>Practice: Compile and run this application now.</em></strong></p>
<p><strong><em>Practice: Modify the <code>Dog</code> class so that it’s <code>.bark()</code> method barks twice (<code>"Bark Bark!"</code>). What do you have to do to test that your change worked?</em></strong></p>
<p>You may notice that this development cycle can get pretty tedious: there are two commands we need to execute to run our code, and both are complex enough that they are a pain to retype.</p>
<p>Enter <a href="https://gradle.org/"><strong>Gradle</strong></a>. Gradle is a build automation system: a “script” that you can run that will automatically perform the multiple steps required to build and run an application. This script is defined by the <code>build.gradle</code> configuration file. <strong><em>Practice: open that file and look through its contents</em></strong>. The <code>task run()</code> is where the “run” task is defined: do you see how it defines the same arguments we otherwise passed to the <code>java</code> command?</p>
<p>You can run the version of Gradle included in the repo with the <code>gradlew <task></code> command, specifying what task you want to the build system to perform. For example:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="co"># on Mac/Linux</span>
<span class="ex">./gradlew</span> tasks
<span class="co"># on Windows</span>
<span class="ex">gradlew</span> tasks</code></pre></div>
<p>Will give you a list of available tasks. Use <code>gradlew classes</code> to compile the code, and <code>gradlew run</code> to compile <em>and</em> run the code.</p>
<ul>
<li><strong>Helpful hint</strong>: you can specify the “quite” flag with <code>gradlew -q <task></code> to not have Gradle output its build status (handy for the <code>run</code> task)</li>
</ul>
<p><strong><em>Practice: Use gradle to build and run your Dog program. See how much easier that is?</em></strong></p>
<p>We will be using Gradle to build our Android applications (which are much more complex than this simple Java demo)!</p>
</div>
<div id="class-basics" class="section level2">
<h2><span class="header-section-number">A.2</span> Class Basics</h2>
<p>Now consider the <code>Dog</code> class in more detail. Like all classes, it has two parts:</p>
<ol style="list-style-type: decimal">
<li><p><strong>Attributes</strong> (a.k.a., instance variables, fields, or member variables). For example, <code>String name</code>.</p>
<ul>
<li>Notice that all of these attributes are <code>private</code>, meaning they are not accessible to members of another class! This is important for <strong>encapsulation</strong>: it means we can change how the <code>Dog</code> class is implemented without changing any other class that depends on it (for example, if we want to store <code>breed</code> as a number instead of a <code>String</code>).</li>
</ul></li>
<li><p><strong>Methods</strong> (a.k.a., functions). For example <code>bark()</code></p>
<ul>
<li><p>Note the <em>method declaration</em> <code>public void wagTail(int)</code>. This combination of access modifier (<code>public</code>), return type (<code>void</code>), method name (<code>wagTail</code>) and parameters (<code>int</code>) is called the <strong>method signature</strong>: it is the “autograph” of that particular method. When we call a method (e.g., <code>myDog.wagTail(3)</code>), Java will look for a method definition that <em>matches</em> that signature.</p></li>
<li><p>Method signatures are very important! They tell us what the inputs and outputs of a method will be. We should be able to understand how the method works <em>just</em> from its signature.</p></li>
</ul></li>
</ol>
<p>Notice that one of the methods, <code>.createPuppies()</code> is a <code>static</code> method. This means that the method belongs to the <strong><em>class</em></strong>, not to individual object instances of the class! <strong><em>Practice: try running the following code (by placing it in the <code>main()</code> method of the <code>Tester</code> class)</em></strong>:</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java">Dog[] pups = Dog.<span class="fu">createPuppies</span>(<span class="dv">3</span>);
<span class="bu">System</span>.<span class="fu">out</span>.<span class="fu">println</span>(<span class="bu">Arrays</span>.<span class="fu">toString</span>(pups));</code></pre></div>
<p>Notice that to call the <code>createPuppies()</code> method you didn’t need to have a <code>Dog</code> object (you didn’t need to use the <code>new</code> keyword): instead you went to the “template” for a <code>Dog</code> and told that template to do some work. <em>Non-static</em> methods (ones without the <code>static</code> keyword, also called “instance methods”) need to be called on an object.</p>
<p><strong><em>Practice: Try to run the code <code>Dog.bark()</code>. What happens?</em></strong> This is because you can’t tell the “template” for a <code>Dog</code> to bark, only an actual <code>Dog</code> object!</p>
<p>In general, in 98% of cases, your methods should <strong>not</strong> be <code>static</code>, because you want to call them on a specific object rather than on a general “template” for objects. Variables should <strong>never</strong> be static, unless they are <strong>also</strong> <code>final</code> constants (like the <code>BEST_BREED</code> variable).</p>
<ul>
<li>In Android, <code>static</code> variables cause significant memory leaks, as well as just being generally poor design.</li>
</ul>
</div>
<div id="inheritance" class="section level2">
<h2><span class="header-section-number">A.3</span> Inheritance</h2>
<p><strong><em>Practice: Create a new file <code>Husky.java</code> that declares a new <code>Husky</code> class:</em></strong></p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java"><span class="kw">package</span><span class="im"> edu.info448.review;</span> <span class="co">//package declaration (needed)</span>
<span class="kw">public</span> <span class="kw">class</span> Husky <span class="kw">extends</span> Dog {
<span class="co">/* class body goes here */</span>
}</code></pre></div>
<p>The <code>extends</code> keyword means that <code>Husky</code> is a <a href="https://docs.oracle.com/javase/tutorial/java/IandI/subclasses.html"><strong>subclass</strong></a> of <code>Dog</code>, inheriting all of its methods and attributes. It also means that that a <code>Husky</code> instance <strong>is a</strong> <code>Dog</code> instance.</p>
<p><strong><em>Practice: In the Tester, instantiate a new <code>Husky</code> and call <code>bark()</code> on it. What happens?</em></strong></p>
<ul>
<li><p>Because we’ve inherited from <code>Dog</code>, the <code>Husky</code> class gets all of the methods defined in <code>Dog</code> for free!</p></li>
<li><p>Try adding a constructor that takes in a single parameter (<code>name</code>) and calls the appropriate <code>super()</code> constructor so that the breed is <code>"Husky"</code>, which makes this a little more sensible.</p></li>
</ul>
<p>We can also add more methods to the <strong>subclass</strong> that the <strong>parent class</strong> doesn’t have. <strong><em>Practice: add a method called <code>.pullSled()</code> to the <code>Husky</code> class.</em></strong></p>
<ul>
<li>Try calling <code>.pullSled()</code> on your <code>Husky</code> <em>object</em>. What happens? Then try calling <code>.pullSled()</code> on a <code>Dog</code> <em>object</em>. What happens?</li>
</ul>
<p>Finally, we can <strong>override</strong> methods from the parent class. <strong><em>Practice: add a <code>bark()</code> method to <code>Husky</code> (with the same signature), but that has the <code>Husky</code> “woof” instead of “bark”.</em></strong> Test out your code by calling the method in the <code>Tester</code>.</p>
</div>
<div id="interfaces" class="section level2">
<h2><span class="header-section-number">A.4</span> Interfaces</h2>
<p><strong><em>Practice: Create a new file <code>Huggable.java</code> with the following code:</em></strong></p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java"><span class="kw">package</span><span class="im"> edu.info448.review;</span>
<span class="kw">public</span> <span class="kw">interface</span> Huggable {
<span class="kw">public</span> <span class="dt">void</span> <span class="fu">hug</span>();
}</code></pre></div>
<p>This is an example of an <a href="https://docs.oracle.com/javase/tutorial/java/concepts/interface.html"><strong>interface</strong></a>. An <strong>interface</strong> is a list of methods that a class <em>promises</em> to provide. By <em>implementing</em> the interface (with the <code>interface</code> keyword in the class declaration), the class promises to include any methods listed in the interface.</p>
<ul>
<li><p>This is a lot like hanging a sign outside your business that says <em>“Accepts Visa”</em>. It means that if someone comes to you and tries to pay with a Visa card, you’ll be able to do that!</p></li>
<li><p>Implementing an interface makes no promise about <em>what</em> those methods do, just that the class will include methods with those signatures. <strong><em>Practice: change the <code>Husky</code> class declaration</em></strong>:</p></li>
</ul>
<p><code>java public class Husky extends Dog implements Huggable {...}</code></p>
<p>Now the the <code>Husky</code> class needs to have a <code>public void hug()</code> method, but what that method <em>does</em> is up to you!</p>
<ul>
<li><p>A class can still have a <code>.hug()</code> method even without implementing the <code>Huggable</code> interface (see <code>TeddyBear</code>), but we gain more benefits by announcing that we support that method.</p>
<ul>
<li>Just like how hanging an “Accepts Visa” sign will bring in more people who would be willing to pay with a credit card, rather than just having that option available if someone asks about it.</li>
</ul></li>
</ul>
<p>Why not just make <code>Huggable</code> a superclass, and have the <code>Husky</code> extend that?</p>
<ul>
<li><p>Because <code>Husky</code> extends <code>Dog</code>, and you can only have one parent in Java!</p></li>
<li><p>And because not all dogs are <code>Huggable</code>, and not all <code>Huggable</code> things are <code>Dogs</code>, there isn’t a clear hierarchy for where to include the interface.</p></li>
<li><p>In addition, we can implement multiple interfaces (<code>Husky implements Huggable, Pettable</code>), but we can’t inherit from multiple classes</p>
<ul>
<li><p>This is great for when we have other classes of different types but similar behavior: e.g., a <code>TeddyBear</code> can be <code>Huggable</code> but can’t <code>bark()</code> like a <code>Dog</code>!</p></li>
<li><p><strong><em>Practice: Make the class <code>TeddyBear</code> implement <code>Huggable</code>. Do you need to add any new methods?</em></strong></p></li>
</ul></li>
</ul>
<p><strong><em>What’s the difference between inheritance and interfaces?</em></strong> The main rule of thumb: use <em>inheritance</em> (<code>extends</code>) when you want classes to share <strong>code</strong> (implementation). Use <em>interfaces</em> (<code>implements</code>) when you want classes to share <strong>behaviors</strong> (method signatures). In the end, <em>interfaces</em> are more important for doing good Object-Oriented design. Favor interfaces over inheritance!</p>
</div>
<div id="polymorphism" class="section level2">
<h2><span class="header-section-number">A.5</span> Polymorphism</h2>
<p>Implementing an interface also establishes an <strong>is a</strong> relationship: so a <code>Husky</code> object <strong>is a</strong> <code>Huggable</code> object. This allows the greatest benefit of interfaces and inheritance: <a href="https://docs.oracle.com/javase/tutorial/java/IandI/polymorphism.html"><strong>polymorphism</strong></a>, or the ability to treat one object as the type of another!</p>
<p>Consider the standard variable declaration:</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java">Dog myDog; <span class="co">//= new Dog();</span></code></pre></div>
<p>The variable type of <code>myDog</code> is <code>Dog</code>, which means that variable can refer to any value (object) that <strong>is a</strong> <code>Dog</code>.</p>
<p><strong><em>Practice: Try the following declarations (note that some will not compile!)</em></strong></p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java">Dog v1 = <span class="kw">new</span> <span class="fu">Husky</span>();
Husky v2 = <span class="kw">new</span> <span class="fu">Dog</span>();
Huggable v2 = <span class="kw">new</span> <span class="fu">Husky</span>();
Huggable v3 = <span class="kw">new</span> <span class="fu">TeddyBear</span>();
Husky v4 = <span class="kw">new</span> <span class="fu">TeddyBear</span>();</code></pre></div>
<p>If the <strong>value</strong> (the thing on the right side) <em>is an</em> instance of the <strong>variable type</strong> (the type on the left side), then you have a valid declaration.</p>
<p>Even if you declare a variable <code>Dog v1 = new Husky()</code>, the <strong>value</strong> in that object <em>is</em> a <code>Husky</code>. If you call <code>.bark()</code> on it, you’ll get the <code>Husky</code> version of the method (<strong><em>Practice: try overriding the method to print out <code>"barks like a Husky"</code> to see</em></strong>).</p>
<p>You can <strong>cast</strong> between types if you need to convert from one to another. As long as the <strong>value</strong> <em>is a</em> instance of the type you’re casting to, the operation will work fine.</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java">Dog v1 = <span class="kw">new</span> <span class="fu">Husky</span>();
Husky v2 = (Husky)v1; <span class="co">//legal casting</span></code></pre></div>
<p>The biggest benefit from polymorphism is abstraction. Consider:</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java"><span class="bu">ArrayList</span><Huggable> hugList = <span class="kw">new</span> <span class="bu">ArrayList</span><Huggable>(); <span class="co">//a list of huggable things</span>
hugList.<span class="fu">add</span>(<span class="kw">new</span> <span class="fu">Husky</span>()); <span class="co">//a Husky is Huggable</span>
hugList.<span class="fu">add</span>(<span class="kw">new</span> <span class="fu">TeddyBear</span>()); <span class="co">//so are Teddybears!</span>
<span class="co">//enhanced for loop ("foreach" loop)</span>
<span class="co">//read: "for each Huggable in the hugList"</span>
<span class="kw">for</span>(Huggable thing : hugList) {
thing.<span class="fu">hug</span>();
}</code></pre></div>
<p><strong><em>Practice: What happens if you run the above code?</em></strong> Because Huskies and Teddy Bears share the same behavior (<code>interface</code>), we can treat them as a single “type”, and so put them both in a list. And because everything in the list supports the <code>Huggable</code> interface, we can call <code>.hug()</code> on each item in the list and we know they’ll have that method—they promised by <code>implementing</code> the interface after all!</p>
</div>
<div id="abstract-methods-and-classes" class="section level2">
<h2><span class="header-section-number">A.6</span> Abstract Methods and Classes</h2>
<p>Take another look at the <code>Huggable</code> interface you created. It contains a single method declaration… followed by a semicolon instead of a method body. This is an <a href="https://docs.oracle.com/javase/tutorial/java/IandI/abstract.html"><strong>abstract method</strong></a>: in fact, you can add the <code>abstract</code> keyword to this method declaration without changing anything (all methods are interfaces are implicitly <code>abstract</code>, so it isn’t required):</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java"><span class="kw">public</span> <span class="kw">abstract</span> <span class="dt">void</span> <span class="fu">hug</span>();</code></pre></div>
<p>An <strong>abstract method</strong> is one that does not (yet) have a method body: it’s just the signature, but no actual implementation. It is “unfinished.” In order to instantiate a class (using the <code>new</code> keyword), that class needs to be “finished” and provide implementations for <em>all</em> abstract methods—e.g., all the ones you’ve inherited from an interface. This is exactly how you’ve used <code>interfaces</code> so far: it’s just another way of thinking about why you need to provide those methods.</p>
<p>If the <code>abstract</code> keyword is implied for interfaces, what’s the point? Consider the <code>Animal</code> class (which is a parent class for <code>Dog</code>). The <code>.speak()</code> method is “empty”; in order for it to do anything, the subclass needs to override it. And currently there is nothing to stop someone who is subclassing <code>Animal</code> from forgetting to implement that method!</p>
<p>We can <em>force</em> the subclass to override this method by making the method <code>abstract</code>: effectively, leaving it unfinished so that if the subclass (e.g., <code>Dog</code>) wants to do anything, it must finish up the method. <strong><em>Practice: Make the <code>Animal#speak()</code> method <code>abstract</code>. What happens when you try and build the code?</em></strong></p>
<p>If the <code>Animal</code> class contains an unfinished (<code>abstract</code>) method… then that class itself is unfinished, and Java requires us to mark it as such. We do this by declaring the <em>class</em> as <code>abstract</code> in the class declaration :</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java"><span class="kw">public</span> <span class="kw">abstract</span> <span class="kw">class</span> MyAbstractClass {...}</code></pre></div>
<p><strong><em>Practice: Make the <code>Animal</code> class <code>abstract</code>.</em></strong> You will need to provide an implementation of the <code>.speak()</code> method in the <code>Dog</code> class: try just having it call the <code>.bark()</code> method (method composition for-the-win!).</p>
<p>Only abstract classes and <code>interfaces</code> can contain <code>abstract</code> methods. In addition, an <code>abstract</code> class is unfinished, meaning it can’t be instantiated. <strong><em>Practice: Try to instantiate a <code>new Animal()</code>. What happens?</em></strong> Abstract classes are great for containing “most” of a class, but making sure that it isn’t used without all the details provided. And if you think about it, we’d never want to ever instantiate a generic <code>Animal</code> anyway—we’d instead make a <code>Dog</code> or a <code>Cat</code> or a <code>Turtle</code> or something. All that the <code>Animal</code> class is doing is acting as an <strong>abstraction</strong> for these other classes to allow them to share implementations (e.g., of a <code>walk()</code> method).</p>
<ul>
<li>Abstract classes are a bit like “templates” for classes… which are themselves “templates” for objects.</li>
</ul>
</div>
<div id="generics" class="section level2">
<h2><span class="header-section-number">A.7</span> Generics</h2>
<p>Speaking of templates: think back to the <code>ArrayList</code> class you’ve used in the past, and how you specified the “type” inside that List by using angle brackets (e.g., <code>ArrayList<Dog></code>). Those angle brackets indicate that <code>ArrayList</code> is a <a href="https://docs.oracle.com/javase/tutorial/java/generics/">generic</a> class: a template for a class where a <em>data type</em> for that class is itself a variable.</p>
<p>Consider the <code>GiftBox</code> class, representing a box containing a <code>TeddyBear</code>. <strong><em>What changes would you need to make to this class so that it contains a <code>Husky</code> instead of a <code>TeddyBear</code>? What about if it contained a <code>String</code> instead?</em></strong></p>
<p>You should notice that the only difference between <code>TeddyGiftBox</code> and <code>HuskyGiftBox</code> and <code>StringGiftBox</code> would be the <strong>variable type</strong> of the contents. So rather than needing to duplicate work and write the same code for every different type of gift we might want to give… we can use <strong>generics</strong>.</p>
<p>Generics let us specify a data type (e.g., what is currently <code>TeddyBear</code> or <code>String</code>) as a <em>variable</em>, which is set when we instantiate the class using the angle brackets (e.g., <code>new GiftBox<TeddyBear>()</code> would create an object of the class with that type variable set to be <code>TeddyBear</code>).</p>
<p>We specify generics by declaring the data type variable in the class declaration:</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java"><span class="kw">public</span> <span class="kw">class</span> GiftBox<T> {...}</code></pre></div>
<p>(<code>T</code> is a common variable name, short for “Type”. Other options include <code>E</code> for Elements in lists, <code>K</code> for Keys and <code>V</code> for Values in maps).</p>
<p>And then everywhere you would have put a datatype (e.g., <code>TeddyBear</code>), you can just put the <code>T</code> variable instead. This will be replace by an <em>actual</em> type <strong>at compile time</strong>.</p>
<ul>
<li>Warning: <em>always</em> use single-letter variable names for generic types! If you try to name it something like <code>String</code> (e.g., <code>public class GiftBox<String></code>), then Java will interpret the word <code>String</code> to be that variable type, rather than referring to the <code>java.lang.String</code> class. This a lot like declaring a variable <code>int Dog = 448</code>, and then calling <code>Dog.createPuppies()</code>.</li>
</ul>
<p><strong><em>Practice: Try to make the <code>GiftBox</code> class generic and instantiate a new <code>GiftBox<Husky></code></em></strong></p>
</div>
<div id="nested-classes" class="section level2">
<h2><span class="header-section-number">A.8</span> Nested Classes</h2>
<p>One last piece: we’ve been putting <em>attributes</em> and <em>methods</em> into classes… but we can also define additional <em>classes</em> inside a class! These are called <a href="https://docs.oracle.com/javase/tutorial/java/javaOO/nested.html"><strong>nested</strong> or <strong>inner classes</strong></a>.</p>
<p>We’ll often nest “helper classes” inside a bigger class: for example, you may have put a <code>Node</code> class inside a <code>LinkedList</code> class:</p>
<div class="sourceCode"><pre class="sourceCode java"><code class="sourceCode java"><span class="kw">public</span> <span class="kw">class</span> <span class="bu">LinkedList</span> {
<span class="co">//nested class</span>
<span class="kw">public</span> <span class="kw">class</span> <span class="bu">Node</span> {
<span class="kw">private</span> <span class="dt">int</span> data;
<span class="kw">public</span> <span class="bu">Node</span>(<span class="dt">int</span> data) {
<span class="kw">this</span>.<span class="fu">data</span> = data;
}
}
<span class="kw">private</span> <span class="bu">Node</span> start;
<span class="kw">public</span> <span class="bu">LinkedList</span>() {
<span class="kw">this</span>.<span class="fu">start</span> = <span class="kw">new</span> <span class="bu">Node</span>(<span class="dv">448</span>);
}
}</code></pre></div>
<p>Or maybe we want to define a <code>Smell</code> class inside the <code>Dog</code> class to represent different smells, allowing us to talk about different <code>Dog.Smell</code> objects. (And of course, the <code>Dog.Smell</code> class would implement the <code>Sniffable</code> interface…)</p>
<p>Nested classes we define are usually <code>static</code>: meaning they belong to the <em>class</em> not to object instances of that class. This means that there is only one copy of that nested blueprint class in memory; it’s the equivalent to putting the class in a separate file, but nesting lets us keep them in the same place and provides a “namespacing” function (e.g., <code>Dog.Smell</code> rather than just <code>Smell</code>).</p>
<p>Non-static nested classes (or <strong>inner classes</strong>) on the other hand are defined for each object. This is important only if the behavior of that class is going to depend on the object in which it lives. This is a subtle point that we’ll see as we provide inner classes required by the Android framework.</p>
</div>
</div>
</section>
</div>
</div>
</div>
<a href="multi-touch.html" class="navigation navigation-prev " aria-label="Previous page"><i class="fa fa-angle-left"></i></a>
<a href="java-swing.html" class="navigation navigation-next " aria-label="Next page"><i class="fa fa-angle-right"></i></a>
</div>
</div>
<script src="libs/gitbook-2.6.7/js/app.min.js"></script>
<script src="libs/gitbook-2.6.7/js/lunr.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-search.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-sharing.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-fontsettings.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-bookdown.js"></script>
<script src="libs/gitbook-2.6.7/js/jquery.highlight.js"></script>
<script>
gitbook.require(["gitbook"], function(gitbook) {
gitbook.start({
"sharing": {
"github": true,
"facebook": false,
"twitter": false,
"google": false,
"weibo": false,
"instapper": false,
"vk": false,
"all": ["github", "facebook", "twitter", "google"]
},
"fontsettings": {
"theme": "white",
"family": "sans",
"size": 2
},
"edit": {
"link": "https://github.com/info448/book/edit/master/java-review.Rmd",
"text": "Edit"
},
"download": ["android-development.pdf", "android-development.epub"],
"toc": {
"collapse": "section",
"scroll_highlight": true
}
});
});
</script>
<!-- dynamically load mathjax for compatibility with self-contained -->
<script>
(function () {
var script = document.createElement("script");
script.type = "text/javascript";
script.src = "https://cdn.bootcss.com/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML";
if (location.protocol !== "file:" && /^https?:/.test(script.src))
script.src = script.src.replace(/^https?:/, '');
document.getElementsByTagName("head")[0].appendChild(script);
})();
</script>
</body>
</html>