org.firebirdsql.gds.impl.wire.Xdrable Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jaybird Show documentation

JDBC Driver for the Firebird RDBMS

There is a newer version: 6.0.0-beta-1

/*
 * Firebird Open Source J2ee connector - jdbc driver
 *
 * Distributable under LGPL license.
 * You may obtain a copy of the License at http://www.gnu.org/copyleft/lgpl.html
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * LGPL License for more details.
 *
 * This file was created by members of the firebird development team.
 * All individual contributions remain the Copyright (C) of those
 * individuals.  Contributors to this file are either listed here or
 * can be obtained from a CVS history command.
 *
 * All rights reserved.
 */

package org.firebirdsql.gds.impl.wire;

import java.io.IOException;

/**
 * The interface Xdrable represents an object that can read
 * and write itself from a strean in the xdr format used by the firebird 
 * engine.
 *
 * @author David Jencks
 * @version 1.0
 */
public interface Xdrable {

    /**
     * Get the total length (in bytes) of this Xdrable when it
     * is written to XDR format.
     *
     * @return The total length in bytes
     */
    int getLength();

    /**
     * Read in Xdrable in XDR format, from an 
     * XdrInputStream.
     *
     * @param in The input stream from which the object is to be read.
     * @param length The number of bytes to be read
     * @throws IOException if an error occurs while reading from 
     *         the XdrInputStream
     */
    void read(XdrInputStream in, int length) throws IOException;

    /**
     * Write the this Xdrable out in XDR format to
     * an XdrOutputStream.
     *
     * @param out The output stream to which the Xdrable is 
     *        to be written
     * @throws IOException if an error occurs while writing to the
     *         XdrOutputStream
     */
    void write(XdrOutputStream out) throws IOException;

}