/*
* 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 libcore.java.io;
import java.io.ObjectInputStream;
import tests.support.Support_GetPutFields;
import tests.support.Support_GetPutFieldsDefaulted;
/**
* Tests the methods of {@code ObjectInputStream.GetField}. Three things make
* this class somewhat difficult to test:
* <ol>
* <li>It is a completely abstract class; none of the methods is implemented in
* {@code ObjectInputStream.GetField}.</li>
* <li>There is no public class that implements
* {@code ObjectInputStream.GetField}. The only way to get an implementation is
* by calling {@code ObjectInputStream.getFields()}.</li>
* <li>Invoking {@code ObjectOutputStream.getFields()} only works from within
* the private {@code readObject(ObjectInputStream)} method of a class that
* implements {@code Serializable}; an exception is thrown otherwise.</li>
* </ol>
* <p>
* Given these restrictions, an indirect approach is used to test
* {@code ObjectInputStream.GetField}: Three serializable helper classes in
* package {@code tests.support} ({@code Support_GetPutFields},
* {@code Support_GetPutFieldsDeprecated} and
* {@code Support_GetPutFieldsDefaulted}) implement
* {@code readObject(ObjectInputStream)} to read data from an input stream.
* This input stream in turn reads from one of the corresponding files
* ({@code testFields.ser}, {@code testFieldsDeprecated.ser} and
* {@code testFieldsDefaulted.ser}) that have been created with
* {@code tests.util.FieldTestFileGenerator} on a reference platform.
* </p>
* <p>
* The test method in this class expects to find the reference files as a
* resource stored at {@code tests/api/java/io}.
* </p>
*/
public class OldObjectInputStreamGetFieldTest extends junit.framework.TestCase {
private ObjectInputStream ois = null;
private final String FILENAME =
"/tests/api/java/io/testFields.ser";
private final String DEFAULTED_FILENAME =
"/tests/api/java/io/testFieldsDefaulted.ser";
public boolean booleanValue;
public byte byteValue;
public char charValue;
public int intValue;
public void test_get() throws Exception {
initOis(FILENAME);
Support_GetPutFields object = (Support_GetPutFields) ois.readObject();
Support_GetPutFields newObject = new Support_GetPutFields();
newObject.initTestValues();
assertTrue("Test 1: The object read from the reference file does " +
"not match a locally created instance of the same class.",
object.equals(newObject));
initOis(DEFAULTED_FILENAME);
Support_GetPutFieldsDefaulted defaulted =
(Support_GetPutFieldsDefaulted) ois.readObject();
Support_GetPutFieldsDefaulted newDefaulted =
new Support_GetPutFieldsDefaulted();
newDefaulted.initTestValues();
assertTrue("Test 2: The object read from the reference file does " +
"not match a locally created instance of the same class.",
defaulted.equals(newDefaulted));
// Executing the same procedure against the file created with the
// deprecated ObjectOutputStream.PutFields.write(ObjectOutput) method
// is not possible since there is no corresponding read(ObjectInput)
// method. When trying to do it as in tests 1 and 2, a
// NullPointerException is thrown.
}
public void test_defaultedLjava_lang_String() throws Exception {
initOis(FILENAME);
Support_GetPutFields object = (Support_GetPutFields) ois.readObject();
ObjectInputStream.GetField fields = object.getField;
try {
fields.defaulted("noField");
fail("IllegalArgumentException expected.");
} catch (IllegalArgumentException e) {}
assertFalse("The field longValue should not be defaulted.",
fields.defaulted("longValue"));
// Now the same with defaulted fields.
initOis(DEFAULTED_FILENAME);
Support_GetPutFieldsDefaulted defaultedObject =
(Support_GetPutFieldsDefaulted) ois.readObject();
fields = defaultedObject.getField;
assertTrue("The field longValue should be defaulted.",
fields.defaulted("longValue"));
}
public void test_getException() throws Exception {
initOis(FILENAME);
Support_GetPutFields object = (Support_GetPutFields) ois.readObject();
ObjectInputStream.GetField fields = object.getField;
// Methods called with invalid field name.
try {
fields.get("noValue", false);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, boolean).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", (byte) 0);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, byte).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", (char) 0);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, char).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", 0.0);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, double).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", 0.0f);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, float).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", (long) 0);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, long).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", 0);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, int).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", new Object());
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, Object).");
} catch (IllegalArgumentException e) {}
try {
fields.get("noValue", (short) 0);
fail("IllegalArgumentException expected for not existing name " +
"argument in get(String, short).");
} catch (IllegalArgumentException e) {}
// Methods called with correct field name but non-matching type.
try {
fields.get("byteValue", false);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, boolean).");
} catch (IllegalArgumentException e) {}
try {
fields.get("booleanValue", (byte) 0);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, byte).");
} catch (IllegalArgumentException e) {}
try {
fields.get("intValue", (char) 0);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, char).");
} catch (IllegalArgumentException e) {}
try {
fields.get("floatValue", 0.0);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, double).");
} catch (IllegalArgumentException e) {}
try {
fields.get("doubleValue", 0.0f);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, float).");
} catch (IllegalArgumentException e) {}
try {
fields.get("intValue", (long) 0);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, long).");
} catch (IllegalArgumentException e) {}
try {
fields.get("shortValue", 0);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, int).");
} catch (IllegalArgumentException e) {}
try {
fields.get("booleanValue", new Object());
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, Object).");
} catch (IllegalArgumentException e) {}
try {
fields.get("longValue", (short) 0);
fail("IllegalArgumentException expected for non-matching name " +
"and type arguments in get(String, short).");
} catch (IllegalArgumentException e) {}
}
public void test_getObjectStreamClass() throws Exception {
initOis(FILENAME);
Support_GetPutFields object = (Support_GetPutFields) ois.readObject();
assertNotNull("Return value of getObjectStreamClass() should not be null.",
object.getField.getObjectStreamClass());
}
private void initOis(String fileName) throws Exception {
if (ois != null) {
ois.close();
}
ois = new ObjectInputStream(
getClass().getResourceAsStream(fileName));
}
protected void tearDown() throws Exception {
if (ois != null) {
ois.close();
}
super.tearDown();
}
}