chromium/mojo/public/java/system/javatests/src/org/chromium/mojo/bindings/SerializationTest.java

// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

package org.chromium.mojo.bindings;

import androidx.test.filters.SmallTest;

import org.junit.Assert;
import org.junit.Test;
import org.junit.runner.RunWith;

import org.chromium.base.test.BaseJUnit4ClassRunner;
import org.chromium.mojo.HandleMock;
import org.chromium.mojo.bindings.test.mojom.mojo.Struct1;
import org.chromium.mojo.bindings.test.mojom.mojo.Struct2;
import org.chromium.mojo.bindings.test.mojom.mojo.Struct3;
import org.chromium.mojo.bindings.test.mojom.mojo.Struct4;
import org.chromium.mojo.bindings.test.mojom.mojo.Struct5;
import org.chromium.mojo.bindings.test.mojom.mojo.Struct6;
import org.chromium.mojo.bindings.test.mojom.mojo.StructOfNullables;

import java.nio.ByteBuffer;

/**
 * Tests for the serialization logic of the generated structs, using structs defined in
 * mojo/public/interfaces/bindings/tests/serialization_test_structs.mojom .
 */
@RunWith(BaseJUnit4ClassRunner.class)
public class SerializationTest {
    private static void assertThrowsSerializationException(Struct struct) {
        try {
            struct.serialize(null);
            Assert.fail("Serialization of invalid struct should have thrown an exception.");
        } catch (SerializationException ex) {
            // Expected.
        }
    }

    /**
     * Verifies that serializing a struct with an invalid handle of a non-nullable type throws an
     * exception.
     */
    @Test
    @SmallTest
    public void testHandle() {
        Struct2 struct = new Struct2();
        Assert.assertFalse(struct.hdl.isValid());
        assertThrowsSerializationException(struct);

        // Make the struct valid and verify that it serializes without an exception.
        struct.hdl = new HandleMock();
        struct.serialize(null);
    }

    /** Verifies that serializing a struct with a null struct pointer throws an exception. */
    @Test
    @SmallTest
    public void testStructPointer() {
        Struct3 struct = new Struct3();
        Assert.assertNull(struct.struct1);
        assertThrowsSerializationException(struct);

        // Make the struct valid and verify that it serializes without an exception.
        struct.struct1 = new Struct1();
        struct.serialize(null);
    }

    /**
     * Verifies that serializing a struct with an array of structs throws an exception when the
     * struct is invalid.
     */
    @Test
    @SmallTest
    public void testStructArray() {
        Struct4 struct = new Struct4();
        Assert.assertNull(struct.data);
        assertThrowsSerializationException(struct);

        // Create the (1-element) array but have the element null.
        struct.data = new Struct1[1];
        assertThrowsSerializationException(struct);

        // Create the array element, struct should serialize now.
        struct.data[0] = new Struct1();
        struct.serialize(null);
    }

    /**
     * Verifies that serializing a struct with a fixed-size array of incorrect length throws an
     * exception.
     */
    @Test
    @SmallTest
    public void testFixedSizeArray() {
        Struct5 struct = new Struct5();
        Assert.assertNull(struct.pair);
        assertThrowsSerializationException(struct);

        // Create the (1-element) array, 2-element array is required.
        struct.pair = new Struct1[1];
        struct.pair[0] = new Struct1();
        assertThrowsSerializationException(struct);

        // Create the array of a correct size, struct should serialize now.
        struct.pair = new Struct1[2];
        struct.pair[0] = new Struct1();
        struct.pair[1] = new Struct1();
        struct.serialize(null);
    }

    /** Verifies that serializing a struct with a null string throws an exception. */
    @Test
    @SmallTest
    public void testString() {
        Struct6 struct = new Struct6();
        Assert.assertNull(struct.str);
        assertThrowsSerializationException(struct);

        // Make the struct valid and verify that it serializes without an exception.
        struct.str = "";
        struct.serialize(null);
    }

    /**
     * Verifies that a struct with an invalid nullable handle, null nullable struct pointer and null
     * nullable string serializes without an exception.
     */
    @Test
    @SmallTest
    public void testNullableFields() {
        StructOfNullables struct = new StructOfNullables();
        Assert.assertFalse(struct.hdl.isValid());
        Assert.assertNull(struct.struct1);
        Assert.assertNull(struct.str);
        struct.serialize(null);
    }

    /** Verifies that a struct can be serialized to and deserialized from a ByteBuffer. */
    @Test
    @SmallTest
    public void testByteBufferSerialization() {
        Struct1 input = new Struct1();
        input.i = 0x7F;

        ByteBuffer buf = input.serialize();

        byte[] expected_raw_bytes = {16, 0, 0, 0, 0, 0, 0, 0, 0x7F, 0, 0, 0, 0, 0, 0, 0};
        ByteBuffer expected_buf = ByteBuffer.wrap(expected_raw_bytes);
        Assert.assertEquals(expected_buf, buf);

        Struct1 output = Struct1.deserialize(buf);
        Assert.assertEquals(0x7F, output.i);
    }

    /** Verifies that a struct with handles cannot be serialized to a ByteBuffer. */
    @Test
    @SmallTest
    public void testByteBufferSerializationWithHandles() {
        StructOfNullables struct = new StructOfNullables();
        Assert.assertFalse(struct.hdl.isValid());
        Assert.assertNull(struct.struct1);
        Assert.assertNull(struct.str);

        // It is okay to serialize invalid handles.
        struct.serialize();

        struct.hdl = new HandleMock();

        try {
            struct.serialize();
            Assert.fail(
                    "Serializing a struct with handles to a ByteBuffer should have thrown an "
                            + "exception.");
        } catch (UnsupportedOperationException ex) {
            // Expected.
        }
    }
}