BlobOutputStream (Microsoft Windows Azure Client API 0.4.6 API)

java.lang.Object
- java.io.OutputStream
- - com.microsoft.windowsazure.services.blob.client.BlobOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable
```
public final class BlobOutputStream
extends OutputStream
```
The class is an append-only stream for writing into storage.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`BlobOutputStream(CloudBlob parentBlob, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)` Initializes a new instance of the BlobWriteStream class.
`protected`	`BlobOutputStream(CloudBlockBlob parentBlob, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)` Initializes a new instance of the BlobWriteStream class for a CloudBlockBlob
`protected`	`BlobOutputStream(CloudPageBlob parentBlob, long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)` Initializes a new instance of the BlobWriteStream class for a CloudPageBlob

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`close()` Closes this output stream and releases any system resources associated with this stream.
`void`	`flush()` Flushes this output stream and forces any buffered output bytes to be written out.
`void`	`write(byte[] data)` Writes b.length bytes from the specified byte array to this output stream.
`void`	`write(byte[] data, int offset, int length)` Writes length bytes from the specified byte array starting at offset to this output stream.
`void`	`write(InputStream sourceStream, long writeLength)` Writes all data from the InputStream to the Blob.
`void`	`write(int byteVal)` Writes the specified byte to this output stream.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - BlobOutputStream
```
protected BlobOutputStream(CloudBlob parentBlob,
                AccessCondition accessCondition,
                BlobRequestOptions options,
                OperationContext opContext)
                    throws StorageException
```
    Initializes a new instance of the BlobWriteStream class.
    
    Parameters:
    parentBlob - the blob that this stream is associated with.
    accessCondition - An AccessCondition object that represents the access conditions for the blob.
    options - An object that specifies any additional options for the request
    opContext - an object used to track the execution of the operation
    
    Throws:
    
    StorageException - an exception representing any error which occurred during the operation.
  - BlobOutputStream
```
protected BlobOutputStream(CloudBlockBlob parentBlob,
                AccessCondition accessCondition,
                BlobRequestOptions options,
                OperationContext opContext)
                    throws StorageException
```
    Initializes a new instance of the BlobWriteStream class for a CloudBlockBlob
    
    Parameters:
    parentBlob - the blob that this stream is associated with.
    accessCondition - An AccessCondition object that represents the access conditions for the blob.
    options - An object that specifies any additional options for the request
    opContext - an object used to track the execution of the operation
    
    Throws:
    
    StorageException - an exception representing any error which occurred during the operation.
  - BlobOutputStream
```
@DoesServiceRequest
protected BlobOutputStream(CloudPageBlob parentBlob,
                                   long length,
                                   AccessCondition accessCondition,
                                   BlobRequestOptions options,
                                   OperationContext opContext)
                    throws StorageException
```
    Initializes a new instance of the BlobWriteStream class for a CloudPageBlob
    
    Parameters:
    parentBlob - the blob that this stream is associated with.
    length - the length of the page blob in bytes, must be a multiple of 512.
    accessCondition - An AccessCondition object that represents the access conditions for the blob.
    options - An object that specifies any additional options for the request
    opContext - an object used to track the execution of the operation
    
    Throws:
    
    StorageException - an exception representing any error which occurred during the operation.
- Method Detail
  - close
```
@DoesServiceRequest
public void close()
           throws IOException
```
    Closes this output stream and releases any system resources associated with this stream. If any data remains in the buffer it is committed to the service.
    
    Specified by:
    
    close in interface Closeable
    
    Specified by:
    
    close in interface AutoCloseable
    
    Overrides:
    
    close in class OutputStream
    
    Throws:
    
    IOException
  - flush
```
@DoesServiceRequest
public void flush()
           throws IOException
```
    Flushes this output stream and forces any buffered output bytes to be written out. If any data remains in the buffer it is committed to the service.
    
    Specified by:
    
    flush in interface Flushable
    
    Overrides:
    
    flush in class OutputStream
    
    Throws:
    
    IOException
  - write
```
@DoesServiceRequest
public void write(byte[] data)
           throws IOException
```
    Writes b.length bytes from the specified byte array to this output stream.
    
    Overrides:
    
    write in class OutputStream
    
    Parameters:
    data - the byte array to write.
    
    Throws:
    
    IOException - if an I/O error occurs. In particular, an IOException may be thrown if the output stream has been closed.
  - write
```
@DoesServiceRequest
public void write(byte[] data,
                            int offset,
                            int length)
           throws IOException
```
    Writes length bytes from the specified byte array starting at offset to this output stream.
    
    Overrides:
    
    write in class OutputStream
    
    Parameters:
    data - the byte array to write.
    offset - the start offset in the data.
    length - the number of bytes to write.
    
    Throws:
    
    IOException - if an I/O error occurs. In particular, an IOException may be thrown if the output stream has been closed.
  - write
```
@DoesServiceRequest
public void write(InputStream sourceStream,
                            long writeLength)
           throws IOException,
                  StorageException
```
    Writes all data from the InputStream to the Blob.
    
    Parameters:
    sourceStream - the InputStram to consume.
    
    Throws:
    
    IOException - if an I/O error occurs. In particular, an IOException may be thrown if the output stream has been closed.
    
    StorageException
  - write
```
public void write(int byteVal)
           throws IOException
```
    Writes the specified byte to this output stream. The general contract for write is that one byte is written to the output stream. The byte to be written is the eight low-order bits of the argument b. The 24 high-order bits of b are ignored.
    
    Specified by:
    
    write in class OutputStream
    
    Parameters:
    byteVal - the byteValue to write.
    
    Throws:
    
    IOException - if an I/O error occurs. In particular, an IOException may be thrown if the output stream has been closed.

/** 
* Copyright Microsoft Corporation 
* 
* Licensed under the Apache License, Version 2.0 (the "License"); 
* you may not use this file except in compliance with the License. 
* You may obtain a copy of the License at 
* http://www.apache.org/licenses/LICENSE-2.0 
* 
* Unless required by applicable law or agreed to in writing, software 
* distributed under the License is distributed on an "AS IS" BASIS, 
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
* See the License for the specific language governing permissions and 
* limitations under the License. 
*/

Class BlobOutputStream

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

BlobOutputStream

BlobOutputStream

BlobOutputStream

Method Detail

close

flush

write

write

write

write