融合门户系统与手册的整合实践

张伟（开发者）：李娜，我最近在开发一个融合门户系统，感觉有些地方不太顺手，特别是和手册系统的集成部分。

李娜（架构师）：哦，你是说那个用于统一访问多个服务的门户？那手册系统是做什么的？

张伟：手册系统是一个知识库平台，用来管理各种技术文档、操作指南和用户手册。我们希望将它集成到门户中，让用户可以直接从门户访问手册内容，而不需要跳转到其他页面。

李娜：这听起来很有必要。不过，要怎么实现呢？你有没有考虑过API接口或者微服务的方式？

张伟：我确实考虑过API方式。目前我用的是RESTful API来调用手册系统的内容，然后在门户前端展示出来。但有时候会遇到跨域问题，还有权限控制的问题。

李娜：跨域问题可以用CORS来解决，权限控制的话，可以引入OAuth2或者JWT。另外，你有没有考虑过使用代理服务？比如Nginx或Spring Cloud Gateway，这样可以更方便地处理请求。

张伟：这个思路不错。我现在用的是Spring Boot做后端，前端是React。前端直接调用手册系统的API，但有时候会因为权限问题无法获取数据。

李娜：那你可以先在后端做一个中间层，负责处理认证和权限验证，再转发请求到手册系统。这样前端就不用关心认证细节了。

张伟：明白了。那我应该怎么做呢？有没有具体的代码示例？

李娜：当然有。我们可以用Spring Security来实现权限控制，然后在网关层处理请求转发。下面是一段简单的代码示例，你可以参考一下。

张伟：太好了！请继续。

李娜：首先，在Spring Boot中配置安全框架，启用基本的权限控制。这里是一个配置类的例子：

        @Configuration
        @EnableWebSecurity
        public class SecurityConfig {

            @Bean
            public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
                http
                    .authorizeRequests()
                        .anyRequest().authenticated()
                    .and()
                    .httpBasic();
                return http.build();
            }
        }
    

张伟：这段代码是用于启用HTTP Basic认证的。那如果我要集成OAuth2呢？

李娜：如果你使用OAuth2，可以换用`@EnableAuthorizationServer`和`@EnableResourceServer`注解，同时配置客户端信息和令牌存储方式。

张伟：明白了。那在网关层，如何实现请求的转发呢？

李娜：你可以使用Spring Cloud Gateway，这是一个轻量级的API网关，支持路由、过滤器等功能。下面是一个简单的路由配置示例：

        spring:
          cloud:
            gateway:
              routes:
                - id: manual-service
                  uri: http://manual-system:8080
                  predicates:
                    - Path=/api/manual/**
                  filters:
                    - StripPrefix=1
    

张伟：这个配置的作用是把所有以/api/manual/开头的请求转发到手册系统。那如何在网关中添加权限验证呢？

李娜：可以在过滤器中添加权限检查逻辑。例如，使用JWT解析用户的token，然后判断是否有访问权限。

张伟：那我可以写一个自定义的过滤器吗？

李娜：当然可以。下面是一个简单的JWT过滤器示例：

        public class JwtFilter implements Filter {

            private final JwtUtil jwtUtil;

            public JwtFilter(JwtUtil jwtUtil) {
                this.jwtUtil = jwtUtil;
            }

            @Override
            public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
                    throws IOException, ServletException {
                String token = ((HttpServletRequest) request).getHeader("Authorization");
                if (token != null && token.startsWith("Bearer ")) {
                    String jwtToken = token.substring(7);
                    if (jwtUtil.validateToken(jwtToken)) {
                        // 验证成功，放行
                        chain.doFilter(request, response);
                        return;
                    }
                }
                // 验证失败，返回401
                ((HttpServletResponse) response).sendError(HttpServletResponse.SC_UNAUTHORIZED);
            }
        }
    

张伟：这段代码是用于验证JWT Token的。那在Spring Cloud Gateway中如何注册这个过滤器呢？

李娜：你可以通过配置文件或编程方式添加过滤器。例如，在配置类中添加如下代码：

        @Bean
        public FilterRegistrationBean jwtFilter() {
            FilterRegistrationBean registration = new FilterRegistrationBean<>();
            registration.setFilter(new JwtFilter(new JwtUtil()));
            registration.addUrlPatterns("/*");
            return registration;
        }
    

张伟：这样就可以在所有请求中进行JWT验证了。那前端如何获取Token呢？

李娜：前端可以通过登录接口获取Token，然后保存在本地存储中。之后在每次请求头中带上Authorization: Bearer {token}。

张伟：明白了。那现在，我需要在门户系统中展示手册内容，该怎么实现呢？

李娜：你可以通过调用手册系统的API，获取内容并渲染到前端页面上。例如，使用Axios或Fetch API发送GET请求。

张伟：那我举个例子，比如获取某个手册的详细内容。

李娜：好的，下面是一个简单的JavaScript代码示例，用于获取手册内容：

        async function getManualContent(id) {
            const response = await fetch(`http://manual-system/api/manual/${id}`, {
                headers: {
                    'Authorization': 'Bearer ' + localStorage.getItem('token')
                }
            });
            if (response.ok) {
                const data = await response.json();
                console.log(data);
                // 渲染到页面上
            } else {
                alert('无法获取手册内容');
            }
        }
    

张伟：这段代码可以获取指定ID的手册内容。那如果我要展示多篇手册呢？

李娜：你可以通过分页或搜索功能来获取列表数据。手册系统通常会提供查询接口，比如`GET /api/manuals?search=xxx&page=1`。

张伟：明白了。那整个流程大致是：门户系统通过网关调用手册系统API，经过权限验证后返回数据，前端渲染展示。

李娜：没错。这种整合方式可以提高用户体验，也便于统一管理多个系统。

张伟：那你觉得还需要注意哪些方面呢？比如性能、安全性、可维护性？

李娜：性能方面，可以考虑缓存常用的手册内容，减少频繁调用API。安全性方面，确保所有通信都使用HTTPS，避免敏感信息泄露。可维护性方面，建议将API调用封装成独立的服务，便于后期扩展。

张伟：非常感谢你的指导！这些代码和思路对我帮助很大。

李娜：不客气，有问题随时找我。祝你项目顺利！