如何用Java EE 8实现Spring @Controller与@RequestMapping等效功能

嘿，我刚好在GlassFish 5+Java EE 8环境下做过对接QuickBooks OAuth2的需求，完全能替代Spring那套@Controller+@RequestMapping的逻辑，给你捋清楚具体实现：

Java EE里没有直接和Spring @Controller完全对等的注解，但可以用Servlet或者JAX-RS资源类实现同样的功能，分场景选：

方案一：用Servlet实现（适配页面跳转的回调场景） #

Spring的@Controller经常用来处理带视图跳转的请求，Java EE里Servlet是最直接的替代，完美匹配QuickBooks OAuth2回调的逻辑：

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

// 对应Spring的@RequestMapping("/oauth2redirect")
@WebServlet("/oauth2redirect")
public class CallbackServlet extends HttpServlet {

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 对应Spring的@RequestParam("code") String authCode
        String authCode = request.getParameter("code");
        // 对应Spring的@RequestParam("state") String state
        String state = request.getParameter("state");

        // --------------------------
        // 这里写你的核心OAuth2逻辑：
        // 1. 验证state（必须和发起授权时的随机state一致，防CSRF）
        // 2. 用authCode调用Intuit的token端点换access_token/refresh_token
        // 3. 把token持久化到数据库或存在session里
        // --------------------------

        // 跳转到授权成功页面（对应Spring里return "success"的视图跳转）
        request.getRequestDispatcher("/WEB-INF/views/oauth-success.jsp").forward(request, response);
        // 如果需要重定向到其他页面，用：response.sendRedirect("/dashboard");
    }
}

方案二：用JAX-RS资源类（适配REST风格接口） #

如果你的回调不需要跳转页面，只是返回REST响应，用Java EE自带的JAX-RS（GlassFish默认用Jersey实现）更合适：

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.Response;
import java.net.URI;

// 对应Spring的@RequestMapping("/oauth2redirect")
@Path("/oauth2redirect")
public class CallbackResource {

    // 对应Spring的@RequestMapping(method = RequestMethod.GET)
    @GET
    public Response handleCallback(
            // 对应Spring的@RequestParam("code")
            @QueryParam("code") String authCode,
            // 对应Spring的@RequestParam("state")
            @QueryParam("state") String state) {

        // 同样处理OAuth2逻辑：验证state、换token等

        // 返回JSON响应（对应Spring的ResponseEntity）
        return Response.ok("{\"status\":\"authorized\",\"message\":\"Token acquired\"}").build();
        // 如果需要重定向，用：return Response.seeOther(URI.create("/dashboard")).build();
    }
}

对接Intuit的时候，这几个点要特别注意：

• State参数必须验证：发起授权请求时生成随机state并存到用户session，回调时取出对比，绝对不能跳过这一步，不然会有CSRF风险。
• Token交换的实现：用Java自带的HttpClient（Java 11+）或者Apache HttpClient调用Intuit的token端点，示例代码：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

// 示例：用authCode换token
public String exchangeCodeForToken(String authCode) throws Exception {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer"))
            .header("Content-Type", "application/x-www-form-urlencoded")
            .POST(HttpRequest.BodyPublishers.ofString(
                    "grant_type=authorization_code" +
                    "&code=" + authCode +
                    "&redirect_uri=你的回调地址（要和Intuit后台注册的完全一致）" +
                    "&client_id=你的QuickBooks Client ID" +
                    "&client_secret=你的QuickBooks Client Secret"
            ))
            .build();

    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    return response.body(); // 解析这个JSON拿到access_token、refresh_token等
}

• Token持久化：把refresh token用JPA存到数据库，过期后自动调用Intuit的刷新接口换token，避免用户重复授权。
• GlassFish配置：确保应用的上下文根和回调地址匹配，比如你的应用部署在/quickbooks-integration下，回调地址要设为http://localhost:8080/quickbooks-integration/oauth2redirect，并且在Intuit开发者后台注册这个地址。

方便你快速对照迁移：

• @Controller → @WebServlet（页面跳转场景）或@Path标注的JAX-RS资源类（REST场景）
• @RequestMapping("/endpoint") → @WebServlet("/endpoint") 或 @Path("/endpoint")
• @RequestParam → request.getParameter()（Servlet）或@QueryParam（JAX-RS）
• 返回视图名跳转 → request.getRequestDispatcher().forward() 或 response.sendRedirect()（Servlet）
• 返回REST响应 → Response（JAX-RS）对应Spring的ResponseEntity

如果还有具体的问题，比如解析Intuit的token响应、处理refresh token自动刷新，随时问就行～

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