Advanced Coding & Software Engineering Program

Java Syntax and Structure Tutorial for Beginners

---

Last Updated on: 15th Aug 2025 21:09:35 PM

Welcome to this interactive and beginner-friendly tutorial on Java syntax and structure! This guide is designed for students new to programming, helping you understand the building blocks of a Java program in a simple, engaging way. We’ll cover the Java program structure, the main method, case sensitivity, file naming, coding conventions, packages and imports, keywords and identifiers, and comments (including single-line, multi-line, and Javadoc). Each section includes clear explanations, code snippets, and interactive practice ideas to make learning fun and effective.

 

1. Java Program Structure

A Java program is like a recipe: it has a specific structure to ensure everything works correctly. Every Java program is organized into classes, and the code is written in a structured way to make it readable and executable.

 

Basic Structure of a Java Program

Here’s a simple Java program to illustrate its structure:

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

 

Breakdown of the Structure

 

• Class Declaration: public class HelloWorld defines a class named HelloWorld. A class is like a blueprint for organizing code.

• Main Method: public static void main(String[] args) is the starting point of the program.

• Code Block: The curly braces {} enclose the code that runs inside the class or method.

• Statement: System.out.println("Hello, World!"); is a single instruction that prints text.

 

Interactive Practice

 

• Try It: Create a file named Welcome.java and write a program to print “Welcome to Java!”. Save it, compile it (javac Welcome.java'), and run it (java Welcome`).

 

2. Main Method Explained

The main method is the entry point of a Java program. When you run a program, the Java Virtual Machine (JVM) looks for this method to start execution.

 

Main Method Syntax

public static void main(String[] args) {
    // Code goes here
}

 

Explanation

• public: The method is accessible from anywhere.

• static: The method belongs to the class, not an object, so the JVM can call it without creating an instance.

• void: The method doesn’t return any value.

• main: The name of the method, required by the JVM.

• String[] args: A parameter that allows the program to accept command-line arguments (like user inputs when running the program).

 

Example: Using the Main Method

public class GreetUser {
    public static void main(String[] args) {
        System.out.println("Hello, Java Beginner!");
    }
}

 

Interactive Practice

 

• Try It: Modify the program above to print your name instead of “Java Beginner”. Run it in your IDE or command line to see the output.

 

3. Case Sensitivity, File Naming, and Basic Coding Conventions

Java is case-sensitive, meaning Hello and hello are treated as different names. This applies to class names, variable names, and more. Let’s explore this along with file naming and coding conventions.

 

Case Sensitivity

• Example: MyClass is not the same as myclass.

• Why It Matters: If you name a class MyProgram but save the file as myprogram.java, Java will throw an error.

 

File Naming Rules

• The file name must match the public class name exactly, including case, and end with .java.

• Example: For public class HelloWorld, the file must be HelloWorld.java.

• Only one public class is allowed per file.

 

Basic Coding Conventions

• Class Names: Use PascalCase (e.g., MyClass, HelloWorld).

• Method Names: Use camelCase (e.g., printMessage, calculateSum).

• Indentation: Use 2 or 4 spaces (or one tab) to indent code inside blocks for readability.

• Braces: Place opening { on the same line as the class/method declaration and closing } on a new line.

 

Example:

public class GoodStyle {
    public static void main(String[] args) {
        System.out.println("This follows conventions!");
    }
}

 

Interactive Practice

 

• Try It: Create a file named TestProgram.java with a class TestProgram. Print a message like “I’m learning Java!”. Then, try saving it as testprogram.java (lowercase) and see what error you get. Fix it by matching the file name to the class name.

 

4. Packages and Imports

 

What is a Package?

A package is like a folder that organizes related Java classes. It prevents naming conflicts and makes code reusable. For example, Java’s standard library has packages like java.util for utilities.

 

Declaring a Package

 

• Add a package statement at the top of your file:

package myapp;
public class MyProgram {
    public static void main(String[] args) {
        System.out.println("Inside myapp package!");
    }
}

 

• File Location: Save MyProgram.java in a folder named myapp (e.g., myapp/MyProgram.java).

• Compile and Run: From the parent directory, use javac myapp/MyProgram.java and java myapp.MyProgram.

 

Using Imports

 

The import statement lets you use classes from other packages without writing their full path.

 

Example: Using Scanner for user input:

import java.util.Scanner;
public class InputDemo {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        System.out.print("Enter your name: ");
        String name = scanner.nextLine();
        System.out.println("Hello, " + name + "!");
        scanner.close();
    }
}

 

Explanation:

• import java.util.Scanner: Imports the Scanner class from the java.util package.

• Without the import, you’d need to write java.util.Scanner every time.

 

Interactive Practice

 

Try It: Create a folder named myapp, place the InputDemo.java code above in it, and add package myapp; at the top. Compile and run it from the parent directory. Then, try removing the import statement and use java.util.Scanner directly to see the difference.

 

