讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

SoundView
SoundView

字幕擦除翻译、配音口型同步

updream

一键生成高质量推广成片

Java 字符编码怎么用编码注解传输标记字段

胖静大大_6734

胖静大大_6734

发布时间:2026-11-19 11:00:02

|

750人浏览过

|

来源于php中文网

原创

在java中通过编码注解传输标记字段,核心做法是使用spring框架的`@requestparam`、`@pathvariable`或`@requestbody`等注解,并配合`characterencodingfilter`确保请求体或查询参数的字符集(如utf-8)被正确解析。具体而言,需在web配置中注册过滤器以强制设置请求和响应的编码,同时在controller方法参数上直接标注对应注解,spring会自动将http请求中的字节流按指定编码解码为java字符串,从而避免乱码。

Java 字符编码怎么用编码注解传输标记字段

如何配置全局字符编码过滤器

要确保所有进入Spring应用的请求都使用UTF-8编码,最直接的方式是配置一个`CharacterEncodingFilter`。这个过滤器会拦截所有HTTP请求,强制调用`request.setCharacterEncoding("UTF-8")`和`response.setCharacterEncoding("UTF-8")`。这样,当Controller接收到数据时,底层字节流已经被正确转换为Unicode字符,后续的注解解析就不会出现乱码问题。

Java 字符编码怎么用编码注解传输标记字段

import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.filter.CharacterEncodingFilter;

@Configuration
public class WebConfig {
    @Bean
    public FilterRegistrationBean<CharacterEncodingFilter> encodingFilter() {
        FilterRegistrationBean<CharacterEncodingFilter> bean = new FilterRegistrationBean<>();
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        filter.setForceEncoding(true); // 同时强制响应编码
        bean.setFilter(filter);
        bean.addUrlPatterns("/*");
        return bean;
    }
}

上述代码定义了一个`FilterRegistrationBean`,它将`CharacterEncodingFilter`注册到Servlet容器中。`setForceEncoding(true)`是关键,它确保不仅请求,响应输出也使用UTF-8。对于基于Spring Boot的应用,如果未自定义此过滤器,Spring Boot默认已启用UTF-8编码,但显式配置能确保在非Boot环境或特殊场景下的一致性。

立即学习“Java免费学习笔记(深入)”;

Java基础版
Java基础版

编写健壮 Java 代码的基础能力,覆盖空指针防护、相等性判断与基础异常处理。

下载

如何使用注解接收不同来源的标记字段

在控制器层,根据标记字段在HTTP请求中的位置,选择对应的注解进行绑定。如果是URL查询参数,使用`@RequestParam`;如果是路径变量,使用`@PathVariable`;如果是JSON请求体,使用`@RequestBody`。这些注解本身不处理编码,它们依赖底层的HttpMessageConverter或参数解析器,而后者依赖于前面配置的过滤器所设置的字符集。

Java 字符编码怎么用编码注解传输标记字段

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/api")
public class MarkedFieldController {

    // 处理查询参数: /api/test?tag=hello&value=world
    @GetMapping("/test")
    public String handleQuery(@RequestParam String tag, @RequestParam String value) {
        // tag和value已按UTF-8解码
        return "Tag: " + tag + ", Value: " + value;
    }

    // 处理路径变量: /api/path/special-tag
    @GetMapping("/path/{tag}")
    public String handlePath(@PathVariable String tag) {
        return "Path Tag: " + tag;
    }

    // 处理JSON请求体
    @PostMapping("/json")
    public String handleJson(@RequestBody MarkedData data) {
        return "Received: " + data.getTag();
    }
}

class MarkedData {
    private String tag;
    private String value;
    // getters and setters
}

在`handleQuery`方法中,`@RequestParam`直接从请求的参数Map中获取值,这些值在过滤器处理后已是正确的String。在`handleJson`方法中,`@RequestBody`使用`MappingJackson2HttpMessageConverter`(假设引入了Jackson)将JSON字符串反序列化为`MarkedData`对象。JSON解析器通常默认使用UTF-8,但如果底层请求流编码错误,这里也会出错。因此,全局过滤器是基础,注解是接口。

当标记字段包含特殊字符或Emoji时会发生什么

如果标记字段中包含非ASCII字符,如中文、Emoji或特殊符号,只要全局过滤器正确配置了UTF-8,且前端发送的请求头`Content-Type`或URL编码符合规范,后端就能完整接收。例如,发送`tag=%F0%9F%98%80`(UTF-8编码的?表情),后端`@RequestParam`接收到的将是正确的Unicode字符。若未配置过滤器或使用错误的编码(如ISO-8859-1),则会出现乱码或截断。

// 测试用例:验证特殊字符传输
@Test
public void testSpecialCharInTag() throws Exception {
    mockMvc.perform(get("/api/test")
            .param("tag", "\uD83D\uDE00") // Emoji UTF-16 surrogate pair in Java string
            .param("value", "test"))
        .andExpect(status().isOk())
        .andExpect(content().string(containsString("Tag: \uD83D\uDE00")));
}
// 注意:在HTTP传输中,Emoji会被编码为多字节UTF-8序列,如%E3%...%...

在实际开发中,需确保数据库连接URL也指定了`characterEncoding=UTF-8`,否则即使应用层正确接收,存入数据库时也可能因驱动默认编码不同而损坏。此外,前端JavaScript在发送请求时,`encodeURIComponent`函数会自动将特殊字符转为UTF-8百分号编码,与后端过滤器配合即可实现无损传输。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

12937

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

10002

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

8492

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1344

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1068

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

1616

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

3389

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

20611

2023.08.03

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn