File: PGBinaryObject.java

package info (click to toggle)
libpgjava 9.2-1002-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 4,308 kB
  • ctags: 4,503
  • sloc: java: 37,623; xml: 3,376; makefile: 22; sh: 10
file content (42 lines) | stat: -rw-r--r-- 1,544 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/*-------------------------------------------------------------------------
*
* Copyright (c) 2011, PostgreSQL Global Development Group
*
*
*-------------------------------------------------------------------------
*/package org.postgresql.util;

import java.sql.SQLException;

/**
 *     PGBinaryObject is a inteface that classes extending {@link PGobject} can use to
 *     take advantage of more optimal binary encoding of the data type.
 */
public interface PGBinaryObject {
    /**
     * This method is called to set the value of this object.
     *
     * @param value data containing the binary representation of the value of the object
     * @param offset the offset in the byte array where object data starts
     * @exception SQLException thrown if value is invalid for this type
     */
    public void setByteValue(byte[] value, int offset) throws SQLException;
    
    /**
     * This method is called to return the number of bytes needed to store 
     * this object in the binary form required by org.postgresql.
     *
     * @return the number of bytes needed to store this object
     */
    public int lengthInBytes();

    /**
     * This method is called the to store the value of the object, in the
     * binary form required by org.postgresql.
     *
     * @param bytes the array to store the value, it is guaranteed to be at
     *        lest {@link #lengthInBytes} in size.
     * @param offset the offset in the byte array where object must be stored
     */
    public void toBytes(byte[] bytes, int offset);
}