SpringBoot路径映射配置的实现步骤

 更新时间:2025年08月21日 09:27:42   作者:future romance  
本文介绍了如何在SpringBoot项目中配置路径映射,使得除static目录外的资源可被访问,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

SpringBoot路径映射

SpringBoot项目中,只有位于static中的资源可以直接被访问

(访问方式:http://主机:端口/资源名)

其他资源无法被直接访问

这时就需要进行路径映射配置

可以创建一个配置类,对其进行配置

// An highlighted block
@Configuration
public class WebMVCConfig extends WebMvcConfigurationSupport {

    // 路径映射配置
    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {

        // 将网页地址栏中的 /order/**  映射到  工程类路径下的 /order/ 中,以访问resources/order中的资源
        registry.addResourceHandler("/order/**").addResourceLocations("classpath:/order/");
        // 磁盘目录
        String path = "E:\\xxx\\xxx\\";   
        // 将网页地址栏中的 /image/**  映射到  磁盘的某个目录下,以访问磁盘资源 
        registry.addResourceHandler("/image/**").addResourceLocations("file:" + path);
     
    }

}

如此,便实现了SpringBoot的资源路径映射配置。

补:springboot 配置虚拟路径映射 

我发现在很多springboot教程里几乎没有提到过URL映射,主要是很简单,看看代码基本上就明白了,我这里简单说一说,也说一说与Django的一点区别。

@RequestMapping注册URL映射

在Django中URL的映射是靠project里urls.py中的urlpatterns配置的,先说说Django怎么处理请求:

  • 一旦生成url页面请求,请求传递到urls.py;
  • Django去urlpatterns中匹配链接(Django会在匹配到的第一个就停下来);
  • 一旦匹配成功,就会去执行,path后面的方法,Django便会给出相应的view页面(该页面可以为一个Python的函数,或者基于view(Django内置的)的类),也就是用户看到的页面;
  • 若匹配失败,则出现错误的页面。

类似地,在springboot中也要有一个URL映射关系,这样用户在访问URL链接时才能执行不同的逻辑, 这里提到的逻辑正是MCV模式里说的控制层(C层),因此URL的映射跟控制层有很大关联,在springboot里是在控制层直接通过注解的方式来完成的。通常的做法是:

  • 创建一个名为controller的包
  • 然后在这个包下创建各种Controller
  • 通过注解 @RequestMapping 来注册,实现URL的映射(也即访问URL时所执行的函数)。

可以先看一个简单的例子:

@RestController
@EnableAutoConfiguration
public class HelloController {
    @Value("${version}")
    private String version;

    @Autowired
    private StudentProperties student_default;

    @Autowired
    private StudentTestBean student_test;

    @RequestMapping("/student")
    private String student(String name, Integer age) {
        if (name == null) {
            name = student_default.getName();
        }
        if (age == null) {
            age = student_default.getAge();
        }
        return String.format("Online: %s\nname: %s, age: %d\nname(Test): %s, age(Test): %d", version, name, age, student_test.getName(), student_test.getAge());
    }
}

通过@RequestMapping将**/student**映射到了HelloController的student函数,在运行项目时会看到springboot的输出日志:

2018-10-30 14:57:08.116  INFO 13692 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/student]}" onto private java.lang.String com.example.useconfigurationproperties.HelloController.student(java.lang.String,java.lang.Integer)

在访问http://localhost:8080/student时,会调用HelloController的student函数。

@RequestMapping中的method没有默认值,如果不配置method,则以任何请求形式(RequestMethod.GET、RequestMethod.POST、RequestMethod.PUT、RequestMethod.DELETE)都可以访问得到。

这种设计方法稍微有点混乱,没有Django这种配置一个通用的表来的方便,Django的url映射关系很容易对比查看。而springboot的这种注解的方式就分散的比较零散,有时需要各个Controller点开查看。当然,也有一个稍微折中的办法,就是可以在Controller类上映射某个子目录URL,由该Controller类统一管理该子URL下的其他子URL,也就是分模块管理的思想,里面再做映射就是绑定到具体函数了,这样的效果看上去就不会那么乱了。

例如对于以下的代码,CourseController类统一映射到了http://localhost:8080/course,内部函数映射如下:

  • 访问http://localhost:8080/course时调用的是course函数
  • 访问http://localhost:8080/course/queryCourseList时调用的是queryCourse函数
  • 访问http://localhost:8080/course/add时调用的是addCourse函数
  • 访问http://localhost:8080/course/update时调用的是updateCourse函数
  • 访问http://localhost:8080/course/delete时调用的是deleteCourse函数
@Controller
@RequestMapping("/course")
public class CourseController extends BaseController {
    @Autowired
    private CourseService courseService;
    private Logger logger = LoggerFactory.getLogger(this.getClass());

    @RequestMapping("")
    public String course(Model model) {
        model.addAttribute("ctx", getContextPath() + "/");
        return "courses";
    }

