Fastjson 的简单使用<转>

简介

Fastjson是一个Java语言编写的高性能功能完善的JSON库。

高性能

fastjson采用独创的算法，将parse的速度提升到极致，超过所有json库，包括曾经号称最快的jackson。并且还超越了google的二进制协议protocol buf。

支持标准

  • Fastjson完全支持http://json.org的标准，也是官方网站收录的参考实现之一。

功能强大

  • 支持各种JDK类型。包括基本类型、JavaBean、Collection、Map、Enum、泛型等。
  • 支持循环引用

无依赖

  • 不需要例外额外的jar，能够直接跑在JDK上。

支持范围广

  • 支持JDK 5、JDK 6、Android、阿里云手机等环境。

开源

测试充分

  • fastjson有超过1500个testcase，每次构建都会跑一遍，丰富的测试场景保证了功能稳定。

获得fastjson

下载

http://code.alibabatech.com/mvn/releases/com/alibaba/fastjson/

maven

如果你使用了Maven，maven repository配置如下：

<repository>

    <id>opensesame</id>

    <name>Alibaba OpenSource Repsoitory</name>

    <url>http://code.alibabatech.com/mvn/releases/</url>

    <snapshots>

        <enabled>false</enabled>

    </snapshots>

</repository>

pom.xml文件中加入依赖依赖：

<dependency>

    <groupId>com.alibaba</groupId>

    <artifactId>fastjson</artifactId>

    <version>1.1.23</version>

</dependency>

序列化

一个JSON库涉及的最基本功能就是序列化和反序列化。Fastjson支持java bean的直接序列化。你可以使用com.alibaba.fastjson.JSON这个类进行序列化和反序列化。

基本序列化

序列化就是把JavaBean对象转化成JSON格式的文本。

Object o = ...;

String text = JSON.toJSONString(o);

在这个例子中，调用JSON.toJSONString方法，把对象o转化为JSON格式的文本。

使用单引号

标准的JSON是使用双引号的，javascript支持使用单引号格式的json文本，fastjson也支持这个特性，打开SerializerFeature.UseSingleQuotes这个特性就可以了了，例如：

Object o = ...;

String text = JSON.toJSONString(o, SerializerFeature.UseSingleQuotes);

fastjson序列化时可以选择的SerializerFeature有十几个，你可以按照自己的需要去选择使用。

自定义需要转换的属性

使用

SimplePropertyPreFilter 自定义需要转换的属性
SimplePropertyPreFilter filter = new SimplePropertyPreFilter(IndexConfig.class,"name");String text = JSON.toJSONString(indexConfig ,filter);

或者

@JSONField(serialize = false)
private int SCENE; // 可被过滤

@JSONField(serialize = false)
private final int SCENE; // 不能过滤

日期格式化

fastjson直接支持日期类型数据的格式化，包括java.util.Date、java.sql.Date、java.sql.Timestamp、java.sql.Time。

缺省情况下，fastjson将Date类型序列化为long，这个使得序列化和反序列化的过程不会导致时区问题。如： 例如：

long millis = 1324138987429L;

Date date = new Date(millis);        

System.out.println(JSON.toJSONString(date));

输出的结果是

1324138987429

fastjson还提供了基于格式化输出的SerializerFeature，例如：

JSON.toJSONString(date, SerializerFeature.WriteDateUseDateFormat);

输出的结果为：

"2011-12-18 00:23:07"

你可以指定输出日期的格式，比如修改为输出毫秒：

JSON.toJSONStringWithDateFormat(date, "yyyy-MM-dd HH:mm:ss.SSS");

输出的结果为:

"2011-12-18 00:23:07.429"

使用WriteClassName特性

fastjson支持序列化时写入类型信息，从而使得反序列化时不至于类型信息丢失。例如：

Color color = Color.RED;

String text = JSON.toJSONString(color, SerializerFeature.WriteClassName);

System.out.println(text);

输出结果：

{"@type":"java.awt.Color","r":255,"g":0,"b":0,"alpha":255}

由于序列化带了类型信息，使得反序列化时能够自动进行类型识别，例如：

String text = ...; // {"@type":"java.awt.Color","r":255,"g":0,"b":0,"alpha":255}

Color color = (Color) JSON.parse(text);

浏览器和设备兼容

fastjson缺省的序列化内容，是对序列化结果紧凑做了优化配置，使得序列化之后长度更小，但是这种优化配置是对一些浏览器和设备不兼容的。比如说在iphone上兼容emoji（绘文字）。

