Java 'this' Keyword: Variable Shadowing, References & Method Chaining

In Java, this is a reserved reference variable that refers directly to the current object—the instance whose method or constructor is actively executing on the thread stack.

The 6 Major Usages of this in Java

1. Resolving Variable Shadowing (Most Common)

When a constructor parameter or method parameter has the exact same name as an instance variable, the local parameter "shadows" the instance variable. Prepending this. tells the compiler to access the object's instance variable:

public class Product {
    private String name;
    private double price;

    public Product(String name, double price) {
        // Without 'this', 'name = name' assigns parameter to itself (No effect!)
        this.name = name;   // Assigns parameter to instance field
        this.price = price; // Assigns parameter to instance field
    }
}

2. Invoking Overloaded Constructors via this()

Used to delegate initialization tasks across constructors (as explored in Class 21):

public Product(String name) {
    this(name, 0.0); // Calls the two-argument constructor
}

3. Returning this to Enable Method Chaining (Fluent API)

Returning this allows developers to chain multiple configuration method calls in a readable pipeline:

public class QueryBuilder {
    private String query = "";

    public QueryBuilder select(String fields) {
        this.query += "SELECT " + fields + " ";
        return this; // Returns current instance
    }

    public QueryBuilder from(String table) {
        this.query += "FROM " + table + " ";
        return this;
    }

    public QueryBuilder where(String condition) {
        this.query += "WHERE " + condition;
        return this;
    }

    public String build() {
        return this.query;
    }

    public static void main(String[] args) {
        // Method Chaining in action:
        String sql = new QueryBuilder()
            .select("id, username, email")
            .from("users")
            .where("status = 'ACTIVE'")
            .build();

        System.out.println("Generated SQL: " + sql);
    }
}