    /**
     * 查询教程列表
     *
     * @param page
     * @return
     */
    @RequestMapping(value = "/queryCourseList", method = RequestMethod.POST)
    @ResponseBody
    public AjaxObject queryCourse(Page<?> page) {
        PageHelper.startPage(page.getPage(), page.getRows());

        Map<String,Object> pageParams = new HashMap<String,Object>();
        pageParams.put("page", page.getPage());
        pageParams.put("rows", page.getRows());

        List<Course> courseList = courseService.queryList(pageParams);
        PageInfo<Course> pageInfo = new PageInfo<Course>(courseList);
        return AjaxObject.ok().put("page", pageInfo);
    }

    /**
     * 新添教程
     *
     * @param course
     */
    @RequestMapping(value = "/add", method = RequestMethod.POST)
    @ResponseBody
    public AjaxObject addCourse(@RequestBody Course course) {
        courseService.save(course);
        return AjaxObject.ok();
    }

    /**
     * 修改教程
     *
     * @param course
     */
    @RequestMapping(value = "/update", method = RequestMethod.POST)
    @ResponseBody
    public AjaxObject updateCourse(@RequestBody Course course) {
        (course.getAuthor() + "");
        courseService.update(course);
        return AjaxObject.ok();
    }

    /**
     * 删除教程
     *
     * @param ids
     */
    @RequestMapping(value = "/delete", method = RequestMethod.POST)
    @ResponseBody
    public AjaxObject deleteCourse(@RequestBody Long[] ids) {
        courseService.deleteByIds(ids);
        return AjaxObject.ok();
    }
}

Spring4.3以后为简化@RequestMapping(method = RequestMethod.XXX)的写法,故而将其做了一层包装,也就是现在的GetMapping、PostMapping、PutMapping、DeleteMapping、PatchMapping。

@Controller和@RestController的区别

@RestController注解相当于@ResponseBody + @Controller合在一起的作用。

如果只是使用@RestController注解Controller,则Controller中的方法无法返回jsp页面,或者html,配置的视图解析器 InternalResourceViewResolver不起作用,返回的内容就是Return 里的内容。

如果需要返回到指定页面,则需要用 @Controller配合视图解析器InternalResourceViewResolver才行。如果需要返回JSON,XML或自定义mediaType内容到页面,则需要在对应的方法上加上@ResponseBody注解。

使用@Controller 注解,在对应的方法上,视图解析器可以解析return 的jsp,html页面,并且跳转到相应页面。若返回json等内容到页面,则需要加@ResponseBody注解

到此这篇关于SpringBoot路径映射配置的实现步骤的文章就介绍到这了,更多相关SpringBoot路径映射 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • JAVA实现单例模式的四种方法和一些特点

    JAVA实现单例模式的四种方法和一些特点

    JAVA实现单例模式的四种方法和一些特点,需要的朋友可以参考一下
    2013-03-03
  • springboot打war包的全过程记录

    springboot打war包的全过程记录

    其实一般使用springboot使用打成jar包比较省事的,但也有很多童鞋是习惯使用war包的,下面这篇文章主要给大家介绍了关于springboot打war包的相关资料,需要的朋友可以参考下
    2022-06-06
  • Java基础之教你如何正确运用依赖注入

    Java基础之教你如何正确运用依赖注入

    最近发现很多使用Spring框架的Java代码存在依赖注入方式的误用,甚至是滥用.因此整理了这篇文章,欢迎大家一起探讨,需要的朋友可以参考下
    2021-05-05
  • SpringBoot实现Excel读取的实例教程

    SpringBoot实现Excel读取的实例教程

    这篇文章主要给大家介绍了关于SpringBoot实现Excel读取的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-12-12
  • Java中Date日期时间类具体使用

    Java中Date日期时间类具体使用

    本文主要介绍了Java中Date日期时间类具体使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-04-04
  • clickhouse 批量插入数据及ClickHouse常用命令详解

    clickhouse 批量插入数据及ClickHouse常用命令详解

    这篇文章主要介绍了clickhouse 批量插入数据及ClickHouse常用命令,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-03-03
  • java序列化与反序列化的使用方法汇总

    java序列化与反序列化的使用方法汇总

    序列化是一种对象持久化的手段,普遍应用在网络传输、RMI等场景中,这篇文章主要给大家总结介绍了关于java序列化与反序列化的使用方法,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2021-07-07
  • 使用mybatis-plus-generator进行代码自动生成的方法

    使用mybatis-plus-generator进行代码自动生成的方法

    这篇文章主要介绍了使用mybatis-plus-generator进行代码自动生成的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-06-06
  • Spring cloud alibaba之Ribbon负载均衡实现方案

    Spring cloud alibaba之Ribbon负载均衡实现方案

    Spring cloud Ribbon是基于Netflix Ribbon实现的一套客户端的负载均衡工具,Ribbon客户端提供一系列完善的配置,如超时、重试等,Ribbon也可以实现自己的负载均衡算法,感兴趣的朋友跟随小编一起看看吧
    2021-07-07
  • Nacos配置中心的配置文件的匹配规则及说明

    Nacos配置中心的配置文件的匹配规则及说明

    这篇文章主要介绍了Nacos配置中心的配置文件的匹配规则及说明,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-11-11

最新评论