Java GUI绘制其他类对象失败：空白灰色窗口问题求助

我用Java制作贺卡程序，需要绘制自定义类的对象，程序能正常编译，但运行后弹出的窗口只显示空白灰色界面，对Java GUI工作原理不太了解，求解决建议。

Sun类原代码 #

import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.geom.Line2D;
import java.awt.Color;

public class Sun extends ShapeComponent
{
   private double x;
   private double y;
   private double width;
   private double height;

   public Sun(double anX, double aY, double w, double h)
   {
      x = anX;
      y = aY;
      width = w;
      height = h;
   }

   public void draw(Graphics2D g2)
   {
    g2.setColor (Color.orange);
    g2.fillArc (100,20,80,80,0,360);
    g2.drawLine (95,55,75,55);
    g2.drawLine (140,105,140,125);
    g2.drawLine (140,15,140,0);
    g2.drawLine (185,60,205,60);
    g2.drawLine (105,35,85,25);
    g2.drawLine (120,20,105,5);
    g2.drawLine (100,80,80,90);
    g2.drawLine (115,100,100,120);
    g2.drawLine (175,5,160,20);
    g2.drawLine (205,25,175,35);
    g2.drawLine (205,90,175,80);
    g2.drawLine (175,120,160,100);
   }

   public void translate(int dx, int dy)
   {
      x += dx;
      y += dy;
   }
}

ShapeComponent类原代码 #

import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.geom.Ellipse2D;
import java.awt.Rectangle;
import java.awt.geom.Line2D;
import java.awt.Polygon;
import java.awt.Color;
import java.awt.BasicStroke;
import javax.swing.JComponent;
import javax.swing.JFrame;
import javax.swing.JPanel;

public class ShapeComponent extends JComponent
{
    public ShapeComponent(){
        JFrame jf = new JFrame();
        jf.setTitle("Greeting Card");
        jf.setSize(480, 600);
        jf.setVisible(true);
        jf.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE);

    }
    public void paintComponent(Graphics2D g2){
        super.paintComponent(g2);
        Sun sun = new Sun(5,65,55,66);
        sun.draw(g2);
    }
   public static void main(String[] args)
   {
        new ShapeComponent();
    }
}

问题原因及修复方案 #

核心问题 #

1. paintComponent方法签名错误：Swing规定JComponent的paintComponent方法参数必须是Graphics类型，你定义的参数是Graphics2D，导致Swing绘制机制不会调用这个方法，自然看不到任何绘制内容。
2. 未将自定义组件添加到窗口：你创建了JFrame，但没有把ShapeComponent实例添加到窗口的内容面板中，窗口默认是空的，所以显示灰色背景。
3. Sun类继承关系不合理：Sun只是一个图形绘制逻辑类，不需要继承JComponent（即ShapeComponent），继承会带来不必要的组件生命周期管理，应该改成普通类专注于绘制。
4. Sun的绘制未使用成员变量：当前draw方法用的是固定坐标，没有用到构造时传入的x,y,width,height，无法动态调整太阳的位置和大小。

修正后的代码 #

修正后的Sun类

import java.awt.Graphics2D;
import java.awt.Color;

// 改为普通类，不再继承JComponent
public class Sun
{
   private double x;
   private double y;
   private double width;
   private double height;

   public Sun(double anX, double aY, double w, double h)
   {
      x = anX;
      y = aY;
      width = w;
      height = h;
   }

   public void draw(Graphics2D g2)
   {
      g2.setColor(Color.orange);
      // 使用成员变量设置太阳的位置和大小
      int intX = (int) x;
      int intY = (int) y;
      int intWidth = (int) width;
      int intHeight = (int) height;
      g2.fillArc(intX, intY, intWidth, intHeight, 0, 360);

      // 基于太阳中心计算射线位置，实现动态适配
      int centerX = intX + intWidth / 2;
      int centerY = intY + intHeight / 2;
      // 水平垂直射线
      g2.drawLine(centerX - 25, centerY, centerX - 45, centerY);
      g2.drawLine(centerX, centerY + 25, centerX, centerY + 45);
      g2.drawLine(centerX, centerY - 25, centerX, centerY - 45);
      g2.drawLine(centerX + 25, centerY, centerX + 45, centerY);
      // 斜向射线
      g2.drawLine(centerX - 20, centerY - 10, centerX - 40, centerY - 20);
      g2.drawLine(centerX - 10, centerY - 20, centerX - 20, centerY - 40);
      g2.drawLine(centerX - 20, centerY + 10, centerX - 40, centerY + 20);
      g2.drawLine(centerX - 10, centerY + 20, centerX - 20, centerY + 40);
      g2.drawLine(centerX + 20, centerY - 10, centerX + 40, centerY - 20);
      g2.drawLine(centerX + 10, centerY - 20, centerX + 20, centerY - 40);
      g2.drawLine(centerX + 20, centerY + 10, centerX + 40, centerY + 20);
      g2.drawLine(centerX + 10, centerY + 20, centerX + 20, centerY + 40);
   }

   public void translate(int dx, int dy)
   {
      x += dx;
      y += dy;
   }
}

修正后的ShapeComponent类

import java.awt.Graphics;
import java.awt.Graphics2D;
import javax.swing.JComponent;
import javax.swing.JFrame;

public class ShapeComponent extends JComponent
{
    public ShapeComponent(){
        JFrame jf = new JFrame();
        jf.setTitle("Greeting Card");
        jf.setSize(480, 600);
        // 将当前组件添加到窗口内容面板
        jf.add(this);
        jf.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        // 最后调用setVisible，确保所有组件已加载
        jf.setVisible(true);
    }

    // 正确的方法签名，参数为Graphics
    @Override
    public void paintComponent(Graphics g){
        super.paintComponent(g);
        // 转换为Graphics2D以使用更高级的绘制API
        Graphics2D g2 = (Graphics2D) g;
        Sun sun = new Sun(100, 20, 80, 80);
        sun.draw(g2);
    }

    public static void main(String[] args)
    {
        new ShapeComponent();
    }
}

额外建议 #

• 尽量遵循Swing的线程规则：Swing组件的创建和更新应该在事件调度线程（EDT）中进行，你可以用SwingUtilities.invokeLater(() -> new ShapeComponent());代替直接在main方法中创建实例。
• 不要在组件构造中创建JFrame：更好的做法是将窗口创建和组件创建分离，降低耦合度。

内容的提问来源于stack exchange，提问作者P0RTSIDE