/* Copyright (c) 2001-2019, The HSQL Development Group
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * Redistributions of source code must retain the above copyright notice, this
 * list of conditions and the following disclaimer.
 *
 * Redistributions in binary form must reproduce the above copyright notice,
 * this list of conditions and the following disclaimer in the documentation
 * and/or other materials provided with the distribution.
 *
 * Neither the name of the HSQL Development Group nor the names of its
 * contributors may be used to endorse or promote products derived from this
 * software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL HSQL DEVELOPMENT GROUP, HSQLDB.ORG,
 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */


package org.hsqldb.types;

import org.hsqldb.Session;
import org.hsqldb.SessionInterface;
import org.hsqldb.Tokens;
import org.hsqldb.error.Error;
import org.hsqldb.error.ErrorCode;
import org.hsqldb.jdbc.JDBCBlobClient;

Type object for BLOB.
Author:Fred Toussi (fredt@users dot sourceforge.net)
Version:2.5.0
Since:1.9.0
/** * Type object for BLOB. * * @author Fred Toussi (fredt@users dot sourceforge.net) * @version 2.5.0 * @since 1.9.0 */
public final class BlobType extends BinaryType { public static final long maxBlobPrecision = 1024L * 1024 * 1024 * 1024; public static final int defaultBlobSize = 1024 * 1024 * 1024; public static final int defaultShortBlobSize = 16 * 1024 * 1024; public BlobType(long precision) { super(Types.SQL_BLOB, precision); } public int displaySize() { return precision > Integer.MAX_VALUE ? Integer.MAX_VALUE : (int) precision; } public int getJDBCTypeCode() { return Types.BLOB; } public Class getJDBCClass() { return java.sql.Blob.class; } public String getJDBCClassName() { return "java.sql.Blob"; } public String getNameString() { return Tokens.T_BLOB; } public String getFullNameString() { return "BINARY LARGE OBJECT"; } public String getDefinition() { long factor = precision; String multiplier = null; if (precision % (1024 * 1024 * 1024) == 0) { factor = precision / (1024 * 1024 * 1024); multiplier = Tokens.T_G_FACTOR; } else if (precision % (1024 * 1024) == 0) { factor = precision / (1024 * 1024); multiplier = Tokens.T_M_FACTOR; } else if (precision % (1024) == 0) { factor = precision / (1024); multiplier = Tokens.T_K_FACTOR; } StringBuilder sb = new StringBuilder(16); sb.append(getNameString()); sb.append('('); sb.append(factor); if (multiplier != null) { sb.append(multiplier); } sb.append(')'); return sb.toString(); } public boolean isBinaryType() { return true; } public boolean isLobType() { return true; } public boolean acceptsPrecision() { return true; } public long getMaxPrecision() { return maxBlobPrecision; } public boolean requiresPrecision() { return false; } public int compare(Session session, Object a, Object b) { if (a == b) { return 0; } if (a == null) { return -1; } if (b == null) { return 1; } if (b instanceof BinaryData) { long lobId = ((BlobData) a).getId(); return session.database.lobManager.compare(lobId, ((BlobData) b).getBytes()); } return session.database.lobManager.compare((BlobData) a, (BlobData) b); }
@todo- implement
/** @todo - implement */
public Object convertToTypeLimits(SessionInterface session, Object a) { return a; } public Object castToType(SessionInterface session, Object a, Type otherType) { if (a == null) { return null; } if (otherType.typeCode == Types.SQL_BLOB) { BlobData b = (BlobData) a; long blobLength = b.length(session); if (blobLength > precision) { blobLength = precision; session.addWarning(Error.error(ErrorCode.W_01004)); b = b.getBlob(session, 0, blobLength); return b; } return a; } if (otherType.typeCode == Types.SQL_BINARY || otherType.typeCode == Types.SQL_VARBINARY) { BlobData b = (BlobData) a; long blobLength = b.length(session); if (blobLength > precision) { blobLength = precision; session.addWarning(Error.error(ErrorCode.W_01004)); } BlobData blob = session.createBlob(b.length(session)); blob.setBytes(session, 0, b.getBytes(), 0, (int) blobLength); return blob; } throw Error.error(ErrorCode.X_42561); } public Object convertToType(SessionInterface session, Object a, Type otherType) { BlobData b = null; if (a == null) { return null; } if (otherType.typeCode == Types.SQL_BLOB) { b = (BlobData) a; long blobLength = b.length(session); if (blobLength > precision) { throw Error.error(ErrorCode.X_22001); } return a; } if (otherType.typeCode == Types.SQL_CLOB) { a = Type.SQL_VARCHAR.convertToType(session, a, otherType); otherType = Type.SQL_VARCHAR; } if (otherType.typeCode == Types.SQL_VARCHAR || otherType.typeCode == Types.SQL_CHAR) { a = session.getScanner().convertToBinary((String) a, false); otherType = Type.SQL_VARBINARY; } if (otherType.typeCode == Types.SQL_BINARY || otherType.typeCode == Types.SQL_VARBINARY) { b = (BlobData) a; long blobLength = b.length(session); if (blobLength > precision) { throw Error.error(ErrorCode.X_22001); } BlobData blob = session.createBlob(b.length(session)); blob.setBytes(session, 0, b.getBytes()); return blob; } throw Error.error(ErrorCode.X_42561); } public Object convertJavaToSQL(SessionInterface session, Object a) { if (a == null) { return null; } if (a instanceof JDBCBlobClient) { return ((JDBCBlobClient) a).getBlob(); } throw Error.error(ErrorCode.X_42561); } public Object convertSQLToJava(SessionInterface session, Object a) { if (a == null) { return null; } if (a instanceof BlobDataID) { BlobDataID blob = (BlobDataID) a; return new JDBCBlobClient(session, blob); } throw Error.error(ErrorCode.X_42561); } public Object convertToDefaultType(SessionInterface session, Object a) { if (a == null) { return null; } // conversion to Blob via PreparedStatement.setObject(); if (a instanceof byte[]) { return new BinaryData((byte[]) a, false); } throw Error.error(ErrorCode.X_42561); } public String convertToString(Object a) { if (a == null) { return null; } return Long.toString(((BlobData) a).getId()); } public String convertToSQLString(Object a) { if (a == null) { return Tokens.T_NULL; } return convertToString(a); } }