本文显示了如何开始使用Grid Ops for Java。实际上，这很简单。入门需要执行以下步骤：

• 在Java项目中包括Java的Grid Ops。
• 创建应用程序所需的Grid Ops组件。

这就是全部。以下各节将介绍这两个步骤。

在项目中包括网格操作

可以通过几种方式在Java项目中包括Grid Ops JAR文件：

Maven依赖

通过将Grid Ops Maven依赖项添加到项目的POM文件中，可以通过项目的Maven POM文件将Grid Ops包括在Java项目中。这是Grid Ops Maven依赖项：

<dependency>
  <groupId>com.nanosai</groupId>
  <artifactId>grid-ops</artifactId>
  <version>0.4.0</version>
</dependency>

切记将版本号替换为我们打算使用的Grid Ops的版本。

将Grid Ops JAR文件添加到Classpath

如果项目未使用Maven，则可以从Grid Ops GitHub存储库中的发行版下载Grid Ops发行版的JAR文件。

创建网格操作组件

在Maven项目中包含Grid Ops JAR文件后，就可以开始创建Grid Ops组件。可以通过类" com.nanosai.gridops.GridOps"创建最重要的Grid Ops组件。以下各节显示了一些如何通过GridOps类创建Grid Ops组件的示例。

创建一个IonWriter

这是一个创建" IonWriter"并将离子数据写入字节数组的示例：

IonWriter writer = GridOps.ionWriter();

byte[] destination = new byte[1024];
writer.setDestination(destination, 0, destination.length);

ionWriter.writeUtf8("A UTF-8 field");
ionWriter.writeInt64(123456);

我们可以在此处了解有关" IonWriter"的更多信息：IonWriter。

创建一个IonReader

一旦在字节数组中有了一些二进制ION数据，就可以使用" IonReader"读取它。这是创建" IonReader"的方法，该方法可以读取写入上述字节数组的ION数据：

IonReader ionReader = GridOps.ionReader();
ionReader.setSource(destination, 0, ionWriter.index);

while(ionReader.hasNext()){
    ionReader.next();
    ionReader.parse();

    int fieldType   = ionReader.fieldType;

    if(fieldType == IonFieldTypes.UTF_8){
        String value = ionReader.readUtf8String();
        System.out.println("Read UTF-8 string: " + value);
    } else if(fieldType == IonFieldTypes.INT_POS){
        long value = ionReader.readInt64();
        System.out.println("Read Int64: " + value);
    }
}

我们可以在此处阅读有关IonReader的更多信息：IonReader。

创建一个IonObjectWriter

Grid Ops包含一个" IonObjectWriter"，可以将Java对象序列化为ION。这是通过" GridOps"类创建和使用" IonObjectWriter"的方法：

IonObjectWriter ionObjectWriter = GridOps.ionObjectWriter(Pojo.class);

Pojo pojo = new Pojo();
pojo.setFirstName("John");
pojo.setLastName("Doe");

byte[] destination = new byte[1024];
int length = ionObjectWriter.writeObject(pojo, 1, destination, 0);

我们可以在此处阅读有关IonObjectWriter的更多信息：IonObjectWriter。

创建一个IonObjectReader

Grid Ops还包含一个" IonObjectReader"，可以将ION数据反序列化为Java对象。这是通过" GridOps"类创建和使用" IonObjectReader"的方法：

IonObjectReader ionObjectReader = GridOps.ionObjectReader(Pojo.class);

byte[] source = new byte[1024];

Pojo pojo = (Pojo) ionObjectReader.read(source, 0);

我们可以在此处阅读有关IonObjectReader的更多信息：IonObjectReader。