Emoji表情编解码库XXL-EMOJI

最新推荐文章于 2023-08-01 17:06:58 发布

转载最新推荐文章于 2023-08-01 17:06:58 发布 · 548 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://my.oschina.net/xuxueli/blog/1841691

文章标签：

#java #操作系统 #python

XXL-EMOJI是一款高效、灵活且易于扩展的Emoji表情编解码库，支持Emoji表情的多种编解码方式，并能够实时收录最新的Emoji表情。该库提供简洁直观的API，方便开发者快速实现Emoji表情处理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

2019独角兽企业重金招聘Python工程师标准>>>

《Emoji表情编解码库XXL-EMOJI》

一、简介

1.1 概述

XXL-EMOJI 是一个灵活可扩展的Emoji表情编解码库，可快速实现Emoji表情的编解码.

1.2 特性

1、简洁：API直观简洁，一分钟上手；
2、易扩展：模块化的结构，可轻松扩展；
3、别名自定义：支持为Emoji自定义别名；
4、实时性：实时收录最新发布的Emoji；

1.3 下载

文档地址

中文文档

源码仓库地址

源码仓库地址	Release Download
https://github.com/xuxueli/xxl-emoji	Download
https://gitee.com/xuxueli0323/xxl-emoji	Download

技术交流

社区交流

1.4 环境

JDK：1.7+

二、快速入门

第一步：引入Maven依赖

<dependency>
    <groupId>com.xuxueli</groupId>
    <artifactId>xxl-emoji</artifactId>
    <version>${最新稳定版}</version>
</dependency>

第二步：直接使用

引入Maven依赖，即可直接使用。

可参考以下示例代码：

String input = "一朵美丽的茉莉";
System.out.println("unicode：" + input);

// 1、alias：将Emoji表情转换为别名，然后还原；
String aliases = EmojiTool.encodeUnicode(input, EmojiEncode.ALIASES);
System.out.println("\naliases encode: " + aliases);
System.out.println("aliases decode: " + EmojiTool.decodeToUnicode(aliases));

// 2、html decimal：将Emoji表情Unicode数据转换为十进制数据，然后还原；
String decimal = EmojiTool.encodeUnicode(input, EmojiEncode.HTML_DECIMAL);
System.out.println("\ndecimal encode: " + decimal);
System.out.println("decimal decode: " + EmojiTool.decodeToUnicode(decimal));

// 3、html hex decimal：将Emoji表情Unicode数据转换为十六进制数据，然后还原；
String hexdecimal = EmojiTool.encodeUnicode(input, EmojiEncode.HTML_HEX_DECIMAL);
System.out.println("\nhexdecimal encode: " + hexdecimal);
System.out.println("hexdecimal decode: " + EmojiTool.decodeToUnicode(hexdecimal));

示例代码运行后，日志输入如下：

aliases encode: 一朵美丽的茉莉:rose:
aliases decode: 一朵美丽的茉莉

decimal encode: 一朵美丽的茉莉&#127801;
decimal decode: 一朵美丽的茉莉

hexdecimal encode: 一朵美丽的茉莉&#x1f339;
hexdecimal decode: 一朵美丽的茉莉

三、总体设计

3.1 功能定位

XXL-EMOJI 是一个灵活可扩展的Emoji表情编解码库，可快速实现Emoji表情的编解码.

3.2 Emoji编码类型

概念	说明
EmojiEncode.ALIASES	将Emoji表情转换为别名，格式为 ": alias :"；
EmojiEncode.HTML_DECIMAL	将Emoji表情Unicode数据转换为十进制数据；
EmojiEncode.HTML_HEX_DECIMAL	将Emoji表情Unicode数据转换为十六进制数据；

3.3、Emoji编解码API

API	说明
public static String encodeUnicode(String input, EmojiTransformer transformer, FitzpatrickAction fitzpatrickAction)	Emoji表情编码方法，支持自定义编码逻辑；
public static String encodeUnicode(String input, EmojiEncode emojiEncode, FitzpatrickAction fitzpatrickAction)	Emoji表情编码方法，支持自定义编码类型；
public static String encodeUnicode(String input, EmojiEncode emojiEncode)	Emoji表情编码方法，支持自定义编码类型；
public static String encodeUnicode(String input)	Emoji表情编码方法，编码类型默认为 "ALIASES" ；
public static String decodeToUnicode(String input)	Emoji表情解码方法，支持针对 "ALIASES、HTML_DECIMAL、HTML_HEX_DECIMAL" 等编码方式解码；
public static String removeEmojis(String input, final Collection<Emoji> emojisToRemove, final Collection<Emoji> emojisToKeep)	清除输入字符串中的Emoji数据；
public static List<String> findEmojis(String input)	查找输入字符转中的全部Emoji数据列表；