All Downloads are FREE. Search and download functionalities are using the official Maven repository.

java.io.ObjectStreamField Maven / Gradle / Ivy

There is a newer version: 1.2.9
Show newest version
/*
 *  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 java.io;

import java.lang.ref.WeakReference;
import java.util.Arrays;
import java.util.Comparator;

/**
 * Describes a field for the purpose of serialization. Classes can define the
 * collection of fields that are serialized, which may be different from the set
 * of all declared fields.
 *
 * @see ObjectOutputStream#writeFields()
 * @see ObjectInputStream#readFields()
 */
public class ObjectStreamField implements Comparable {

    // Declared name of the field
    private String name;

    // Declared type of the field
    private Object type;

    // offset of this field in the object
    int offset;

    // Cached version of intern'ed type String
    private String typeString;

    private boolean unshared;

    private boolean isDeserialized;

    /**
     * Constructs an ObjectStreamField with the specified name and type.
     *
     * @param name
     *            the name of the field.
     * @param cl
     *            the type of the field.
     * @throws NullPointerException
     *             if {@code name} or {@code cl} is {@code null}.
     */
    public ObjectStreamField(String name, Class cl) {
        if (name == null) {
            throw new NullPointerException("name == null");
        } else if (cl == null) {
            throw new NullPointerException("cl == null");
        }
        this.name = name;
        this.type = new WeakReference>(cl);
    }

    /**
     * Constructs an ObjectStreamField with the specified name, type and the
     * indication if it is unshared.
     *
     * @param name
     *            the name of the field.
     * @param cl
     *            the type of the field.
     * @param unshared
     *            {@code true} if the field is written and read unshared;
     *            {@code false} otherwise.
     * @throws NullPointerException
     *             if {@code name} or {@code cl} is {@code null}.
     * @see ObjectOutputStream#writeUnshared(Object)
     */
    public ObjectStreamField(String name, Class cl, boolean unshared) {
        if (name == null) {
            throw new NullPointerException("name == null");
        } else if (cl == null) {
            throw new NullPointerException("cl == null");
        }
        this.name = name;
        this.type = (cl.getClassLoader() == null) ? cl : new WeakReference>(cl);
        this.unshared = unshared;
    }

    /**
     * Constructs an ObjectStreamField with the given name and the given type.
     * The type may be null.
     *
     * @param signature
     *            A String representing the type of the field
     * @param name
     *            a String, the name of the field, or null
     */
    ObjectStreamField(String signature, String name) {
        if (name == null) {
            throw new NullPointerException("name == null");
        }
        this.name = name;
        this.typeString = signature.replace('.', '/').intern();
        defaultResolve();
        this.isDeserialized = true;
    }

    /**
     * Compares this field descriptor to the specified one. Checks first if one
     * of the compared fields has a primitive type and the other one not. If so,
     * the field with the primitive type is considered to be "smaller". If both
     * fields are equal, their names are compared.
     *
     * @param o
     *            the object to compare with.
     * @return -1 if this field is "smaller" than field {@code o}, 0 if both
     *         fields are equal; 1 if this field is "greater" than field {@code
     *         o}.
     */
    public int compareTo(Object o) {
        ObjectStreamField f = (ObjectStreamField) o;
        boolean thisPrimitive = this.isPrimitive();
        boolean fPrimitive = f.isPrimitive();

        // If one is primitive and the other isn't, we have enough info to
        // compare
        if (thisPrimitive != fPrimitive) {
            return thisPrimitive ? -1 : 1;
        }

        // Either both primitives or both not primitives. Compare based on name.
        return this.getName().compareTo(f.getName());
    }

    /**
     * Gets the name of this field.
     *
     * @return the field's name.
     */
    public String getName() {
        return name;
    }

    /**
     * Gets the offset of this field in the object.
     *
     * @return this field's offset.
     */
    public int getOffset() {
        return offset;
    }

