libjson文档翻译

 

    导言：我已经有好几个项目使用了libjson库，感觉这是个挺不错的JSON库，顺便翻译了下他文档的主要部分，希望和大家一起了解学习。由于内容较多，无法全部发在博客文章上，大家可以通过我的github下载完整文档。https://github.com/yaocoder/MyDocument/blob/master/libjson%E6%96%87%E6%A1%A3%E7%BF%BB%E8%AF%91.pdf

关于libjson

项目主页：http://sourceforge.net/projects/libjson/

        libjson 是一个适用于C和C++语言高效的并且可灵活定制的json库。它拥有针对C++的接口，使C++开发人员也能够在他们的程序中使用json，同时由于多数libjson的方法（函数）是内敛的，更进一步提升了库的效率。它也为其他类型的语言提供了C风格的接口和共享库。文档将会讲解如何去构建、优化libjson来适应你的需求，并且对C、C++接口进行详细的说明。

       libjson当前最新版本为7.*，如果你想把程序中的libjson 5或是更早的版本升级到此版本，请注意相应的接口变化，但是也不用担心，所有的函数功能没有变化，它们只是更完善，更标准化。如果你想从libjson 6升级，仅有的变化是 json_validate这个接口。 libjson的接口在升级中（完善和修正bug）并没有发生变化，你可以查看每一次版本升级的changelog。

       libjson不仅高效，功能也很丰富，包括parsers, writers, builders, formatters, validators…  ，它还可以根据你的需求进行灵活的定制。也许你会感到奇怪：libjson看上去如此轻量但是却拥有一个200多页的文档和很多文件，但事实上你可以根据你的需求只使用需要的部分。JSONOptions.h文件中介绍了这些配置选项。在后面的部分将给你详细介绍这些配置选项的适用场景， 这些选项允许你根据自己的程序去做相应的优化。libjson设计的很精巧，它只使用少量内存，并且很高效。所以尽量不要对库本身做一些不紧要的微调。

       libjson相比其他库更具备可定制性，包括mutex管理，垃圾收集（garbage collection），内存管理（memory control），unicode支持，可以灵活的定制而非只提供给你默认的行为。它拥有纯净的C接口，所有C风格的接口都有 json_前缀。它也拥有非常直观的C++接口，比如迭代器（iterators），与STL的风格相似。C和C++两种库共享了部分代码，但也有各自特定的代码。

       libjson是安全的，它的默认行为就具有抵御拒绝服务***（DoS）的能力，并且它还拥有其他可配置的安全选项。

支持的平台：

libjson官方支持并且进行过测试验证的是以下平台：

• gcc (OSX) ——完全支持

• llvm (OSX) - 完全支持

• gcc (LInux) - 完全支持

• MinGW (Windows) - 支持, 部分经过测试

• Visual C++ (Windows) - 支持, 部分经过测试

以下主要是讲解如何通过配置JSONOptions.h构建你需要的libjson...