com.ibm.as400.access.AS400JDBCRowId Maven / Gradle / Ivy
Show all versions of jt400 Show documentation
///////////////////////////////////////////////////////////////////////////////
//
// JTOpen (IBM Toolbox for Java - OSS version)
//
// Filename: AS400JDBCRowId.java
//
// The source code contained herein is licensed under the IBM Public License
// Version 1.0, which has been approved by the Open Source Initiative.
// Copyright (C) 2006-2006 International Business Machines Corporation and
// others. All rights reserved.
//
///////////////////////////////////////////////////////////////////////////////
package com.ibm.as400.access;
import java.io.Serializable;
/* ifdef JDBC40 */
import java.sql.RowId;
/* endif */
//@PDA jdbc40 new class
public class AS400JDBCRowId
/* ifdef JDBC40 */
implements RowId,Serializable
/* endif */
/* ifndef JDBC40
implements Serializable
endif */
{
private byte[] data_;
//put byteToHex conversion here in case BinaryConverter is not in jar.
private static final char[] c_ = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
/**
* Constructs an AS400JDBCRowId object. The data is contained
* in the raw byte array. No further communication with the IBM i system
* is necessary.
*
* @param data The RowId data.
**/
AS400JDBCRowId(byte[] data)
{
data_ = data;
}
/**
* Compares this RowId to the specified object. The result is
* true if and only if the argument is not null and is a RowId
* object that represents the same ROWID as this object.
*
* It is important
* to consider both the origin and the valid lifetime of a RowId
* when comparing it to another RowId. If both are valid, and
* both are from the same table on the same data source, then if they are equal
* they identify
* the same row; if one or more is no longer guaranteed to be valid, or if
* they originate from different data sources, or different tables on the
* same data source, they may be equal but still
* not identify the same row.
*
* @param obj the Object to compare this RowId object
* against.
* @return true if the RowIds are equal; false otherwise
*/
/* ifdef JDBC40 */
public boolean equals(Object obj)
{
if (!(obj instanceof RowId))
{
return false;
}
byte[] otherBytes = ((RowId) obj).getBytes();
if (data_.length != otherBytes.length)
return false;
for (int i = 0; i < data_.length; i++)
{
if (data_[i] != otherBytes[i])
return false;
}
return true;
}
/* endif */
/**
* Returns an array of bytes representing the value of the SQL ROWID
* designated by this java.sql.RowId object.
*
* @return an array of bytes, whose length is determined by the driver supplying
* the connection, representing the value of the ROWID designated by this
* java.sql.RowId object.
*/
public byte[] getBytes()
{
return data_;
}
/**
* Returns a String representing the value of the SQL ROWID designated by this
* java.sql.RowId object.
*
* Like java.sql.Date.toString()
* returns the contents of its DATE as the String "2004-03-17"
* rather than as DATE literal in SQL (which would have been the String
* DATE "2004-03-17"), toString()
* returns the contents of its ROWID in a form specific to the driver supplying
* the connection, and possibly not as a ROWID literal.
* Toolbox converts RowId bytes to HEX string format.
*
* @return a String whose format is determined by the driver supplying the
* connection, representing the value of the ROWID designated
* by this java.sql.RowId object.
*/
public String toString()
{
return bytesToString(data_);
}
static final String bytesToString(final byte[] b)
{
return bytesToString(b, 0, b.length);
}
static final String bytesToString(final byte[] b, int offset, int length)
{
char[] c = new char[length*2];
int num = bytesToString(b, offset, length, c, 0);
return new String(c, 0, num);
}
static final int bytesToString(final byte[] b, int offset, int length, final char[] c, int coffset)
{
for(int i=0; i>>4) & 0x0F);
final byte lo = (byte)((b[i+offset] & 0x0F));
c[j+coffset] = c_[hi];
c[j+coffset+1] = c_[lo];
}
return length*2;
}
/**
* Returns a hash code value of this RowId object.
*
* @return a hash code for the RowId
*/
public int hashCode()
{
//for now, use String's implementation. seems good enough.
return this.toString().hashCode();
}
}