JSON.toJSONString(o, SerializerFeature.BrowserCompatible);

循环引用

很多场景中，我们需要序列化的对象中存在循环引用，在许多的json库中，这会导致stackoverflow。在功能强大的fastjson中，你不需要担心这个问题。例如：

A a = new A();

B b = new B(a);

a.setB(b);

 

String text = JSON.toJSONString(a); // {"b":{"a":{"$ref":".."}}}

A a1 = JSON.parseObject(text, A.class);

Assert.assertTrue(a1 == a1.getB().getA());

引用是通过"$ref"来表示的

引用 描述
"$ref":".." 上一级
"$ref":"@" 当前对象，也就是自引用
"$ref":"$" 根对象
"$ref":"$.children.0" 基于路径的引用，相当于 root.getChildren().get(0)

使用@JSONField Annotation

在某些场景，你可能需要定制序列化输出，比如说，希望序列化采用之后采用"ID"，而不是"id"，你可以使用@JSONField这个Annotation。

public class User {

    @JSONField(name="ID")

    public int getId() { ... }

}

 

User user = ...;

JSON.toJSONString(user); // {"ID":234}

从json-lib中升级

如果你已经使用了json-lib，并且痛恨他蜗牛般的速度和罗嗦的API，建议你升级为fastjson，fastjson可以完全兼容json-lib的序列化格式。

import com.alibaba.fastjson.JSON;

import com.alibaba.fastjson.serializer.JSONLibDataFormatSerializer;

import com.alibaba.fastjson.serializer.JSONSerializerMap;

import com.alibaba.fastjson.serializer.SerializerFeature;

  

private static final SerializeConfig   config;

static {

    config = new SerializeConfig();

    config.put(java.util.Date.class, new JSONLibDataFormatSerializer()); // 使用和json-lib兼容的日期输出格式

    config.put(java.sql.Date.class, new JSONLibDataFormatSerializer()); // 使用和json-lib兼容的日期输出格式

}

  

private static final SerializerFeature[] features = { SerializerFeature.WriteMapNullValue, // 输出空置字段

        SerializerFeature.WriteNullListAsEmpty, // list字段如果为null，输出为[]，而不是null

        SerializerFeature.WriteNullNumberAsZero, // 数值字段如果为null，输出为0，而不是null

        SerializerFeature.WriteNullBooleanAsFalse, // Boolean字段如果为null，输出为false，而不是null

        SerializerFeature.WriteNullStringAsEmpty // 字符类型字段如果为null，输出为""，而不是null

                                                  };

  

// 序列化为和JSON-LIB兼容的字符串

public static String toCompatibleJSONString(Object object) {

    return JSON.toJSONString(object, config, features);

}

通过上面代码中的toCompatibleJSONString方法，你就可以实现完全兼容json-lib了。

反序列化

反序列化就是把JSON格式的文本转化为Java Bean对象。

指定Class信息反序列化

通过指定类型信息，可以很方便的将"JSON文本"反序列化为"Java Bean"对象，例如：

String text = ...; // {"r":255,"g":0,"b":0,"alpha":255}

Color color = JSON.parseObject(text, Color.class);

类型集合的反序列化

这个接口类似于parseObject

String text = ...; // [{ ... }, { ... }]

List<User> users = JSON.parseArray(text, User.class);

泛型的反序列化

如果你需要返回一个带泛型的对象，例如List<User>、Map<String, User>，你可以使用TypeReference来传入类型信息。

String text = ...; // {"name":{"name":"ljw",age:18}}

Map<String, User> userMap = JSON.parseObject(text, new TypeReference<Map<String, User>>() {});

组合类型集合的反序列化

比如在网络协议中，经常会存在这样的组合:

[{/*header*/}, {/*body*/}]

fastjson对这种结构的反序列化有专门支持。

String text = ...; // [{/* header */}, {/* body */}]

Type[] types = new Type[] {Header.class, Body.class};

List<Object> list = JSON.parseArray(text, types);

Header header = (Header) list.get(0);

Body body = (Body) list.get(1);

使用@JSONCreator来指定构造函数来创建对象

如果你的JavaBean没有缺省构造函数，可以使用@JSONCreator来指定构造函数

public static class Entity {

    private final int    id;

    private final String name;

 

    @JSONCreator