    /**
     * Return the type of the field the receiver represents, this is an internal
     * method
     *
     * @return A Class object representing the type of the field
     */
    // Changed from private to default visibility for usage in ObjectStreamClass
    /* package */ Class getTypeInternal() {
        if (type instanceof WeakReference) {
            return (Class) ((WeakReference) type).get();
        }
        return (Class) type;
    }

    /**
     * Gets the type of this field.
     *
     * @return a {@code Class} object representing the type of the field.
     */
    public Class getType() {
        Class cl = getTypeInternal();
        if (isDeserialized && !cl.isPrimitive()) {
            return Object.class;
        }
        return cl;
    }

    /**
     * Gets a character code for the type of this field. The following codes are
     * used:
     *
     * 
     * B     byte
     * C     char
     * D     double
     * F     float
     * I     int
     * J     long
     * L     class or interface
     * S     short
     * Z     boolean
     * [     array
     * 
* * @return the field's type code. */ public char getTypeCode() { return typeCodeOf(getTypeInternal()); } private char typeCodeOf(Class type) { if (type == int.class) { return 'I'; } else if (type == byte.class) { return 'B'; } else if (type == char.class) { return 'C'; } else if (type == short.class) { return 'S'; } else if (type == boolean.class) { return 'Z'; } else if (type == long.class) { return 'J'; } else if (type == float.class) { return 'F'; } else if (type == double.class) { return 'D'; } else if (type.isArray()) { return '['; } else { return 'L'; } } /** * Gets the type signature used by the VM to represent the type of this * field. * * @return the signature of this field's class or {@code null} if this * field's type is primitive. */ public String getTypeString() { if (isPrimitive()) { return null; } if (typeString == null) { Class t = getTypeInternal(); String typeName = t.getName().replace('.', '/'); String str = (t.isArray()) ? typeName : ("L" + typeName + ';'); typeString = str.intern(); } return typeString; } /** * Indicates whether this field's type is a primitive type. * * @return {@code true} if this field's type is primitive; {@code false} if * the type of this field is a regular class. */ public boolean isPrimitive() { Class t = getTypeInternal(); return t != null && t.isPrimitive(); } boolean writeField(DataOutputStream out) throws IOException { Class t = getTypeInternal(); out.writeByte(typeCodeOf(t)); out.writeUTF(name); return (t != null && t.isPrimitive()); } /** * Sets this field's offset in the object. * * @param newValue * the field's new offset. */ protected void setOffset(int newValue) { this.offset = newValue; } /** * Returns a string containing a concise, human-readable description of this * field descriptor. * * @return a printable representation of this descriptor. */ @Override public String toString() { return this.getClass().getName() + '(' + getName() + ':' + getTypeInternal() + ')'; } void resolve(ClassLoader loader) { if (typeString == null && isPrimitive()) { // primitive type declared in a serializable class typeString = String.valueOf(getTypeCode()); } if (typeString.length() == 1) { if (defaultResolve()) { return; } } String className = typeString.replace('/', '.'); if (className.charAt(0) == 'L') { // remove L and ; className = className.substring(1, className.length() - 1); } try { Class cl = Class.forName(className, false, loader); type = (cl.getClassLoader() == null) ? cl : new WeakReference>(cl); } catch (ClassNotFoundException e) { // Ignored } } /** * Indicates whether this field is unshared. * * @return {@code true} if this field is unshared, {@code false} otherwise. */ public boolean isUnshared() { return unshared; } void setUnshared(boolean unshared) { this.unshared = unshared; } /** * Resolves typeString into type. Returns true if the type is primitive * and false otherwise. */ private boolean defaultResolve() { switch (typeString.charAt(0)) { case 'I': type = int.class; return true; case 'B': type = byte.class; return true; case 'C': type = char.class; return true; case 'S': type = short.class; return true; case 'Z': type = boolean.class; return true; case 'J': type = long.class; return true; case 'F': type = float.class; return true; case 'D': type = double.class; return true; default: type = Object.class; return false; } } }