Package systextil.dao.reader

Interface DataReader

All Superinterfaces:
AutoCloseable
All Known Implementing Classes:
OracleDataReader
public interface DataReader extends AutoCloseable
Artifício para ler objetos com dados de todos os registros de uma consulta.

ATENÇÃO! O uso deste objeto é precário. Não existe garantia de que o cursor embutido será fechado depois de usado.

Se o último registro for lido, e for tentado ler mais um registro, então o cursor será fechado automaticamente.

Por causa disso, o uso de loops while(next() != null) é mais ou menos seguro.

Em outras situações, é importante garantir o fechamento deste objeto manualmente ou usá-lo dentro de um bloco try-with-resources.

Existe somente uma implementação desta interface, OracleDataReader, que na verdade é um leitor de AppConnection.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    close()
    Fecha o cursor embutido.
    <T> T
    next()
    Lê o próximo registro.

  • Method Details

    • next

      <T> T next()
      Lê o próximo registro.

      Se não existir próximo registro, fecha o cursor automaticamente.

      Type Parameters:
      T - o tipo de dado a retornar
      Returns:
      o dado lido a partir do registro, ou nulo se não houver próximo registro.

    • close

      void close()
      Fecha o cursor embutido.

      É chamado automaticamente se o método next() retornar nulo.

      Specified by:
      close in interface AutoCloseable