Summary  
This chapter covers how null references lead to NullPointerExceptions when invoking methods on uninitialized objects and shows how to prevent them by initializing variables or checking for null before use.  

General domain of usage  
Handling input data from external APIs or databases  

## NPE

Käsitellään ``null``-arvon käsitettä merkkijonon muuttujalle. Kun luodaan merkkijonon muuttuja, mutta sitä ei alusteta, se saa arvon ``null``.
Vertailun vuoksi, jos ``int``-muuttujaa ei alusteta, se saa arvon ``0``.

Tarkastellaan esimerkkiä merkkijonon muuttujasta, jonka arvo on ``null``:


cGFja2FnZSBjb20uZXhhbXBsZTsKCnB1YmxpYyBjbGFzcyBNYWluIHsKICAgIHB1YmxpYyBzdGF0aWMgdm9pZCBtYWluKFN0cmluZ1tdIGFyZ3MpIHsKICAgICAgICBTdHJpbmcgc3RyaW5nID0gbnVsbDsKICAgICAgICBTeXN0ZW0ub3V0LnByaW50bG4oc3RyaW5nKTsKICAgIH0KfQ==

Kuten huomaat, näytölle tulostuu ``null`` ja koodi näyttää toimivan. Kokeillaan nyt käyttää mitä tahansa metodia muuttujalla, jonka arvo on ``null``:


cGFja2FnZSBjb20uZXhhbXBsZTsKCnB1YmxpYyBjbGFzcyBNYWluIHsKICAgIHB1YmxpYyBzdGF0aWMgdm9pZCBtYWluKFN0cmluZ1tdIGFyZ3MpIHsKICAgICAgICBTdHJpbmcgc3RyaW5nID0gbnVsbDsKICAgICAgICBzdHJpbmcudG9Mb3dlckNhc2UoKTsKICAgICAgICBTeXN0ZW0ub3V0LnByaW50bG4oc3RyaW5nKTsKICAgIH0KfQ==

Kun yritetään kutsua mitä tahansa metodia merkkijonon muuttujalle, jonka arvo on **null**, saadaan ``NullPointerException``.

Tapoja välttää **NPE**:

- Ole huolellinen. Jos luot merkkijonon muuttujan, tarkista kahdesti, että olet alustanut sen;
- Käytä **null-tarkistusta** ennen muuttujan käyttöä, esimerkiksi.


cGFja2FnZSBjb20uZXhhbXBsZTsKCnB1YmxpYyBjbGFzcyBNYWluIHsKICAgIHB1YmxpYyBzdGF0aWMgdm9pZCBtYWluKFN0cmluZ1tdIGFyZ3MpIHsKICAgICAgICBTdHJpbmcgc3RyaW5nID0gbnVsbDsKICAgICAgICBpZiAoc3RyaW5nID09IG51bGwpIHsgLy8gbnVsbCBjaGVjawogICAgICAgICAgICBTeXN0ZW0ub3V0LnByaW50bG4oIkNhbid0IHVzZSBtZXRob2RzIHdpdGggc3RyaW5nLCBiZWNhdXNlIHZhbHVlIGlzIG51bGwiKTsKICAgICAgICB9IGVsc2UgewogICAgICAgICAgICBTeXN0ZW0ub3V0LnByaW50bG4oc3RyaW5nKTsKICAgICAgICB9CiAgICB9Cn0=

package com.example;

import org.junit.jupiter.api.DynamicTest;
import org.junit.jupiter.api.TestFactory;

import java.io.ByteArrayOutputStream;
import java.io.PrintStream;
import java.util.Arrays;
import java.util.List;
import java.util.stream.IntStream;
import java.util.stream.Stream;

import static org.junit.jupiter.api.Assertions.*;
import static org.junit.jupiter.api.DynamicTest.dynamicTest;

public class MainTest {

    @TestFactory
    Stream<DynamicTest> testValidateEmails() {
        List<TestCase> testCases = List.of(
                new TestCase(
                        new String[]{"alice@company.com", null, "bob@company.com", null, "charlie@company.com"},
                        new String[]{
                                "alice@company.com",
                                "Invalid or missing email",
                                "bob@company.com",
                                "Invalid or missing email",
                                "charlie@company.com"
                        },
                        "Mixed valid and null emails"
                ),
                new TestCase(
                        new String[]{null, null},
                        new String[]{"Invalid or missing email", "Invalid or missing email"},
                        "All emails are null"
                ),
                new TestCase(
                        new String[]{"noatsymbol.com", "valid@mail.com"},
                        new String[]{"Invalid or missing email", "valid@mail.com"},
                        "One email missing '@', one valid"
                )
        );

        return IntStream.range(0, testCases.size()).mapToObj(i -> {
            TestCase tc = testCases.get(i);
            String inputStr = tc.input == null ? "null" : Arrays.toString(tc.input);

            try {
                ByteArrayOutputStream out = new ByteArrayOutputStream();
                PrintStream originalOut = System.out;
                System.setOut(new PrintStream(out));

                Main.validateEmails(tc.input);

                System.setOut(originalOut);

                String actual = out.toString().trim();
                String expected = tc.expected == null ? "" : String.join(System.lineSeparator(), tc.expected);

                String name = actual.equals(expected)
                        ? tc.description + " -> Output as expected"
                        : tc.description + " -> Output mismatch";

                return dynamicTest(name, () -> assertEquals(expected, actual));

            } catch (Exception e) {
                String name = "Runtime error: " + e.getClass().getSimpleName() +
                        " - " + e.getMessage() + " | Input: " + inputStr;
                return dynamicTest(name, () -> fail("Unexpected exception: " + e));
            }
        });
    }

    record TestCase(String[] input, String[] expected, String description) {}
}


MainTest.java

Tiivis aloitusmoduuli, joka keskittyy Java-ohjelmoinnin keskeisiin peruskäsitteisiin: syntaksi, muuttujat, tietotyypit, ohjausrakenteet, silmukat, taulukot ja merkkijonot.

Nullpointerexception

NPE

Ratkaisu