Java MVC Web应用中复用顶部菜单JSP及控制器代码的最佳实践

嘿，作为Java Web新手碰到这种复用问题太正常了，我给你几个实际项目里常用的方案，既能复用通用逻辑，又不会干扰页面的专属功能：

1. 用Servlet过滤器（Filter）处理登录状态这类通用数据 #

过滤器就像所有请求的"前置关卡"，不管用户访问哪个页面，请求都会先经过过滤器。你可以在这里统一处理获取当前登录用户名这种通用逻辑，把数据放到请求域里，菜单JSP直接取用就行，完全不用每个页面的Servlet都写一遍。

举个简单的例子：

public class AuthFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest req = (HttpServletRequest) request;
        HttpSession session = req.getSession(false);
        // 从session里获取登录用户（登录成功时存在session里）
        User currentUser = null;
        if (session != null) {
            currentUser = (User) session.getAttribute("loggedInUser");
        }
        // 把用户对象放到请求域，菜单JSP可以直接用EL表达式获取
        req.setAttribute("currentUser", currentUser);
        // 放行请求，让它继续到页面专属的Servlet
        chain.doFilter(request, response);
    }

    // init和destroy方法按需实现
}

然后在web.xml里配置这个过滤器，让它拦截所有请求：

<filter>
    <filter-name>AuthFilter</filter-name>
    <filter-class>com.yourpackage.AuthFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>AuthFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

这样你的菜单JSP里就可以直接写：

<c:if test="${not empty currentUser}">
    <span>欢迎，${currentUser.username}</span>
    <a href="/logout">退出</a>
</c:if>
<c:if test="${empty currentUser}">
    <a href="/login">登录</a>
    <a href="/register">注册</a>
</c:if>

2. 把注册/登录逻辑封装到Service层 #

别把注册、登录的业务逻辑写死在Servlet里，抽成一个独立的UserService类，让所有需要用到这些逻辑的地方（比如登录Servlet、注册Servlet，甚至页面里需要验证的地方）都调用这个Service。这样逻辑只写一次，复用性拉满。

示例：

public class UserService {
    // 注册逻辑
    public boolean register(User user) throws SQLException {
        // 这里写校验、插入数据库的逻辑
        return true;
    }

    // 登录逻辑
    public User login(String username, String password) throws SQLException {
        // 这里写查询数据库、校验密码的逻辑
        return user;
    }
}

然后你的登录Servlet里就可以这样用：

public class LoginServlet extends HttpServlet {
    private UserService userService = new UserService();

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        String username = req.getParameter("username");
        String password = req.getParameter("password");
        try {
            User user = userService.login(username, password);
            if (user != null) {
                req.getSession().setAttribute("loggedInUser", user);
                resp.sendRedirect("/home");
            } else {
                req.setAttribute("error", "用户名或密码错误");
                req.getRequestDispatcher("/login.jsp").forward(req, resp);
            }
        } catch (SQLException e) {
            e.printStackTrace();
            req.setAttribute("error", "服务器错误");
            req.getRequestDispatcher("/login.jsp").forward(req, resp);
        }
    }
}

注册Servlet同理，直接调用userService.register()就行，完全不用重复写业务逻辑。

3. 给通用功能单独分配Servlet #

其实你不用纠结"一个URL只能映射一个Servlet"——菜单的注册、登录请求是独立的（比如用户点击登录按钮提交的是/login，点击注册是/register），这些请求可以单独交给一个AuthServlet处理，而页面的专属请求（比如/home、/profile）交给各自的Servlet，两者完全不冲突。

比如在web.xml里配置：

<servlet>
    <servlet-name>AuthServlet</servlet-name>
    <servlet-class>com.yourpackage.AuthServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>AuthServlet</servlet-name>
    <url-pattern>/login</url-pattern>
    <url-pattern>/register</url-pattern>
    <url-pattern>/logout</url-pattern>
</servlet-mapping>

然后在AuthServlet里根据请求路径区分处理逻辑：

public class AuthServlet extends HttpServlet {
    private UserService userService = new UserService();

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        String path = req.getServletPath();
        switch (path) {
            case "/login":
                handleLogin(req, resp);
                break;
            case "/register":
                handleRegister(req, resp);
                break;
            case "/logout":
                handleLogout(req, resp);
                break;
            default:
                resp.sendError(HttpServletResponse.SC_NOT_FOUND);
        }
    }

    // 分别实现handleLogin、handleRegister、handleLogout方法
}

这样菜单里的表单直接指向这些URL就行，和页面的专属Servlet完全隔离，不会互相干扰。

4. 进阶：自定义JSP标签封装菜单逻辑 #

如果菜单的HTML结构和逻辑都比较复杂，可以把整个菜单封装成自定义JSP标签。这样在各个页面里只需要写一行<my:topMenu>，标签的处理类会自动处理登录状态、渲染菜单HTML，完全不用在页面里写一堆判断。

这个稍微复杂点，但复用性最强，适合菜单逻辑多变的场景。

新手友好建议 #

作为新手，我推荐你先从过滤器+Service层封装入手，这两个方案最容易理解和实现，能快速解决你的问题。等你对Java Web的流程更熟悉了，再尝试自定义标签或者前端控制器模式。

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