Skip to content
Daniel Anderson edited this page May 23, 2019 · 16 revisions

Introduction

The module is the fallback serializer when you do not (want to) use LibGDX. For GWT/browser support use the libgdx-json module.

It has no extra benefit over the LibGDX serializer, and lacks serializers for libgdx classes.

Setup

  1. Include artemis-odb-serializer-json module in your gradle/maven configuration.
  2. Add the required manager and configure a backend:
     final WorldSerializationManager manager = new WorldSerializationManager();
     World world = new World(new WorldConfiguration().setSystem(manager));
     manager.setSerializer(new JsonArtemisSerializer(world))

Usage examples

Load from file

     final InputStream is = AnyClass.class.getResourceAsStream("level.json");
     manager.load(is, SaveFileFormat.class);

Anything already in the world is unaffected by the load, so you can incrementally load parts of a world.

Save to string

      ByteArrayOutputStream bos = new ByteArrayOutputStream();
      manager.save(bos, new SaveFileFormat());
      String json = new String(bos.toByteArray());

entities is an IntBag with entity IDs defining the scope of the save operation.

Save to file

     final PrintWriter writer = new PrintWriter("level.json", "UTF-8");
     manager.save(writer, new SaveFileFormat(entities));
     writer.close();
Clone this wiki locally