    public Entity(@JSONField(name = "id") int id, @JSONField(name = "name") String name){

        this.id = id;

        this.name = name;

    }

 

    public int getId() { return id; }

    public String getName() { return name; }

}

把JSON文本反序列化为一个原型接口

public static interface Bean {

    int getId();

 

    void setId(int value);

 

    String getName();

 

    void setName(String value);

}

 

String text = "{\"id\":123, \"name\":\"chris\"}";

Bean bean = JSON.parseObject(text, Bean.class);

 

// 按接口调用

Assert.assertEquals(123, bean.getId());

Assert.assertEquals("chris", bean.getName());

bean.setId(234);

Assert.assertEquals(234, bean.getId());

Labels parameters

Labels:

None

转自 http://www.cnblogs.com/taoweiji/p/3174720.html

时间： 2024-08-06 07:58:21

Fastjson 的简单使用<转>的相关文章

fastjson的简单学习

package com.hanchao.testFastJson; import java.util.HashMap; import java.util.List; import java.util.Map; import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONObject; /***********************  * 阿里的F

高性能JSON框架之FastJson的简单使用

1.前言 1.1.FastJson的介绍: JSON协议使用方便,越来越流行,JSON的处理器有很多,这里我介绍一下FastJson,FastJson是阿里的开源框架,被不少企业使用,是一个极其优秀的Json框架,Github地址: FastJson 1.2.FastJson的特点: 1.FastJson数度快,无论序列化和反序列化,都是当之无愧的fast 2.功能强大(支持普通JDK类包括任意Java Bean Class.Collection.Map.Date或enum) 3.零依赖(没有依

Android原生json和fastjson的简单使用

android原生操作json数据 主要是两个类 JSONObject 操作对象     JONSArray操作json数组 对象转json 1 //创建学生对象 2 Student student=new Student(); 3 student.setAge(23); 4 student.setClazz("六年级"); 5 student.setName("王二麻子"); 6 //创建JSONObject 7 JSONObject jsonObject=new

FastJson的简单使用

pom.xml文件中加入依赖依赖: <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.15</version> </dependency> 首先建立两个实体类,Student.Java 和 Teacher.java Student.java 和Teacher.java 的代码如下:

fastjson 的简单说明及使用

fastjson 是一个性能很好的 Java 语言实现的 JSON 解析器和生成器,来自阿里巴巴的工程师开发. 各个版本jar包下载地址:https://repo1.maven.org/maven2/com/alibaba/fastjson/ 源码下载地址:https://github.com/alibaba/fastjson 主要特点: 快速FAST (比其它任何基于Java的解析器和生成器更快,包括jackson) 强大(支持普通JDK类包括任意Java Bean Class.Collect

fastjson 的简单使用

public static void main(String[] args) { /*普通对象与json相互转换*/ User u = new User("miquan", "000"); //{"@type":"testjava.User","password":"000","userName":"miquan"} String jsonUser

fastjson是什么东东？

fastjson是一个Java语言编写的高性能功能完善的JSON库.它采用一种"假定有序快速匹配"的算法,把JSON Parse的性能提升到极致,是目前Java语言中最快的JSON库.Fastjson接口简单易用,已经被广泛使用在缓存序列化.协议交互.Web输出.Android客户端等多种应用场景. pom.xml depencency: <!-- https://mvnrepository.com/artifact/com.alibaba/fastjson --><

Json 工具介绍 fastjson gson jackson

1. fastjson fastjson是一个Java语言编写的高性能功能完善的JSON库.它采用一种“假定有序快速匹配”的算法,把JSON Parse的性能提升到极致, 是目前Java语言中最快的JSON库. fastjson接口简单易用,已经被广泛使用在缓存序列化.协议交互.Web输出.Android客户端等多种应 用场景. fastjson是java库,可以用来转换成java对象的JSON表示.它也可以用来转换为等效的java对象的JSON字符串.Fastjson可以任意的java 对象包

GitHub开源库排名一百的简单介绍，值得收藏！

GitHub Android Libraries Top 100 简介 本项目主要对目前 GitHub 上排名前 100 的 Android 开源库进行简单的介绍, 至于排名完全是根据 GitHub 搜索 Java 语言选择 (Best Match) 得到的结果, 然后过滤了跟 Android 不相关的项目, 所以排名并不具备任何官方效力, 仅供参考学习, 方便初学者快速了解当前一些流行的 Android 开源库. iOS 版本的在此: https://github.com/Aufree/tri