Time series Java class library

You can use the time series Java™ class library to create and manage a time series from within Java applications or applets.

The time series Java class library uses the JDBC 2.0 specification for supporting user-defined data types in Java.

When you write a Java application for time series data, you use the to connect to the IBM® Informix® database, as shown in the following figure. See your IBM Informix JDBC Driver Programmer's Guide for information about how to set up your Java programs to connect to databases.

Figure 1. Runtime architecture for Java programs that connect to a database

The figure is described in the surrounding text.

The Java application makes calls to the JDBC driver, which sends queries and other SQL statements to the IBM Informix database. The database sends query results to the JDBC driver, which sends them on to the Java application.

You can also use the time series Java classes in Java applets and servlets, as shown in the following figures.

Figure 2. Runtime architecture for a Java applet

The database server is connected to the JDBC driver, which is connected to the applet. The applet is also connected to a browser, which is connected to a web server that communicates with the database.

Figure 3. Runtime architecture for a Java servlet

A request from an application goes through a web server, an HTTP servlet subclass, and the JDBC driver to the database. The database sends responses back along the same path.

Summary of time series classes

The Java class library contains classes that you use to complete all necessary tasks for creating and managing time series. You can create time series objects with the Builder classes that are provided for each class. The following table lists the Java class that you need for each of the tasks in creating and managing a time series.

Table 1. Time series tasks and the corresponding Java classes
Tasks	Java classes
Create, query, and manage a custom type map for time series data types	`TimeSeriesTypeMap` `TimeSeriesTypeMap.Builder`
Create, query, and manage calendar patterns	`IfmxCalendarPattern` `IfmxCalendarPattern.Builder`
Create, query, and manage calendars	`IfmxCalendar` `IfmxCalendar.Builder`
Create, query, and manage containers	`TimeSeriesContainer` `TimeSeriesContainer.Builder`
Create, query, and manage TimeSeries row types	`TimeSeriesRowType` `TimeSeriesRowType.Builder`
Instantiate time series	`IfmxTimeSeries` `IfmxTimeSeries.Builder`
Query, insert, update, or delete time series data	`IfmxTimeSeries`