Java: Summary - Basic Elements

In this section we will see how to comment your Java code.

We will also see the Identifiers and Keyword of Java API.

Properly commenting the Java code is very important. Commenting the programming code is one of the best practices of good programming. You should always comment your Java code properly.

Java provides three different methods of commenting the code.

Following table summarizes the different methods of commenting code.

a) Use // for commenting

b) Use /* .... */ for commenting

c) Use /** ..... */ for commenting in Java code

Java compiler ignores the text marked as comment.

Comments

// Everything to the end of the line is ignored. Use for most comments.
/* Everything (possibly many lines) is ignored until a */. Uncommon. Use for commenting out code.
/** Used for automatic HTML documentation generation by the javadoc program. */

Identifier Names

Start identifiers with an alphabetic character (a-z or A-Z), and continue with alphabetic, numeric (0-9), or '_' (underscore) characters. Do not use $.
Second words in a name should start with an uppercase letter.
Do not use keywords (see below).
Class and interface names should start with an uppercase letter (Graphics, ActionListener, JButton, ...)
Variable and method names should start with a lowercase letter (repaint(), x, ...).
Constants should be all uppercase with underscores between words (BoxLayout.X_AXIS, Math.PI, ...).

Keywords

The keywords are divided into three categories by expected student usage. Maybe try, catch, and assert are more common.

Category	Very common	Less Common	Uncommon
Primitive Types	`boolean char double int true false`	`byte float short long`
Control Flow	`if else while for switch case break default return`	`assert do try catch`	`continue finally throw synchronized`
OOP	`class extends implements new null this enum`	`interface super`	`instanceof`
Declarations	`public private import package static final void`	`throws`	`protected transient volatile native`
Other			`strictfp goto const`

Variables - Local, Instance, Class

Variables may be local, instance (field), or static (class) variables. Formal parameters are local variables that are assigned values when the method is called.

	local	instance	static / class
Where declared	In a method.	In class, but not in a method.	In class using `static` keyword.
Initial value	Must assign a value before using. Compiler error if you don't.	Zero for numbers, null for objects, false for boolean. Or initialized in constructor.	Zero/null/false or initialized in static initializer.
Visibility	Only in the same method. No visibility may be declared.	`private`: Only methods in this class. Default: All methods in same package. `public`: Anyone can see it. `protected`: This class and all subclasses can see it.	Same as instance.
When created	When method is entered.	When an instance of the class (object) is created with `new`.	When program is loaded.
Where in memory	Call stack.	Heap.	"Permanent" memory.
When destroyed	When the method returns.	When there are no more references to the object.	When program terminates.

Related Tags for Summary - Basic Elements:
java, html, c, com, ide, documentation, comments, io, sed, word, ado, char, javadoc, core, key, keywords, name, line, id, tar, character, case, cas, characters, start, if, for, ie, unc, cte, keyword, with, alpha, ignore, numeric, program, to, automatic, ram, generation, comment, lines, pos, names, ld, ssi, sh, words, auto, e, il, it, doc, commenting, not, li, uppercase, use, ul, pe, man, art, continue, identifier, in, no, ml, as, sta, m, nt, out, underscore, thin, os, ca, os, let, letter, j, ad, alphabet, es, end, common, ase, rc, me, identifiers, pro, pp, do, s, star, at, any, rac, ratio, oss, k, htm, is, ha, oma, and, ar, act, cod, code, rds, rt, va, tt, z, sco, s, s, ri, rd, th, sho, cond, av, st, ab, ati, alphabetic, many, ident, ident, pr, most, nd, ode, on, om, ogr, o, nor

«Previous Index Next»