Java Language

External

• https://docs.oracle.com/javase/specs/jls/se8/html/

Internal

• Java

Lexical Structure

Keywords

Keywords cannot be used as identifiers.

• if
• else
• continue
• break
• for
• do
• while
• switch
• case
• default
• private
• protected
• public
• import
• package
• abstract
• implements
• extends
• interface
• class
• static See class variables.
• final
• return
• transient
• void
• byte
• short
• int
• long
• char
• float
• double
• boolean
• try
• catch
• finally
• throw
• throws
• new
• this
• super
• instanceof
• native
• synchronized See synchronized statement and synchronized modifier.
• volatile
• goto No longer in use.
• const No longer in use.
• strictfp. Added in 1.2.
• assert Added in 1.4.
• enum Added in 5.0.
• module Added in 9.0.
• requires Added in 9.0.
• transitive Added in 9.0.
• exports to Added in 9.0.
• uses Added in 9.0.
• provides Added in 9.0.
• with Added in 9.0.
• opens to Added in 9.0.
• var. Special identifier added in Java 10.

Statements

Programming Languages Concepts | Statements

synchronized

The synchronized statement acquires a mutual-exclusion lock on behalf of the executing thread, executes a block, then releases the lock. While the executing thread owns the log, no other thread may acquire the lock.

synchronized (expression) block

The type of expression must be a reference type.

Also see:

'synchronized' mechanism

return

Control-flow statement.

Modifiers

Method Modifiers

synchronized

A synchronized class method synchronizes on the monitor associated with the Class object of that class.

A synchronized instance method synchronizes on the monitor associated with this - the object instance it is invoked onto.

Also see:

'synchronized' mechanism

Literals

Reserved Words for Literal Values

true, false, null.

The reserved words for literal values cannot be used as identifiers.

Operators

Multiplicative Operators

Remainder Operator %

The binary operator % produces the remainder of its operands from an implied division. The left-hand operand is the dividend and the right-hand operand is the divisor. It accepts integral and floating point operands. The remainder operation for operands that are integers after binary numeric promotion produces a value such that (a/b)*b + (a%b) is equal to a.

TODO: Document the difference between the remainder and modulo.

Shift Operators

https://docs.oracle.com/javase/specs/jls/se8/html/jls-15.html#jls-15.19

Left Shift <<

int a = 1;
a << 1;
assert a == 2;

Signed Right Shift >>

int a = 2;
a >>= 1;
assert a == 1;

Bitwise and Logical Operators

Both operands must be of primitive integral type. If both operands are of the same type, the result of the operation is of the same type. If the operands are of different primitive integral types, the smallest type is converted into the largest type via binary numeric promotion first, and the result if of the largest type. Also see:

Bitwise Operations

Integer Bitwise AND &

& computes the bitwise AND between operands. Both operands must be primitive integral types. See Bitwise and Logical Operators for more details on result type and promotions.

Integer Bitwise OR |

| computes the bitwise OR between operands. Both operands must be primitive integral types. See Bitwise and Logical Operators for more details on result type and promotions.

Integer Bitwise XOR ^

^ computes the bitwise exclusive OR (XOR) between operands. Both operands must be primitive integral types. See Bitwise and Logical Operators for more details on result type and promotions. Useful in calculating the Hamming distance.

A	B	XOR
0	0	0
0	1	1
1	0	1
1	1	0

Assignment Operators

Assignment operators: =, *=, /=, %=, +=, -=, <<=, >>=, >>>=, &=, ^=, |=.

Types

Java is a statically typed language, which means that every variable and every expression has a type that is known at compile time.

Java is strongly typed language, because the types limit the values a variable can hold or that an expression can produce, limit the operations supported by those types and determine the meaning of operations.

Primitive Types

The primitive types are boolean and the numeric types (integral and floating point).

The numeric types are the integral types byte, short, int, long and char, and the floating-point types float and double.

boolean

https://docs.oracle.com/javase/specs/jls/se8/html/jls-4.html#jls-4.2.5

The boolean type represents a logical quantity with two possible values, indicated by the literals true and false. Boolean primitive values are stored on 1 bit.

Integral Primitive Types

