Metoda main w Javie - składnia, uruchamianie i błędy

Program w Javie może mieć dziesiątki klas i setki metod, ale uruchomienie zwykle zaczyna się w jednym, konkretnym miejscu. Metoda main jest punktem startowym aplikacji, dlatego jej składnia, argumenty, sposób uruchamiania i typowe błędy szybko stają się podstawą codziennej pracy z Javą.

Co oznacza java main w praktyce

W praktyce określenie java main odnosi się do metody wejściowej programu, czyli fragmentu kodu, od którego launcher Javy zaczyna wykonywanie aplikacji. Najczęściej wygląda ona tak:

public static void main(String[] args) {
    System.out.println("Witaj, świecie!");
}

Nie jest to zwykła metoda wywoływana przypadkowo w trakcie działania programu. To punkt, który launcher przekazuje do JVM, czyli maszynie wirtualnej Javy odpowiedzialnej za uruchomienie kodu bajtowego. Z tego miejsca możemy wywołać kolejne metody, utworzyć obiekty, wczytać konfigurację albo rozpocząć pracę serwera.

Ważne jest rozróżnienie między klasą startową a całą aplikacją. Klasa zawierająca metodę main nie musi zawierać całej logiki programu. Dobrą praktyką jest potraktowanie jej jako cienkiej warstwy uruchomieniowej, która przekazuje sterowanie do właściwych komponentów.

Jak czytać public static void main String args

Początkujący często zapamiętują tę deklarację jako magiczną formułkę. Każdy jej element ma jednak konkretne zadanie i wpływa na sposób, w jaki środowisko uruchamia program.

Najwięcej nieporozumień dotyczy słowa static. Metoda statyczna należy do klasy, a nie do konkretnego obiektu. Dzięki temu JVM może uruchomić ją od razu, bez wcześniejszego wykonania konstruktora. To istotne, ponieważ właśnie od tej metody często zaczyna się tworzenie pozostałych obiektów aplikacji.

Nazwa parametru nie musi brzmieć args. Można użyć na przykład `arguments`, ale `args` jest przyjętą konwencją. Typ musi pozostać tablicą napisów, dlatego poprawne są także warianty `String... args` oraz `String args[]`.

Jak skompilować i uruchomić klasę z metodą main

Najprostszy przykład może znajdować się w pliku Hello.java:

public class Hello {
    public static void main(String[] args) {
        System.out.println("Program działa");
    }
}

W terminalu kompiluję go poleceniem:

javac Hello.java

Jeżeli kompilacja przebiegnie poprawnie, powstanie plik `Hello.class`. Program uruchamiam bez rozszerzenia pliku:

java Hello

To drobny szczegół, na którym wiele osób traci czas. Polecenie javac kompiluje kod źródłowy, a polecenie java uruchamia klasę lub aplikację. Przy uruchamianiu podaje się nazwę klasy, nie nazwę pliku z końcówką `.java` ani `.class`.

Uruchamianie pliku źródłowego

W nowszych wersjach JDK można uruchomić prosty plik źródłowy bez osobnego wywoływania kompilatora:

java Hello.java

Ten tryb dobrze sprawdza się przy małych ćwiczeniach, testach i jednoplikowych narzędziach. W większym projekcie nadal korzysta się zwykle z systemu budowania, takiego jak Maven lub Gradle, ponieważ trzeba wtedy zarządzać zależnościami, katalogami klas i konfiguracją środowisk.

Przekazywanie argumentów

Argumenty umieszczone po nazwie klasy trafiają do tablicy `args`. Przykład:

public class Greeting {
    public static void main(String[] args) {
        if (args.length == 0) {
            System.out.println("Brak imienia");
            return;
        }

        System.out.println("Cześć, " + args[0] + "!");
    }
}

java Greeting Anna

Warto pamiętać, że każdy argument jest tekstem. Jeżeli program oczekuje liczby, trzeba ją jawnie przekonwertować, na przykład za pomocą `Integer.parseInt(args[0])`. Bez sprawdzenia długości tablicy łatwo wywołać ArrayIndexOutOfBoundsException, gdy użytkownik nie poda wymaganej wartości.

Najczęstsze błędy przy uruchamianiu programu

Problemy z metodą startową zwykle nie wynikają ze skomplikowanej logiki. Najczęściej chodzi o literówkę w sygnaturze, nazwę klasy albo sposób wywołania programu. Poniższe przypadki pojawiają się szczególnie często.

Brak właściwej sygnatury

public void main(String[] args) {
    System.out.println("Błąd");
}

Ta metoda nie jest statyczna, więc klasyczny launcher nie potraktuje jej jak standardowego punktu wejścia. Podobnie problem powstanie, gdy metoda będzie miała typ zwracany `int`, inną nazwę albo parametr innego typu.