5. Java Keywords and Identifiers

 

Java Keywords

 

Keywords are reserved words in Java with special meanings. You cannot use them as names for classes, variables, or methods.

• Examples: public, class, static, void, if, for, return, import, package.

• Full List: Some common keywords include int, double, boolean, while, break, try, catch. There are about 50 keywords in Java.

• Rule: Keywords are case-sensitive and cannot be used as identifiers.

 

Identifiers

 

Identifiers are names you create for classes, methods, or variables.

• Rules:

  • Must start with a letter, underscore (_), or dollar sign ($).

  • Can include letters, digits, _, or $.

  • Cannot be a keyword.

  • Case-sensitive (e.g., myVar ≠ MyVar).

• Examples:

  • Valid: myVariable, calculateSum, Student_1, $price.

  • Invalid: 2var (starts with a number), public (keyword), my-var (contains hyphen).

 

Example: Keywords and Identifiers

public class IdentifierDemo {
    public static void main(String[] args) {
        int studentCount = 10; // Valid identifier
        // int class = 5; // Invalid: 'class' is a keyword
        System.out.println("Student count: " + studentCount);
    }
}

 

Interactive Practice

Try It: Write a program with a variable named age to store your age and print it. Then, try using a keyword like int as a variable name (e.g., int int = 5;) and see the error. Fix it by choosing a valid identifier like number.

 

6. Comments in Java

 

Comments are notes in your code that explain what it does. They’re ignored by the compiler and help make code readable.

 

Types of Comments

 

1. Single-Line Comments (//):

   • Used for short notes.

   • Example:

 

// This prints a welcome message
System.out.println("Welcome!");

 

2. Multi-Line Comments (/* ... */):

   • Used for longer explanations or commenting out code.

   • Example:

 

/* This program calculates
   the sum of two numbers */
int sum = 5 + 3;

 

3. Javadoc Comments (/** ... */):

   • Used to generate documentation for classes, methods, or variables.

   • Example:

/** This method prints a greeting to the user */
public void sayHello() {
    System.out.println("Hello!");
}

 

Example: Using All Comment Types

/** 
 * This program demonstrates comments in Java.
 * Author: Your Name
 */
public class CommentDemo {
    public static void main(String[] args) {
        // Print a message to the console
        System.out.println("Learning Java Comments!");
        
        /* This is a multi-line comment.
           It can span multiple lines. */
        int number = 42; // Answer to everything
        System.out.println("Number: " + number);
    }
}

 

 

Interactive Practice

 

Try It: Create a program named CommentPractice.java. Add:

• A Javadoc comment above the class explaining its purpose.

• A single-line comment before a print statement.

• A multi-line comment describing a variable.

• Example output: Print your favorite number with a comment explaining why you chose it.

 

7. Putting It All Together: A Complete Example

Here’s a program combining all concepts (structure, main method, case sensitivity, packages, imports, keywords, identifiers, and comments):

package myapp; // Package declaration

import java.util.Scanner; // Import Scanner for input

/** 
 * This program greets the user and calculates their birth year.
 * Author: Java Beginner
 */
public class UserGreeting {
    public static void main(String[] args) {
        // Create a Scanner object for input
        Scanner scanner = new Scanner(System.in);
        
        // Prompt user for name and age
        System.out.print("Enter your name: ");
        String userName = scanner.nextLine(); // Valid identifier
        
        System.out.print("Enter your age: ");
        int userAge = scanner.nextInt(); // Valid identifier
        
        /* Calculate birth year based on current year (2025)
           Assumes user has had their birthday this year */
        int birthYear = 2025 - userAge;
        
        // Print greeting and birth year
        System.out.println("Hello, " + userName + "! You were born around " + birthYear + ".");
        
        scanner.close(); // Close the Scanner
    }
}

 

How to Use It

• Save in a myapp folder as myapp/UserGreeting.java.

• Compile: javac myapp/UserGreeting.java.

• Run: java myapp.UserGreeting.

• Example output:

 

Enter your name: Alice
Enter your age: 20
Hello, Alice! You were born around 2005. 

 

Interactive Practice

Try It: Save and run the program above. Modify it to:

• Print a different greeting (e.g., “Welcome, [name]!”).

• Add a Javadoc comment for the main method.

• Try using an invalid identifier (e.g., int 2age) and fix the error.

 

8. Tips for Beginners

• Practice Naming: Use meaningful identifiers (e.g., studentName instead of x) and follow naming conventions.

• Comment Often: Add comments to explain your code, especially for complex logic.

• Test Case Sensitivity: Try mismatched class and file names to understand errors.

• Explore Packages: Create multiple classes in a package to organize your code.

 

9. Conclusion

You’ve learned the essentials of Java syntax and structure! You now understand how to structure a Java program, use the main method, follow case sensitivity and naming rules, organize code with packages and imports, use keywords and identifiers correctly, and add comments for clarity. These concepts form the foundation of Java programming.

---