JPanel은 Java Swing에서 컴포넌트들을 그룹으로 묶거나, 그림을 그리는 데 사용되는 가장 기본적인 컨테이너이다.

💡 JFrame이 액자라면,JPanel은 그 안에 들어가는 **도화지나게시판`**이라고 생각하면 된다.

JPanel의 주요 특징

• 컨테이너 역할: JPanel은 그 자체로는 눈에 잘 보이지 않지만, JButton, JLabel, JTextField 등 다른 컴포넌트들을 담아서 그룹으로 괄리할 수 있다.

• 기본 레이아웃 - FlowLayout: JFrame의 기본 레이아웃이 BorderLayout인 것과 달리, JPanel의 기본 레이아웃은 FlowLayout이다.

• 중첩 구조: JPanel 안에 또 다른 JPanel을 넣는 식으로 복잡한 화면 레이아웃을 구성할 수 있다.

  예를 들어, 큰 패널(BorderLayout)의 중앙(Center) 구역에 작은 패널(FlowLayout)을 넣어 버튼을 배치하는 식이다.

• 커스텀 페인팅: pointComponent 메서드를 오버라이드(재정의)해서 원하는 도형, 이미지, 캐릭터 등 자신만의 그래픽을 직접 그리는 도화지로 사용할 수 있다.

자주 사용하는 JPanel 메서드

컴포넌트 관리

• add(Component comp): 패널 위에 버튼, 레이블 등 다른 컴포넌트를 추가한다.

  // panel에 "클릭"이라는 텍스트가 적힌 버튼을 추가
  panel.add(new JButton("클릭"));

• remove(Conponent comp): 패널에 추가된 특정 컴포넌트를 제거한다.

  // panel에 추가된 myButton을 제거
  panel.remove(myButton);

레이아웃 설정

• setLayout(LayoutManager mgr): 패널 내부의 컴포넌트 배치 방식을 설정한다.

  // panel에 레이아웃을 BorderLayout 방식으로 설정
  panel.setLayout(new BorderLayout());

  💡 이제 이 패널을 동(EAST), 서(WEST), 남(SOUTH), 북(NORTH), 중앙(CENTER)으로 구역이 나뉘게 된다.

스타일 및 외형

• setBackground(Color c): 패널의 배경색을 지정한다.

  // panel에 배경색을 검정색(BLACK)으로 설정
  panel.setBackground(Color.BLACK);

• setBorder(Border border): 패널의 테두리를 설정한다. (디버깅 시 영역 확인에 유용하다)

  // panel에 테두리를 빨간색(RED)으로 설정
  panel.setBorder(BorderFactory.createLineBorder(Color.RED));

  💡 BorderFactory.createLineBorder(Color.RED)는 빨간색 실선 테두리를 만든 코드이다.

커스텀 드로잉

오버라이드용

• paintComponent(Graphics g): 이 메서드를 재정의해서 패널에 그림을 그린다. (직접 호출하지 않음)

  // 기존 JPanel이 가지고 있던 paintComponent라는 메서드를 재정의(Override)함
  @Override
  protected void paintComponent(Graphics g) {
     // 기존의 JPanel이 하던 기본적인 그리기 작업(배경색 칠하기 등)을 먼저 실행하라는 의미
    super.paintComponent(g);
    // g라는 붓을 사용해서, 패널의 가로 10, 세로 20 위치에 "Hello"라는 글자를 그림
    g.drawString("Hello", 10, 20);
  }

호출용

• repaint(): 패널을 다시 그리도록 시스템에 요청한다. (이 메서드를 호출하면 잠시 후 paintComponent가 실행됨)

  // 시스템이 적절한 타이밍에 재정의한 paintComponent 메서드를 실행 시켜서 화면을 업데이트함
  panel.repaint();

JFrame은 Java Swing GUI 라이브러리에서 화면에 표시되는 창(window)을 만드는데 사용되는 가장 기본적인 구성요소이다.

💡 우리가 보는 애플리케이션의 창문 또는 액자와 같은 역할을 한다.

JFrmae의 주요 특징

최상위 컨테이너 (Top-Level Container)

JFrame은 다른 컨포넌트에 포함되지 않고, 독립적으로 존재할 수 있는 최상위 GUI 컨테이너이다.

💡 모든 Swing 애플리세이션은 최소 하나 이상의 최상위 컨테이너를 가진다.

기본 창틀 제공

JFrame은 창을 만드는 데 필요한 기본적인 요소들을 이미 갖추고 있다.

• 제목 표시줄(Title Bar): 창의 제목을 표시하는 부분
• 창 조절 버튼: 최소화, 최대화, 닫기(X) 버튼
• 콘텐츠 영역 (Content Pane): 실제 버튼, 패널 등이 배치되는 내용물 영역

상속을 통한 확장

보통 JFrmae 클래스를 직접 사용하기보다, JFrmae을 상속(extends)하는 새로운 클래스를 만들어 프로그램을 개발한다. 이렇게 하면 원하는 기능과 모양을 가진 자신만의 커스텀 창을 쉽게 만들 수 있다.

JFrame 핵심 설정 메소드

창 기본 설정

• setTitle(String title): 창의 제목 표시줄에 나타날 텍스트를 설정한다.

  // 창의 제목을 Hello Swing! 으로 설정
  setTitle("Hello Swing!");

• setSize(int width, int height): 창의 가로(width)와 세로(height) 크기를 픽셀 단위로 설정한다.

  // 창의 크기를 가로: 800, 세로: 600 으로 설정
  setSize(800, 600);

• setLocationRelativeTo(Component c): 창이 나타날 위치를 설정합니다.

  // 창이 나타날 위치를 화면 중앙으로 설정
  setLocationRelativeTo(null);

  💡 null 대신 다른 GUI 컴포넌트 객체를 전달하면, 새로 뜨는 창이 해당 컴포넌트의 중앙에 맞춰서 나타난다.

• setVisible(boolean b): 창을 화면에 보이거나(true) 숨길(false) 때 사용한다.

  // 창을 화면에 보이게 설정
  setVisible(true);

창 닫기 동작

• setDefaultCloseOperation(int operation): 창의 닫기 버튼(X)을 눌렀을 때의 동작을 정의한다.

  // 창의 닫기 버튼(X)을 눌렀을 때 프로그램을 완전히 종료하게 설정
  setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

  동작

  • JFrame.EXIT_ON_CLOSE: 프로그램을 완전히 종료
  • JFrame.DISPOSE_ON_CLOSE: 현재 창만 닫고 프로그램은 계속 실행
  • JFrame.HIDE_ON_CLOSE: 창을 보이지 않게 숨김
  • JFrame.DO_NOTHING_ON_CLOSE: 닫기 버튼을 눌러도 아무 동작도 하지 않음

컴포넌트 관리

• add(Component comp): 버튼(JButton), 패널(JPanel) 등 다른 GUI 컴포넌트를 프레임에 추가한다.

  // 창에 WindowPanel을 추가
  add(new WindowPanel());

• setLayout(LayoutManager manager): 컴포넌트들이 프레임안에서 배치되는 방식을 결정한다. (기본값: BorderLayout)

  // 창 안에 컴포넌트들이 배치되는 방식을 FlowLayout으로 설정
  setLayout(new FlowLayout());

  💡 레이아웃 매니저에는 BorderLayout, FlowLayout, GridLayout, CardLayout, BoxLayout 등이 있다.

기타 유용한 설정

• setResizable(boolean resizable): 사용자가 마우스로 창 크기를 조절 할 수 있는지 여부를 설정한다. (최대화 불가)

  // 창 크기를 조절 할 수 없게 설정
  setResizable(false);

• pack(): 프레임 안에 추가된 컴포넌트들의 크기에 맞춰 프레임 크기를 자동으로 조절한다.

• getContentPane(): 컴포넌트들이 실제 추가되는 영역(Content Pane)을 가져온다.

  // 창의 배경색을 BLACK(검은색)으로 설정
  getContentPane().setBackground(Color.BLACK);

시작하기에 앞서...

Java 언어로 게임을 만들고 싶어진 저는 Java로 게임을 만드는 영상들을 찾아보았습니다. 찾아본 결과 먼저 Swing이란 GUI 라이브러리를 사용한다는 것을 알고 Java Swing에 관해 공부하려고 합니다.

개발 환경 설정

개발 환경 : macOS / IntelliJ IDEA / JDK 17 버전 사용

1. 프로젝트 생성

IntelliJ에서 JavaSwing 라는 이름으로 새 Java 프로젝트를 생성합니다.

2. 패키지 생성

swing00 라는 이름으로 새 패키지를 생성한다.

3. 클래스 생성

main 메서드를 포함하는 Launcher 클래스와 MainWindow 클래스 두 개를 생성한다.

클래스 구현

1. Launcher 클래스 구현

package swing00;

import javax.swing.*;

public class Launcher {

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> new MainWindow().setVisible(true));

    }
}

Launcher 클래스에서 SwingUtilities.invokeLater() 메서드를 사용하여 Swing 관련 코드가 EDT(Event Dispatch Thread)에서 실행되도록 한다.

• SwingUtilities.invokeLater() 메서드를 사용하는 이유는 무엇인가? Swing 스레드는 안전하지 않으므로, 모든 Swing 관련 코드가 EDT라는 동일한 스레드에서 실행되도록 보장하기 위해 사용한다.

• EDT(Event Dispatch Thread): Swing GUI 애플리케이션의 모든 화면 관련 작업을 전담하는 유일한 스레드이다.

2. MainWindow 클래스 구현

package swing00;

import javax.swing.*;

public class MainWindow extends JFrame {

    public MainWindow() {
        // 창 제목 설정
        setTitle("Hello Swing!");

        // 기본 닫기 동작 설정
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // 창 크기 설정
        setSize(800, 500);

        // 창 화면 중앙 배치
        setLocationRelativeTo(null);
    }

}

MainWindow 클래스는 JFrame을 상속 받았기 때문에 클래스 자체가 프레임의 한 종류라고 볼 수 있다.

생성자 내에서 프레임을 설정해준다.

프로그램 실행 및 결과 확인

이렇게 모니터 화면의 정중앙에 800 x 500 크기의 "Hello Swing!"이라는 제목의 창이 화면에 나타난 것을 확인할 수 있다.