在流模式下，OceanBase Connector/J 一般不会从网络读取 LONG 或 LONG RAW 列的数据。在使用代码调用 getXXX 方法读取列数据之前，列数据将保留在网络通信通道中。除了读取列数据外，任何连接使用都会将列数据从通道中丢弃。虽然流模式可以有效利用内存并最大程度地减少往返通信，但它会干扰其他数据库操作。

要访问 LONG 列中的数据，您可以将该列作为 Java InputStream 对象，并使用 InputStream 对象的 read 方法获取。也可以将数据作为 String 或 byte 数组，通过执行流传输获取。

三种流类型都可以获取 LONG 和 LONG RAW 数据。驱动程序将根据数据库和驱动程序的字符集进行执行转换。

LONG RAW 数据转换

调用 getBinaryStream 返回 RAW 数据。调用 getAsciiStream 会将 RAW 数据转换为十六进制并返回相应的 ASCII。调用 getUnicodeStream 会将 RAW 数据转换为十六进制并返回 Unicode 字符。

LONG 数据转换

使用 getAsciiStream 获取 LONG 数据时，驱动程序会假定数据库中的基础数据使用 US7ASCII 或 WE8ISO8859P1 字符集。如果假设为真，则驱动程序将返回与 ASCII 字符相对应的字节。如果数据库未使用 US7ASCII 或 WE8ISO8859P1 字符集，则调用 getAsciiStream 将返回无意义的信息。

使用 getUnicodeStream 获取 LONG 数据时，将获得 UTF-16 编码的 Unicode 字符流。

使用 getBinaryStream 获取 LONG 数据时，如果数据库字符集不是 US7ASCII 或 WE8ISO8859P1，则调用 getBinaryStream 将返回 UTF-8。如果服务器端字符集是 US7ASCII 或 WE8ISO8859P1，则调用将返回 US7ASCII 字节流。

示例

getXXXStream 方法的功能之一是能够以增量方式获取数据，而 getBytes 在一次调用中就获取所有数据。以下是获取二进制数据流的示例。

示例 1：使用 getBinaryStream 方法获取 LONG RAW 数据

1. 创建表 stream01，存储与名称 SAMPLE 相关的 LONG RAW 数据列。

   CREATE TABLE stream01 (name VARCHAR2 (50), giftype LONG RAW);
   INSERT INTO stream01 VALUES ('SAMPLE', '1234567890123');

2. 将 LONG RAW 列中的数据写入名为 sample.gif 的文件中。

   ResultSet rs = st.executeQuery 
                    ("select giftype from stream01 where NAME='SAMPLE'");

3. 使用 getBinaryStream 方法获取 LONG RAW 数据。

   // 获取第一行
   if (rs.next())
   {
       // 以流形式获取 GIF 数据
       InputStream gif_type = rs.getBinaryStream (1);
      try
      {
         FileOutputStream file = null;
         file = new FileOutputStream ("sample.gif");
         int chunk;
         while ((chunk = gif_type.read()) != -1)
            file.write(chunk);
      }
      catch (Exception e)
      {
         String err = e.toString();
         System.out.println(err);
      }
      finally
      {
         if file != null()
            file.close();
      }
   } 

上述示例中，调用 getBinaryStream 返回的 InputStream 对象直接从数据库连接中读取数据。

示例 2：使用 getBytes 方法获取 LONG RAW 数据

本示例使用 getBytes 获取 giftype 列的内容，驱动程序将在一次调用中获取所有数据，并将其存储在字节数组中。

ResultSet rs2 = st.executeQuery 
                  ("select giftype from streame01 where NAME='SAMPLE'"); 

// 获取第一行
if (rs2.next())
{
   // 以流形式获取 GIF 数据
   byte[] bytes = rs2.getBytes(1);
   try
   {
      FileOutputStream file = null;
      file = new FileOutputStream ("sample2.gif");
      file.write(bytes);
   }
   catch (Exception e)
   {
      String err = e.toString();
      System.out.println(err);
   }
   finally
   {
      if file != null()
         file.close();
   }
}

因为 LONG RAW 列最多可以包含 2 GB 的数据，所以与 getBinaryStream 示例相比，getBytes 示例可以使用更多的内存。如果不知道 LONG 或 LONG RAW 列中数据的最大大小，请使用流。