An integral data type is a data type whose values are integers. There are five integral primitive types in Java: byte, short, int, long and char. Of those, the first four (byte, short, int and long) are signed, and char is unsigned.

byte

byte represents an integral signed value on 1 byte (8 bit) in a two's complement representation. The rage is -2⁷ -128 to 2⁷-1 127. More more details see byte representation in two's complement. Unlike int and long literals (see below), there are no byte literals; however, any int literal within the byte range can be assigned to a byte variable.

int or long variables cannot assigned to a byte variable without type casting.

byte has a corresponding reference wrapper type java.lang.Byte.

short

2 bytes, signed (two's complement), -32,768 to 32,767. For more details see short representation in two's complement.

int

int represents an integral signed value on 4 bytes (32 bit) in a two's complement representation. The range is -2,147,483,648 to 2,147,483,647. For more details see int representation in two's complement. Like all numeric types ints may be cast into other numeric types (byte, short, long, float, double). When lossy casts are done (e.g. int to byte) the conversion is done modulo the length of the smaller type.

All whole numbers in the -2³¹ to 2³¹-1 are known as integer literals, or integer constants. An integer literal can be assigned to an int variable:

int i = 57;

int has a corresponding reference wrapper type java.lang.Integer.

long

long represents an integral signed value on 8 bytes (64 bit) in a two's complement representation. The range is from -2⁶³ -9,223,372,036,854,775,808 to 2⁶³-1 9,223,372,036,854,775,807. For more details see long representation in two's complement.

All whole numbers in the -2⁶³ to 2⁶³-1 are known as integer literals of long type. An integer literal of long type ends with "L" or "l":

long l = 57L;

Even if the value stored in a long variable is well within the range of the int data type, the assignment from long to int is not allowed without explicit type casting. If casting is not performed, a compilation error occurs.

long has a corresponding reference wrapper type java.lang.Long.

char

Contains an 2-byte (16 bit) (0x0000 - 0xFFFF, 0 - 65,535) unsigned Unicode code point. For a detailed discussion on Unicode representation in Java see:

Java and Unicode

A character literal represents the value of the char data type.

char c = 'A';

A character literal can also be expressed as a character escape sequence, which starts with a backslash immediately followed by a character, and bot h are enclosed in single quotes. There are eight predefined character escape sequences:

Character escape sequence	Description
'\n'	Linefeed
'\r'	Carriage return
'\f'	Form feed
'\b'	Backspace
'\t'	Tab
'\\'	Backslash
'\"'	Double quote
'\''	Single quote

Floating Point Primitive Types

Java uses a floating point format to represent real numbers. Floating point representations are slower and less accurate compared to fixed-point representations. However, floating point representations can handle a larger range of numbers with the same computer memory.

float

https://docs.oracle.com/javase/specs/jls/se7/html/jls-4.html#jls-4.2.3

4 bytes, IEEE 754, named "single-precision floating-point number". Covers a range from 1.40129846432481707e-45 to 3.40282346638528860e+38 (positive or negative). Like all numeric types floats may be cast into other numeric types (byte, short, long, int, double). When lossy casts to integer types are done (e.g. float to short) the fractional part is truncated and the conversion is done modulo the length of the smaller type.

All real numbers that end with "f" or "F" are called float literals.

float f = 1.2F;

The float data type defines a positive infinity, negative infinity and a not-a-number (NaN).

double

https://docs.oracle.com/javase/specs/jls/se7/html/jls-4.html#jls-4.2.3

8 bytes, IEEE 754, named "double-precision floating-point number". Covers a range from 4.94065645841246544e-324d to 1.79769313486231570e+308d (positive or negative).

All real numbers are called double literals. A double literal may optionally end with 'd' or 'D'. However, these suffixes are optional.

Reference Types

Java does not use pointers.

There are four kinds of reference types: class types, interface types, type variables and array types.

Array Types

In Java arrays are treated as objects with an array type. An object of an array type has all its components initialized with 0 or null upon initialization. For more details on Java arrays, see:

Java Arrays

Reference Type Value

The value of a reference type is a references to an object instance.

Also see:

Variables, Parameters, Arguments | Reference

Values

For reference type values, see above.

In case of a lambda expressions, the value of the lambda expression is the reference to a functional interface instance.

Identifier

https://docs.oracle.com/javase/specs/jls/se8/html/jls-3.html#jls-Identifier

An identifier is the name of a class, variable, method, etc.

An identifier cannot be a keyword, a boolean literal or a null literal. Identifier cannot start with a number. They can start with $, but the $ sign should be used only in mechanically generated source code or, rarely, to access pre-existing names on legacy systems.

Variables

A variable is a storage location and has an associated type - the compile-time type - that is either a primitive type or a reference type.

The value of a variable is changed by an assignment or by a prefix/postfix increment/decrement operators.

A variable cannot be used before it was initialized.

Also see:

Variables, Parameters, Arguments

Variable Name

A variable name is an identifier.

Variable Types

There are eight kinds of variables:

Class Variable

A class variable is a field declared using the keyword static within a class declaration, or with or without the keyword static within an interface declaration.

Instance Variable

An instance variable is a field declared within a class declaration without using the keyword static. An instance variable is also referred to as field.

Instance variables are stored on the heap, within the heap representation of the instance.

Array Component

Array components are unnamed variables that are created and initialized to default values whenever a new object that is an array is created.

Method Parameter

Method parameters name argument values passed to a method when the method is invoked. The function declaration has parameters, the function is invoked with arguments. For every parameter declared in a method declaration, a new parameter variable is created each time that method is invoked. The new variable is initialized with the corresponding argument from the method invocation.

Also see:

Variables, Parameters, Arguments

Constructor Parameter

Constructor parameters name argument values passed to a constructor. For every parameter declared in a constructor declaration, a new parameter variable is created each time a class instance creation expression or explicit constructor invocation invokes that constructor. The new variable is initialized with the corresponding argument from the creation expression or constructor invocation.

Lambda Parameter

A lambda parameter name argument values passed to a lambda expression body. For every parameter declared in a lambda expression, a new parameter variable is created each time a method implemented by the lambda body is invoked, and initialized with the corresponding argument value from the invocation.

Exception Parameter

An exception parameter is created each time an exception is caught by a catch clause of a try statement.

Local Variable

Local variables are declared by local variable declaration statements. The local variables are created whenever the flow of control enters a block of a for statement.

Local variable are allocated on the stack.

Final Variables

A final variable may be assigned to once.

Java 8 Effectively Final Variable

A non-final local variable or method parameter whose value is never changed after initialization is known as effectively final. Lambda expression capture and use these variables.

Expressions

Programming - Expressions

Interface

An interface groups related methods together into a contract.

All methods on an interface are implicitly public and abstract (https://docs.oracle.com/javase/specs/jls/se8/html/jls-9.html#jls-9.4). "Every method declaration in the body of an interface is implicitly public. It is permitted, but discouraged as a matter of style, to redundantly specify the public modifier for a method declaration in an interface."

Class

package <package-name>;
import <package-name>.<class-name>;
<access-modifier> class <ClassName> {
  <access-modifier> <variable-definition>;
  <access-modifier> <method-definition>;
}

Anonymous Class

Can be used for behavior parameterization.

Class Instance

Field

See Instance Variable.

Field Modifiers

volatile

https://docs.oracle.com/javase/specs/jls/se8/html/jls-8.html#jls-8.3.1.4

If a field is declared volatile, the java memory model ensures that all threads see a consistent value for the variable.

Package

Package Name

A package consists in identifiers separated by ".". The identifiers must not be a keyword, boolean literal or null literal and must contain only identifier characters. The first character must be a letter, and the following characters can be letters or digits.

Upper cases and lower cases are allowed and treated distinctly.

Access Modifiers

Access modifiers express the visibility of classes, methods and variables.

public

Declares the class/method/variable visible to any other class.

protected

Declares the class/method/variable visible to classes from the same package and subclasses.

default (package private)

No access modifier is explicitly set. Designates the class/method/variable visible to classes from the same package but not subclases.

private

Declares the class/method/variable visible only within the class.

The main() Method

package some.package;
public class SomeClass {
  public static void main(String[] args) {
     ...
  }
}