src.com.ibm.as400.access.AS400Float4 Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jt400-jdk8 Show documentation
Show all versions of jt400-jdk8 Show documentation
The Open Source version of the IBM Toolbox for Java
///////////////////////////////////////////////////////////////////////////////
//
// JTOpen (IBM Toolbox for Java - OSS version)
//
// Filename: AS400Float4.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) 1997-2004 International Business Machines Corporation and
// others. All rights reserved.
//
///////////////////////////////////////////////////////////////////////////////
package com.ibm.as400.access;
/**
* The AS400Float4 class provides a converter between a Float object and a four-byte floating point number.
**/
public class AS400Float4 implements AS400DataType
{
static final long serialVersionUID = 4L;
private static final int SIZE = 4;
private static final float defaultValue = 0.0f;
/**
* Constructs an AS400Float4 object.
*/
public AS400Float4()
{
}
/**
* Creates a new AS400Float4 object that is identical to the current instance.
* @return The new object.
**/
public Object clone()
{
try
{
return super.clone(); // Object.clone does not throw exception
}
catch (CloneNotSupportedException e)
{
Trace.log(Trace.ERROR, "Unexpected cloning error", e);
throw new InternalErrorException(InternalErrorException.UNKNOWN, e);
}
}
/**
* Returns the byte length of the data type.
* @return Four (4), the number of bytes in the IBM i representation of the data type.
**/
public int getByteLength()
{
return SIZE;
}
/**
* Returns a Java object representing the default value of the data type.
* @return The Float object with a value of zero.
**/
public Object getDefaultValue()
{
return new Float(defaultValue);
}
/**
* Returns {@link com.ibm.as400.access.AS400DataType#TYPE_FLOAT4 TYPE_FLOAT4}.
* @return AS400DataType.TYPE_FLOAT4.
**/
public int getInstanceType()
{
return AS400DataType.TYPE_FLOAT4;
}
/**
* Returns the Java class that corresponds with this data type.
* @return Float.class.
**/
public Class getJavaType()
{
return Float.class;
}
/**
* Converts the specified Java object to IBM i format.
* @param javaValue The object corresponding to the data type. It must be an instance of Float.
* @return The IBM i representation of the data type.
**/
public byte[] toBytes(Object javaValue)
{
byte[] as400Value = new byte[SIZE];
BinaryConverter.floatToByteArray(((Float)javaValue).floatValue(), as400Value, 0); // Allow this line to throw ClassCastException and NullPointerException
return as400Value;
}
/**
* Converts the specified float to IBM i format.
* @param floatValue The value to be converted to IBM i format.
* @return The IBM i representation of the data type.
**/
public byte[] toBytes(float floatValue)
{
byte[] as400Value = new byte[SIZE];
BinaryConverter.floatToByteArray(floatValue, as400Value, 0);
return as400Value;
}
/**
* Converts the specified Java object into IBM i format in the specified byte array.
* @param javaValue The object corresponding to the data type. It must be an instance of Float.
* @param as400Value The array to receive the data type in IBM i format. There must be enough space to hold the IBM i value.
* @return Four (4), the number of bytes in the IBM i representation of the data type.
**/
public int toBytes(Object javaValue, byte[] as400Value)
{
// BinaryConverter will throw the ArrayIndexException's
BinaryConverter.floatToByteArray(((Float)javaValue).floatValue(), as400Value, 0); // Allow this line to throw ClassCastException and NullPointerException
return SIZE;
}
/**
* Converts the specified float into IBM i format in the specified byte array.
* @param floatValue The value to be converted to IBM i format.
* @param as400Value The array to receive the data type in IBM i format. There must be enough space to hold the IBM i value.
* @return Four (4), the number of bytes in the IBM i representation of the data type.
**/
public int toBytes(float floatValue, byte[] as400Value)
{
// BinaryConverter will throw the ArrayIndexException's
BinaryConverter.floatToByteArray(floatValue, as400Value, 0);
return SIZE;
}
/**
* Converts the specified Java object into IBM i format in the specified byte array.
* @param javaValue The object corresponding to the data type. It must be an instance of Float.
* @param as400Value The array to receive the data type in IBM i format. There must be enough space to hold the IBM i value.
* @param offset The offset into the byte array for the start of the IBM i value. It must be greater than or equal to zero.
* @return Four (4), the number of bytes in the IBM i representation of the data type.
**/
public int toBytes(Object javaValue, byte[] as400Value, int offset)
{
// BinaryConverter will throw the ArrayIndexException's
BinaryConverter.floatToByteArray(((Float)javaValue).floatValue(), as400Value, offset); // Allow this line to throw ClassCastException and NullPointerException
return SIZE;
}
/**
* Converts the specified float into IBM i format in the specified byte array.
* @param floatValue The value to be converted to IBM i format.
* @param as400Value The array to receive the data type in IBM i format. There must be enough space to hold the IBM i value.
* @param offset The offset into the byte array for the start of the IBM i value. It must be greater than or equal to zero.
* @return Four (4), the number of bytes in the IBM i representation of the data type.
**/
public int toBytes(float floatValue, byte[] as400Value, int offset)
{
// BinaryConverter will throw the ArrayIndexException's
BinaryConverter.floatToByteArray(floatValue, as400Value, offset);
return SIZE;
}
/**
* Converts the specified IBM i data type to a float.
* @param as400Value The array containing the data type in IBM i format. The entire data type must be represented.
* @return The float corresponding to the data type.
**/
public float toFloat(byte[] as400Value)
{
// BinaryConverter will throw the ArrayIndexException's
return BinaryConverter.byteArrayToFloat(as400Value, 0);
}
/**
* Converts the specified IBM i data type to a float.
* @param as400Value The array containing the data type in IBM i format. The entire data type must be represented.
* @param offset The offset into the byte array for the start of the IBM i value. It must be greater than or equal to zero.
* @return The float corresponding to the data type.
**/
public float toFloat(byte[] as400Value, int offset)
{
// BinaryConverter will throw the ArrayIndexException's
return BinaryConverter.byteArrayToFloat(as400Value, offset);
}
/**
* Converts the specified IBM i data type to a Java object.
* @param as400Value The array containing the data type in IBM i format. The entire data type must be represented.
* @return The Float object corresponding to the data type.
**/
public Object toObject(byte[] as400Value)
{
// BinaryConverter will throw the ArrayIndexException's
return new Float(BinaryConverter.byteArrayToFloat(as400Value, 0));
}
/**
* Converts the specified IBM i data type to a Java object.
* @param as400Value The array containing the data type in IBM i format. The entire data type must be represented.
* @param offset The offset into the byte array for the start of the IBM i value. It must be greater than or equal to zero.
* @return The Float object corresponding to the data type.
**/
public Object toObject(byte[] as400Value, int offset)
{
// BinaryConverter will throw the ArrayIndexException's
return new Float(BinaryConverter.byteArrayToFloat(as400Value, offset));
}
}