src.com.ibm.as400.access.AS400JDBCWriter Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of jt400 Show documentation
The Open Source version of the IBM Toolbox for Java
There is a newer version: 20.0.7
///////////////////////////////////////////////////////////////////////////////
//                                                                             
// JTOpen (IBM Toolbox for Java - OSS version)                                 
//                                                                             
// Filename: AS400JDBCWriter.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-2010 International Business Machines Corporation and     
// others. All rights reserved.                                                
//                                                                             
///////////////////////////////////////////////////////////////////////////////

package com.ibm.as400.access;

import java.io.IOException;
import java.io.Writer;
import java.sql.SQLException;


/**
The AS400JDBCWriter class provides a stream
to write into large objects.  The data is valid only within the current
transaction.  Users get one of these objects by calling Clob.setCharacterStream()
which returns an object of type Writer.
**/
class AS400JDBCWriter extends Writer
{
  static final String copyright = "Copyright (C) 1997-2003 International Business Machines Corporation and others.";


  private boolean closed_ = false;   // is the stream closed?
  private long position_;      // position from which the user wanted us to start writing
  private AS400JDBCClob clob_; // We have separate vars for clob and locator to remove build dependency on JDBC 3.0.
  private AS400JDBCClobLocator locator_;
  private AS400JDBCSQLXML xml_; //@pda jdbc40


  AS400JDBCWriter(AS400JDBCClob clob, long positionToStartWriting) 
  {
    clob_ = clob;
    position_ = positionToStartWriting;
  }


  AS400JDBCWriter(AS400JDBCClobLocator locator, long positionToStartWriting) 
  {
    locator_ = locator;
    position_ = positionToStartWriting;
  }
  
  //@pda jdbc40
  AS400JDBCWriter(AS400JDBCSQLXML xml, long positionToStartWriting) 
  {
    xml_ = xml;
    position_ = positionToStartWriting;
  }




  /*
  Close the writer.
  */
  public void close()
  {
    closed_ = true;
  }


  /*
  Flush the writer.
  */
  public void flush()
  {
    //no-op
  }



  /*
  Write a character array to the writer.
  
  @param cbuf The character byte array the user wants written to the writer.
  */
  public void write(char[] cbuf) throws IOException
  {
    if (cbuf == null) throw new NullPointerException("cbuf");

    if (closed_) throw new ExtendedIOException(ExtendedIOException.RESOURCE_NOT_AVAILABLE);

    write(cbuf, 0, cbuf.length);
  }



  /*
  Write a character array to the writer from offset off for len characters.

  @param cbuf      The character array the user wants written to the writer.
  @param off       The offset into the character array that the user wants written to the 
                   writer (1-based).
  @param len       The number of bytes the user wants written to the writer
                   from the byte array they passed in.  
  */
  public void write(char[] cbuf, int off, int len) throws IOException
  {
    if (cbuf == null) throw new NullPointerException("cbuf");
    if ((off < 0) || (off > len)) throw new ExtendedIllegalArgumentException("off", ExtendedIllegalArgumentException.PARAMETER_VALUE_NOT_VALID);
    if (len < 0) throw new ExtendedIllegalArgumentException("len", ExtendedIllegalArgumentException.PARAMETER_VALUE_NOT_VALID);

    if (closed_) throw new ExtendedIOException(ExtendedIOException.RESOURCE_NOT_AVAILABLE);

    write(new String(cbuf, off, len));
  }



  /*
  Write a character to the writer.

  @param cbuf      The character the user wants written to the writer.
  */
  public void write(int c) throws IOException
  {
    if (closed_) throw new ExtendedIOException(ExtendedIOException.RESOURCE_NOT_AVAILABLE);

    write(new String(new char[] { (char)c}));
  }



  /*
  Write a String to the writer from offset off for len characters.

  @param str       The string the user wants written to the writer.
  */
  public void write(String str) throws IOException
  {
    if (str == null) throw new NullPointerException("str");

    if (closed_) throw new ExtendedIOException(ExtendedIOException.RESOURCE_NOT_AVAILABLE);

    write(str, 0, str.length());
  }



  /*
  Write a String to the writer from offset off for len characters.

  @param str       The String the user wants written to the writer.
  @param off       The offset into the character array that the user wants written to the 
                   writer.
  @param len       The number of bytes the user wants written to the writer
                   from the byte array they passed in.  
  */
  public synchronized void write(String str, int off, int len) throws IOException
  {
    if (str == null) throw new NullPointerException("str");
    if ((off < 0) || (off > len)) throw new ExtendedIllegalArgumentException("off", ExtendedIllegalArgumentException.PARAMETER_VALUE_NOT_VALID);
    if (len < 0) throw new ExtendedIllegalArgumentException("len", ExtendedIllegalArgumentException.PARAMETER_VALUE_NOT_VALID);

    if (closed_) throw new ExtendedIOException(ExtendedIOException.RESOURCE_NOT_AVAILABLE);

    try
    {
      if (clob_ != null) clob_.setString(position_, str, off, len);
      else if (locator_ != null) locator_.setString(position_, str, off, len); //@PDC jdbc40
      else if (xml_ != null ) xml_.setString(position_, str, off, len); //@PDA jdbc40
      position_ += len;
    }
    catch (SQLException e)
    {
      if (JDTrace.isTraceOn()) {
        JDTrace.logException(this, "Exception caught", e); 
      }
      closed_ = true;
      IOException throwException = new IOException(e.getMessage());
      try {
        throwException.initCause(e); 
      } catch (Throwable t) {} 
      throw throwException;
    }
  }
}