libcore/nio/src/test/java/org/apache/harmony/nio/tests/java/nio/AbstractBufferTest.java

/* Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.harmony.nio.tests.java.nio;

import dalvik.annotation.TestLevel;
import dalvik.annotation.TestTargetNew;
import dalvik.annotation.TestTargetClass;

import java.nio.Buffer;
import java.nio.ByteBuffer;
import java.nio.InvalidMarkException;

import junit.framework.TestCase;

/**
 * Tests a java.nio.Buffer instance.
 */
@TestTargetClass(java.nio.Buffer.class)
public abstract class AbstractBufferTest extends TestCase {
    
    protected Buffer baseBuf;
    protected int capacity;
    
    protected void setUp() throws Exception{
        super.setUp();
        capacity = 10;
        baseBuf = ByteBuffer.allocate(10);
    }
    
    protected void tearDown() throws Exception{
        super.tearDown();
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "capacity",
        args = {}
    )
    public void testCapacity() {
        assertTrue(0 <= baseBuf.position() && baseBuf.position() <= baseBuf.limit()
                && baseBuf.limit() <= baseBuf.capacity());
        assertEquals(capacity, baseBuf.capacity());
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "clear",
        args = {}
    )
    public void testClear() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        Buffer ret = baseBuf.clear();
        assertSame(ret, baseBuf);
        assertEquals(0, baseBuf.position());
        assertEquals(baseBuf.limit(), baseBuf.capacity());
        try {
            baseBuf.reset();
            fail("Should throw Exception"); //$NON-NLS-1$S
        } catch (InvalidMarkException e) {
            // expected
        }

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "flip",
        args = {}
    )
    public void testFlip() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        baseBuf.mark();

        Buffer ret = baseBuf.flip();
        assertSame(ret, baseBuf);
        assertEquals(0, baseBuf.position());
        assertEquals(oldPosition, baseBuf.limit());
        try {
            baseBuf.reset();
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (InvalidMarkException e) {
            // expected
        }

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "hasRemaining",
        args = {}
    )
    public void testHasRemaining() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        assertEquals(baseBuf.hasRemaining(), baseBuf.position() < baseBuf.limit());
        baseBuf.position(baseBuf.limit());
        assertFalse(baseBuf.hasRemaining());

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "Abstract method.",
        method = "isReadOnly",
        args = {}
    )
    public abstract void testIsReadOnly();

    /*
     * Class under test for int limit()
     */
    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "limit",
        args = {}
    )
    public void testLimit() {
        assertTrue(0 <= baseBuf.position() && baseBuf.position() <= baseBuf.limit()
                && baseBuf.limit() <= baseBuf.capacity());
        assertEquals(capacity, baseBuf.limit());
    }

    /*
     * Class under test for Buffer limit(int)
     */
    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "limit",
        args = {int.class}
    )
    public void testLimitint() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        Buffer ret = baseBuf.limit(baseBuf.limit());
        assertSame(ret, baseBuf);

        baseBuf.mark();
        baseBuf.limit(baseBuf.capacity());
        assertEquals(baseBuf.limit(), baseBuf.capacity());
        // position should not change
        assertEquals(oldPosition, baseBuf.position());
        // mark should be valid
        baseBuf.reset();

        assertTrue("The buffer capacity was 0", baseBuf.capacity() > 0);
        baseBuf.limit(baseBuf.capacity());
        baseBuf.position(baseBuf.capacity());
        baseBuf.mark();
        baseBuf.limit(baseBuf.capacity() - 1);
        // position should be the new limit
        assertEquals(baseBuf.limit(), baseBuf.position());
        // mark should be invalid
        try {
            baseBuf.reset();
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (InvalidMarkException e) {
            // expected
        }

        try {
            baseBuf.limit(-1);
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (IllegalArgumentException e) {
            // expected
        }
        try {
            baseBuf.limit(baseBuf.capacity() + 1);
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (IllegalArgumentException e) {
            // expected
        }

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "mark",
        args = {}
    )
    public void testMark() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        Buffer ret = baseBuf.mark();
        assertSame(ret, baseBuf);

        baseBuf.mark();
        baseBuf.position(baseBuf.limit());
        baseBuf.reset();
        assertEquals(oldPosition, baseBuf.position());

        baseBuf.mark();
        baseBuf.position(baseBuf.limit());
        baseBuf.reset();
        assertEquals(oldPosition, baseBuf.position());

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }

    /*
     * Class under test for int position()
     */
    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "position",
        args = {}
    )
    public void testPosition() {
        assertTrue(0 <= baseBuf.position() && baseBuf.position() <= baseBuf.limit()
                && baseBuf.limit() <= baseBuf.capacity());
        assertEquals(0, baseBuf.position());
    }

    /*
     * Class under test for Buffer position(int)
     */
    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "position",
        args = {int.class}
    )
    public void testPositionint() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        try {
            baseBuf.position(-1);
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (IllegalArgumentException e) {
            // expected
        }
        try {
            baseBuf.position(baseBuf.limit() + 1);
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (IllegalArgumentException e) {
            // expected
        }

        baseBuf.mark();
        baseBuf.position(baseBuf.position());
        baseBuf.reset();
        assertEquals(oldPosition, baseBuf.position());

        baseBuf.position(0);
        assertEquals(0, baseBuf.position());
        baseBuf.position(baseBuf.limit());
        assertEquals(baseBuf.limit(), baseBuf.position());

        assertTrue("The buffer capacity was 0.", baseBuf.capacity() > 0);
        baseBuf.limit(baseBuf.capacity());
        baseBuf.position(baseBuf.limit());
        baseBuf.mark();
        baseBuf.position(baseBuf.limit() - 1);
        assertEquals(baseBuf.limit() - 1, baseBuf.position());
        // mark should be invalid
        try {
            baseBuf.reset();
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (InvalidMarkException e) {
            // expected
        }

        Buffer ret = baseBuf.position(0);
        assertSame(ret, baseBuf);

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "remaining",
        args = {}
    )
    public void testRemaining() {
        assertEquals(baseBuf.remaining(), baseBuf.limit() - baseBuf.position());
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "reset",
        args = {}
    )
    public void testReset() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        baseBuf.mark();
        baseBuf.position(baseBuf.limit());
        baseBuf.reset();
        assertEquals(oldPosition, baseBuf.position());

        baseBuf.mark();
        baseBuf.position(baseBuf.limit());
        baseBuf.reset();
        assertEquals(oldPosition, baseBuf.position());

        Buffer ret = baseBuf.reset();
        assertSame(ret, baseBuf);

        baseBuf.clear();
        try {
            baseBuf.reset();
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (InvalidMarkException e) {
            // expected
        }

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }

    @TestTargetNew(
        level = TestLevel.PARTIAL_COMPLETE,
        notes = "",
        method = "rewind",
        args = {}
    )
    public void testRewind() {
        // save state
        int oldPosition = baseBuf.position();
        int oldLimit = baseBuf.limit();

        Buffer ret = baseBuf.rewind();
        assertEquals(0, baseBuf.position());
        assertSame(ret, baseBuf);
        try {
            baseBuf.reset();
            fail("Should throw Exception"); //$NON-NLS-1$
        } catch (InvalidMarkException e) {
            // expected
        }

        // restore state
        baseBuf.limit(oldLimit);
        baseBuf.position(oldPosition);
    }
}