alluxio.underfs.cos

Class COSOutputStream

java.lang.Object

java.io.OutputStream

alluxio.underfs.cos.COSOutputStream

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

@NotThreadSafe
public final class COSOutputStream
extends java.io.OutputStream

A stream for writing a file into COS. The data will be persisted to a temporary directory on the local disk and copied as a complete file when the close() method is called.

Constructor Summary

Constructors

Constructor and Description
COSOutputStream(java.lang.String bucketName, java.lang.String key, com.qcloud.cos.COSClient client, java.util.List<java.lang.String> tmpDirs) Creates a name instance of COSOutputStream.

Method Summary

Modifier and Type	Method and Description
void	close() Closes this output stream.
void	flush() Flushes this output stream and forces any buffered output bytes to be written out.
void	write(byte[] b) Writes the given byte array to this output stream.
void	write(byte[] b, int off, int len) Writes the given number of bytes from the given byte array starting at the given offset to this output stream.
void	write(int b) Writes the given bytes to this output stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

COSOutputStream

public COSOutputStream(java.lang.String bucketName,
                       java.lang.String key,
                       com.qcloud.cos.COSClient client,
                       java.util.List<java.lang.String> tmpDirs)
                throws java.io.IOException

Creates a name instance of COSOutputStream.

Parameters:

bucketName - the name of the bucket

key - the key of the file

client - the client for COS

tmpDirs - a list of possible temporary directories

Throws:

java.io.IOException

Method Detail

write

public void write(int b)
           throws java.io.IOException

Writes the given bytes to this output stream. Before close, the bytes are all written to local file.

Specified by:

write in class java.io.OutputStream

Parameters:

b - the bytes to write

Throws:

java.io.IOException

write

public void write(byte[] b)
           throws java.io.IOException

Writes the given byte array to this output stream. Before close, the bytes are all written to local file.

Overrides:

write in class java.io.OutputStream

Parameters:

b - the byte array

Throws:

java.io.IOException

write

public void write(byte[] b,
                  int off,
                  int len)
           throws java.io.IOException

Writes the given number of bytes from the given byte array starting at the given offset to this output stream. Before close, the bytes are all written to local file.

Overrides:

write in class java.io.OutputStream

Parameters:

b - the byte array

off - the start offset in the data

len - the number of bytes to write

Throws:

java.io.IOException

flush

public void flush()
           throws java.io.IOException

Flushes this output stream and forces any buffered output bytes to be written out. Before close, the data are flushed to local file.

Specified by:

flush in interface java.io.Flushable

Overrides:

flush in class java.io.OutputStream

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Closes this output stream. When an output stream is closed, the local temporary file is uploaded to COS Service. Once the file is uploaded, the temporary file is deleted.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.OutputStream

Throws:

java.io.IOException