package com.example.maildemo.service;

import jakarta.mail.internet.MimeMessage;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;

/**
 * 邮件发送服务
 * 提供纯文本邮件和 HTML 邮件两种发送方式
 */
@Service
public class EmailService {

    // Spring Boot 自动注入的邮件发送器
    private final JavaMailSender mailSender;

    // 发件人地址（必须和 application.yml 中的 username 一致）
    private static final String FROM_EMAIL = "你的QQ号@qq.com";

    // 构造器注入（推荐方式，比 @Autowired 字段注入更利于测试）
    public EmailService(JavaMailSender mailSender) {
        this.mailSender = mailSender;
    }

    /**
     * 发送纯文本邮件
     * 适用场景：简单通知、测试
     *
     * @param to      收件人邮箱
     * @param subject 邮件主题
     * @param content 邮件正文（纯文本）
     */
    public void sendTextEmail(String to, String subject, String content) {
        // SimpleMailMessage 用于发送纯文本邮件
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(FROM_EMAIL);
        message.setTo(to);
        message.setSubject(subject);
        message.setText(content);

        mailSender.send(message);
    }

    /**
     * 发送 HTML 格式邮件
     * 适用场景：验证码、营销邮件、带样式的通知
     *
     * @param to      收件人邮箱
     * @param subject 邮件主题
     * @param html    邮件正文（HTML 格式）
     */
    public void sendHtmlEmail(String to, String subject, String html) {
        try {
            // MimeMessage 支持 HTML 和附件
            MimeMessage message = mailSender.createMimeMessage();
            // MimeMessageHelper 简化了 MimeMessage 的操作
            // 第二个参数 true 表示支持多部分内容（HTML + 附件）
            MimeMessageHelper helper = new MimeMessageHelper(message, true);

            helper.setFrom(FROM_EMAIL);
            helper.setTo(to);
            helper.setSubject(subject);
            // 第二个参数 true 表示内容是 HTML 格式
            helper.setText(html, true);

            mailSender.send(message);
        } catch (Exception e) {
            // 生产环境应使用日志框架记录，这里简化处理
            throw new RuntimeException("邮件发送失败: " + e.getMessage(), e);
        }
    }

    /**
     * 发送验证码邮件（HTML 格式）
     * 使用 Java 21 Text Blocks 构建邮件模板
     *
     * @param to       收件人邮箱
     * @param username 用户名
     * @param code     验证码
     */
    public void sendVerificationCode(String to, String username, String code) {
        // Java 21 Text Blocks：用三引号包裹多行字符串
        // 比传统的字符串拼接更清晰、更易维护
        String html = """
            <div style="font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px;">
                <h2 style="color: #333;">欢迎注册</h2>
                <p>亲爱的 <strong>%s</strong>，</p>
                <p>您的验证码是：</p>
                <div style="background: #f5f5f5; padding: 15px; text-align: center; font-size: 24px; letter-spacing: 5px; font-weight: bold; border-radius: 5px; margin: 20px 0;">
                    %s
                </div>
                <p style="color: #888; font-size: 12px;">验证码 10 分钟内有效，请勿泄露给他人。</p>
                <hr style="border: none; border-top: 1px solid #eee; margin: 20px 0;">
                <p style="color: #888; font-size: 12px;">此邮件由系统自动发送，请勿回复。</p>
            </div>
            """.formatted(username, code);

        sendHtmlEmail(to, "【验证码】您的注册验证码", html);
    }
}

package com.example.maildemo.controller;

/**
 * 邮件发送请求参数
 * 使用 Java 17+ Record 语法，自动生成 getter、equals、hashCode、toString
 */
public record EmailRequest(
    String to,       // 收件人邮箱
    String username, // 用户名（用于验证码邮件）
    String code      // 验证码
) {}

package com.example.maildemo.controller;

import com.example.maildemo.service.EmailService;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Map;

@RestController
@RequestMapping("/api/email")
public class EmailController {

    private final EmailService emailService;

    public EmailController(EmailService emailService) {
        this.emailService = emailService;
    }

    /**
     * 发送验证码邮件
     * POST /api/email/send-code
     */
    @PostMapping("/send-code")
    public ResponseEntity<Map<String, String>> sendVerificationCode(@RequestBody EmailRequest request) {
        emailService.sendVerificationCode(request.to(), request.username(), request.code());
        return ResponseEntity.ok(Map.of("message", "验证码已发送"));
    }
}

@Autowired
private JavaMailSender mailSender;

public void sendNotice(String to, String content) {
    SimpleMailMessage msg = new SimpleMailMessage();
    msg.setFrom("你的邮箱@qq.com");
    msg.setTo(to);
    msg.setSubject("系统通知");
    msg.setText(content);
    mailSender.send(msg);
}

public void sendCode(String to, String code) {
    String html = """
        <div style="text-align:center; padding:20px;">
            <h2>您的验证码</h2>
            <p style="font-size:24px; font-weight:bold;">%s</p>
        </div>
        """.formatted(code);

    MimeMessage msg = mailSender.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(msg, true);
    helper.setFrom("你的邮箱@qq.com");
    helper.setTo(to);
    helper.setSubject("验证码");
    helper.setText(html, true);
    mailSender.send(msg);
}