Home
Extending HCL OneDB™Beyond standard relational database objects, HCL OneDB™ can be extended to handle specialized data types, access methods, routines, and other objects. HCL OneDB™ includes many built-in extensions that are fully integrated in the database server. HCL OneDB™ also provides DataBlade® modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for HCL OneDB™.
Creating extensionsYou can create user-defined data types, routines, access methods, and other database objects to suit your needs. You can use application programming interfaces to write user-defined routines and applications that access data in HCL OneDB™ databases.
J/Foundation Developer's GuideThe HCL® J/Foundation Developer's Guide describes how to write user-defined routines (UDRs) in the Java™ programming language for HCL OneDB™.
Opaque user-defined data typesThis section describes how to use opaque user-defined data types (UDTs). This section describes the default SQLData interface and how to override the default.
Using the SQLData interfaceTo implement a complete UDT in Java™ code, you must supply a set of data-formatting methods that convert to and from the various representations of the data type. These methods perform input and output operations for the data type such as converting text input to the internal structure that the database server uses.
HCL OneDB™ extensions to SQLInput and SQLOutput
IfmxUDTSQLOutput

IfmxUDTSQLOutput

The IfmxUDTSQLOutput interface extends SQLOutput, which contains the following public methods:

void writeString(String x)
void writeBoolean(boolean x)
void writeByte(byte x)
void writeShort(short x)
void writeInt(int x)
void writeLong(long x)
void writeFloat(float x)
void writeDouble(double x)
void writeBigDecimal(java.math.BigDecimal x)
void writeBytes(byte[] x)
void writeDate(java.sql.Date x)
void writeTime(java.sql.Time x)
void writeTimestamp(java.sql.Timestamp x)
void writeCharacterStream(java.io.Reader x)
void writeAsciiStream(java.io.InputStream x)
void writeBinaryStream(java.io.InputStream x)
void writeObject(SQLData x)
void writeRef(Ref x)
void writeBlob(Blob x)
void writeClob(Clob x)
void writeStruct(Struct x)
void writeArray(Array x)

The IfmxUDTSQLOutput interface adds the following HCL OneDB™ methods:

void writeString(String x, int length)
void writeBytes(byte[] b, int length)
void writeInterval(Interval intrvl)
int available()
int length()
IfxUDTInfo getUDTInfo(int xid)
IfxUDTInfo getUDTInfo(String name, String owner)

All the writeXXX() methods throw an exception when they encounter conversion errors. Use the Stream write() methods to convert a Java™ object into the given Output buffer. The length() method returns the number of bytes that remain in the buffer. The OneDB JDBC Driver 2.0 class files describe the SQLOutput definition.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.