Nieprawidłowa nazwa klasy

Jeżeli plik zawiera publiczną klasę `Calculator`, powinien nazywać się Calculator.java. Po kompilacji uruchamiamy `java Calculator`, a nie `java calculator` ani `java Calculator.class`. Java rozróżnia wielkość liter, więc te nazwy nie są równoważne.

Metoda main w innej klasie

W projekcie może istnieć wiele klas z własną metodą main. Nie oznacza to, że JVM wybierze jedną z nich automatycznie. Uruchamiana jest ta klasa, którą wskażemy poleceniem lub skonfigurujemy jako klasę startową w IDE, pliku JAR czy systemie budowania.

Przeczytaj również: Python iterate over list - 5 metod, które musisz znać!

Błąd classpath

Komunikat `Could not find or load main class` zwykle oznacza, że launcher nie widzi skompilowanej klasy w bieżącym katalogu lub na ścieżce klas. Najpierw sprawdzam wtedy, czy plik `.class` rzeczywiście powstał, czy nazwa pakietu odpowiada strukturze katalogów i czy polecenie jest wykonywane z właściwego miejsca.

Klasyczna metoda a nowsze warianty w Javie

Od Java SE 25 specyfikacja dopuszcza szerszy wybór metod startowych. W prostych plikach źródłowych może wystarczyć na przykład:

void main() {
    System.out.println("Prostszy start");
}

Możliwy jest także wariant z argumentami:

void main(String[] args) {
    System.out.println("Liczba argumentów: " + args.length);
}

Takie rozwiązania mają ułatwić naukę i szybkie tworzenie małych programów. Launcher może utworzyć instancję klasy, a dopiero potem wywołać jej instancyjną metodę main. To wygodne w ćwiczeniach, ale w projektach komercyjnych nadal najczęściej wybieram tradycyjną formę public static void main(String[] args), bo jest czytelna, dobrze wspierana przez narzędzia i kompatybilna z dużą liczbą środowisk.

Uproszczona składnia nie jest zamiennikiem całej konfiguracji aplikacji. Frameworki, serwery aplikacyjne i narzędzia budowania mogą wymagać własnych klas startowych albo określonych ustawień. Przed użyciem nowszego wariantu trzeba też sprawdzić wersję JDK, z której korzysta projekt i środowisko produkcyjne.

Jak projektować dobrą klasę startową

Metoda main powinna robić niewiele, ale powinna jasno pokazywać, co uruchamia aplikację. Ja traktuję ją jak punkt konfiguracji i przekazania sterowania, a nie miejsce na całą logikę biznesową.

public class Application {
    public static void main(String[] args) {
        AppConfig config = AppConfig.from(args);
        ApplicationRunner runner = new ApplicationRunner(config);
        runner.start();
    }
}

Takie rozdzielenie ułatwia testowanie. Logikę znajdującą się w `ApplicationRunner` można testować bez uruchamiania całego procesu z poziomu terminala, a sama metoda startowa pozostaje krótka i przewidywalna.

• Sprawdzaj argumenty przed ich użyciem.
• Nie umieszczaj całej logiki biznesowej w metodzie main.
• Obsługuj błędy konfiguracji i zwracaj czytelny komunikat.
• Twórz zależności w jednym, łatwym do znalezienia miejscu.
• W aplikacjach wielomodułowych jasno określ klasę startową.

Warto też pamiętać, że zakończenie metody main nie zawsze kończy proces. Program może nadal działać, jeśli uruchomił wątki inne niż daemon, serwer HTTP albo połączenie oczekujące na dane. To częsta niespodzianka przy pierwszych aplikacjach wielowątkowych.

Od pierwszej linijki do działającej aplikacji

Metoda main jest prosta tylko z pozoru. Pokazuje kilka ważnych idei Javy naraz: pracę z klasami, metodami statycznymi, tablicami, argumentami programu i uruchamianiem przez JVM.

Na początek najlepiej opanować klasyczną sygnaturę, kompilację poleceniami `javac` i `java`, a także bezpieczne odczytywanie `args`. Dopiero później warto eksperymentować z uproszczonymi metodami dostępnymi w nowszych wersjach języka, zawsze sprawdzając zgodność używanego JDK z projektem.

Dobrze zaprojektowany punkt wejścia nie imponuje długością. Jego zadaniem jest uruchomić aplikację w przewidywalny sposób i przekazać pracę właściwym komponentom. To właśnie ta prostota sprawia, że poprawnie zbudowana metoda main pozostaje jednym z najbardziej praktycznych fundamentów programowania w Javie.