com.alachisoft.ncache.serialization.standard.io.surrogates.StringArraySerializationSurrogate Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of nc-serialization Show documentation
Internal package of Alachisoft.
There is a newer version: 5.3.3
/*
 * @(#)StringArraySerializationSurrogate.java	1.0
 *
 * Created on September 18, 2008, 12:59 PM
 *
 * Copyright 2008 NeXtreme Innovations, Inc. All rights reserved.
 * "NeXtreme Innovations" PROPRIETARY/CONFIDENTIAL. Use is subject
 * to license terms.
 */
package com.alachisoft.ncache.serialization.standard.io.surrogates;

import com.alachisoft.ncache.serialization.core.io.NCacheObjectInput;
import com.alachisoft.ncache.serialization.core.io.NCacheObjectOutput;
import com.alachisoft.ncache.serialization.core.io.surrogates.BuiltinSerializationSurrogate;
import com.alachisoft.ncache.serialization.core.io.surrogates.NCacheIOException;
import com.alachisoft.ncache.serialization.core.io.surrogates.NCacheInstantiationException;
import com.alachisoft.ncache.serialization.core.io.surrogates.SerializationSurrogateImpl;

import java.io.IOException;

/**
 * StringArraySerializationSurrogate is responsible for writing and reading
 * instances of String[] class.
 *
 * @version 1.0, September 18, 2008
 */
public class StringArraySerializationSurrogate
        extends SerializationSurrogateImpl
        implements BuiltinSerializationSurrogate {

    /**
     * Creates a new instance of NxObjectArraySerializationSurrogate
     */
    public StringArraySerializationSurrogate() {
        super(String[].class);
    }

    /**
     * Creates instance of type returned by getRealClass(). This is different from NxSerializationSurrogateBase.createTypeInstance()
     * in the sense that an NCacheObjectInput object is passed as parameter that can be used to read creation specific
     * information from the stream. For example it can be used to read the length of the array before actually
     * reading the values.
     * 
     * The default implementation simply delegates to super.createTypeInstance().
     *
     * @param input stream reader
     * @return Object that this surrogate must deserialize
     * @throws NCacheInstantiationException Object creation related exceptions.
     */
    @Override
    public Object instantiate(NCacheObjectInput input)
            throws NCacheInstantiationException {
        try {
            int length = input.readInt();
            return new String[length];
        } catch (IOException ex) {
            throw new NCacheInstantiationException(ex);
        }
    }

    /**
     * Read an object of type returned by getRealClass() from the stream reader.
     * A fresh instance of the object is passed as parameter.
     * The surrogate should populate fields in the object from data on the stream
     *
     * @param input stream reader
     * @param graph a fresh instance of the object that the surrogate must deserialize.
     * @return object read from the stream reader
     * @throws NCacheInstantiationException Object creation related exceptions.
     * @throws NCacheIOException            Any of the usual Input/Output related exceptions.
     */
    public Object readDirect(NCacheObjectInput input, Object graph)
            throws NCacheInstantiationException, NCacheIOException {
        try {
            String[] array = (String[]) graph;
            int len = array.length;
            for (int i = 0; i < len; i++) {
                if (input.readShort() == 1) {
                    array[i] = input.readUTF();
                } else {
                }
            }
            return array;
        } catch (IOException ex) {
            throw new NCacheIOException(ex);
        }
    }

    /**
     * Write an object of type returned by getRealClass() to the stream writer
     *
     * @param output stream writer
     * @param graph  object to be written to the stream reader
     * @throws NCacheIOException Any of the usual Input/Output related exceptions.
     */
    public void writeDirect(NCacheObjectOutput output, Object graph)
            throws NCacheIOException {
        try {
            String[] array = (String[]) graph;
            int len = array.length;
            output.writeInt(len);
            for (int i = 0; i < len; i++) {
                if (array[i] != null) {
                    output.writeShort(1);
                    output.writeUTF(array[i]);
                } else {
                    output.writeShort(0);
                }
            }
        } catch (IOException ex) {
            throw new NCacheIOException(ex);
        }
    }

    @Override
    public void skipDirect(NCacheObjectInput input, Object graph) throws NCacheInstantiationException, NCacheIOException {
        try {
            String[] array = (String[]) graph;
            int len = array.length;
            for (int i = 0; i < len; i++) {
                input.skipShort();
                input.skipUTF();
            }
        } catch (IOException ex) {
            throw new NCacheIOException(ex);
        }
    }
}