| flatbuffers를 이용해 메모리 읽기 쓰기를 구현 해본다. FlatBuffers(플랫버퍼)는 구글에서 개발된 크로스 플렛폼 직렬화(Serialization) 라이브러리이다. flatbuffers의 장점에 대해서 알아보자.
다운로드최신버전 : https://github.com/google/flatbuffers윈도우 버전의 소스와 바이너리 파일 https://github.com/google/flatbuffers/releases FlatBuffer Schema 작성fbs 파일을 작성해서 flatc.exe로 빌드한다.flatc.exe 파일은 바이너리 파일에 있다. player.fbs table Player
{ name : string; level : int; } root_type Player; 빌드 하면 personList_generated.h 파일이 만들어진다. flatc.exe -c player.fbs
파일 복사- 생성된 player_generated.h 파일을 복사한다.- flatbuffers-2.0.0/include/flatbuffers 폴더를 프로젝트에 복사한다. 메모리에서 쓰고 읽기빌더 객체 선언을 하고 Finish 함수로 메모리에 쓰기를 할수 있다.GetBufferPointer로 버퍼를 가져온다. 버퍼에서 값을 얻어 올려면 다음과 같이 한다. Get+ "테이블 이름" = GetPlayer(data) player_generated.h 파일에 GetPlayer가 만들어져 있다. #include <iostream>
#include "flatbuffers/flatbuffers.h" #include "player_generated.h" void Sample1() { //flatbuffer 빌더 객체 선언 flatbuffers::FlatBufferBuilder builder; //직렬화 serialize auto name = builder.CreateString("최강검"); auto level = 50; builder.Finish(CreatePlayer(builder, name, level)); //버퍼 저장 auto data = builder.GetBufferPointer(); //역직렬화 deserialize auto player = GetPlayer(data); std::cout << "이름 : " << player->name()->c_str() << std::endl; std::cout << "레벨 : " << player->level() << std::endl; } 파일 쓰기파일로 저장하기 위해서는 flatbuffers-2.0.0\src 폴더에서 util.cpp 파일을 복사해서 프로젝트에 추가한다.그리고 util.h 파일을 포함 시킨다. SaveFile 함수로 파일 쓰기를 한다. flatbuffers::SaveFile("player.bin", reinterpret_cast<char*>(data), builder.GetSize(), true); #include <iostream>
#include "flatbuffers/flatbuffers.h" #include "player_generated.h" #include "flatbuffers/util.h" //flatbuffers::SaveFile 사용을 위해 void Sample2() { //flatbuffer 빌더 객체 선언 flatbuffers::FlatBufferBuilder builder; //직렬화 auto name = builder.CreateString("최강검"); auto level = 50; builder.Finish(CreatePlayer(builder, name, level)); //버퍼 저장 auto data = builder.GetBufferPointer(); //파일 저장 flatbuffers::SaveFile("player.bin", reinterpret_cast<char*>(data), builder.GetSize(), true); } 파일 읽기flatbuffers::LoadFile 함수로 파일을 읽는다.PushBytes에 로딩한 파일의 버퍼를 추가한다. GetPlayer에서 GetCurrentBufferPointer의 버퍼를 이용해서 값을 읽어 온다. 예외처리를 추가하고 싶다면 verify 부분의 주석을 해제한다. bool VerifyLayer_FbBuffer(flatbuffers::Verifier &verifier)
{ return verifier.VerifyBuffer<Player>(nullptr); } void Sample3() { std::string binaryfile; bool ok = flatbuffers::LoadFile("player.bin", false, &binaryfile); if (!ok) { return; } flatbuffers::FlatBufferBuilder builder; builder.PushBytes(reinterpret_cast<unsigned char*>(const_cast<char*>(binaryfile.c_str())), binaryfile.size()); std::cout << "deserialize size:" << builder.GetSize() << std::endl; // verify /* flatbuffers::Verifier layer_verify(builder.GetCurrentBufferPointer(), builder.GetSize()); bool verify_flag = VerifyLayer_FbBuffer(layer_verify); if (!verify_flag) { return; } */ // read auto player = GetPlayer(builder.GetCurrentBufferPointer()); std::cout << "이름 : " << player->name()->c_str() << std::endl; std::cout << "레벨 : " << player->level() << std::endl; } 배열 사용법배열 예제를 만들기 위해 스키마 personList.fbs 파일을 작성한다.personList.fbs 파일 table Person
{ name : string; age : int; } table PersonTable { person_list : [Person]; } root_type PersonTable; 다음과 같이 빌드한다. flatc.exe -c personList.fbs root_type이 PersonTable이므로 CreatePersonTable로 루트 오프셋을 만든다. builder.Finish에 루트 오프셋을 넘겨서 메모리에 쓴다. 역직렬화는 배열 인덱스를 사용하는 방법과 반복자를 사용하는 방법이 있다. 루트 이름이 PersonTable이기 때문에 GetPersonTable에 GetCurrentBufferPointer의 포인터를 넘겨준다. void Sample4()
{ flatbuffers::FlatBufferBuilder builder; //직렬화 auto p1 = CreatePerson(builder, builder.CreateString("홍길동"), 20); auto p2 = CreatePerson(builder, builder.CreateString("김철수"), 10); auto p3 = CreatePerson(builder, builder.CreateString("이영희"), 10); std::vector<flatbuffers::Offset<Person>> personList; personList.push_back(p1); personList.push_back(p2); personList.push_back(p3); auto persons = builder.CreateVector(personList); auto root = CreatePersonTable(builder, persons); builder.Finish(root); //버퍼 저장 char buffer[1024] = { 0 }; memcpy(buffer, builder.GetBufferPointer(), builder.GetSize()); //역직렬화 flatbuffers::FlatBufferBuilder builderOut; builderOut.PushBytes((const uint8_t*)buffer, 1024); auto table = GetPersonTable(builderOut.GetCurrentBufferPointer()); #if 0 for (int i = 0; i < (int)table->person_list()->Length(); ++i) { std::string name = table->person_list()->Get(i)->name()->str(); int age = table->person_list()->Get(i)->age(); std::cout << "Person " << i << " : " << name << " : " << age << std::endl; } #else auto players = table->person_list(); for (auto iter = players->begin(); iter != players->end(); ++iter) { std::string name = iter->name()->str(); int age = iter->age(); std::cout << "Person " << " : " << name << " : " << age << std::endl; } #endif } 실행 결과---------------------------- Sample1 : memory read write ----------------------------이름 : 최강검 레벨 : 50 ---------------------------- Sample2 : save file ---------------------------- save player.bin. ---------------------------- Sample3 : load file ---------------------------- deserialize size:36 이름 : 최강검 레벨 : 50 ---------------------------- Sample4 : flatbuffer array ---------------------------- Person : 홍길동 : 20 Person : 김철수 : 10 Person : 이영희 : 10 다운로드 : flatbuffer_test.cpp 참고) flatbuffers 메모리 읽기 쓰기 https://copynull.tistory.com/408 flatbuffers에서 배열 사용 https://m.blog.naver.com/njh0602/220975255274 pengshengli 님 싸이트 flatbuffers 파일 쓰기 읽기 https://www.jianshu.com/p/db357e2eabc3 guotianqing 님 싸이트로 flatbuffers에 대해 자세한 설명이 있음 flatbuffer json을 C 개체로 변환 |