Package com.martiansoftware.nailgun

Class NGOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.DataOutputStream

com.martiansoftware.nailgun.NGOutputStream

All Implemented Interfaces:

Closeable, DataOutput, Flushable, AutoCloseable

class NGOutputStream
extends DataOutputStream

Wraps an OutputStream to send writes in NailGun chunks. Because multiple NGOutputStreams wrap the same OutputStream (that is, the OutputStream obtained from the Socket connection with the client), writes are synchronized on the underlying OutputStream. If this were not the case, write interleaving could completely break the NailGun protocol.

Field Summary

Fields

Modifier and Type	Field	Description
private final Object	lock
private byte	streamCode

Fields inherited from class java.io.DataOutputStream

written

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

Constructors

Constructor	Description
NGOutputStream(OutputStream out, byte streamCode)	Creates a new NGOutputStream wrapping the specified OutputStream and using the specified Nailgun chunk code.

Method Summary

Modifier and Type	Method	Description
void	write(byte[] b)
void	write(byte[] b, int offset, int len)
void	write(int b)

Methods inherited from class java.io.DataOutputStream

flush, size, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeDouble, writeFloat, writeInt, writeLong, writeShort, writeUTF

Methods inherited from class java.io.FilterOutputStream

close

Methods inherited from class java.io.OutputStream

nullOutputStream

Methods inherited from class java.lang.Object

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

Field Details

lock

private final Object lock

streamCode

private byte streamCode

Constructor Details

NGOutputStream

public NGOutputStream(OutputStream out,
 byte streamCode)

Creates a new NGOutputStream wrapping the specified OutputStream and using the specified Nailgun chunk code.

Parameters:

out - the OutputStream to wrap

streamCode - the NailGun chunk code associated with this stream (i.e., '1' for stdout, '2' for stderr).

Method Details

write

public void write(byte[] b)
           throws IOException

Specified by:

write in interface DataOutput

Overrides:

write in class FilterOutputStream

Throws:

IOException

write

public void write(int b)
           throws IOException

Specified by:

write in interface DataOutput

Overrides:

write in class DataOutputStream

Throws:

IOException

write

public void write(byte[] b,
 int offset,
 int len)
           throws IOException

Specified by:

write in interface DataOutput

Overrides:

write in class DataOutputStream

Throws:

IOException