org.jruby.util.io

Class ChannelStream

java.lang.Object

org.jruby.util.io.ChannelStream

All Implemented Interfaces:

Finalizable, Stream

Deprecated.

@Deprecated
public class ChannelStream
extends java.lang.Object
implements Stream, Finalizable

This file implements a seekable IO file.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.nio.ByteBuffer	buffer Deprecated.
static int	BUFSIZE Deprecated. The size of the read/write buffer allocated for this stream.
protected ModeFlags	modes Deprecated.
protected boolean	reading Deprecated.
protected boolean	sync Deprecated.

Fields inherited from interface org.jruby.util.io.Stream

PARAGRAPH_DELIMETER, PARAGRAPH_SEPARATOR, SEEK_CUR, SEEK_END, SEEK_SET

Method Summary

Modifier and Type	Method and Description
int	bufferedAvailable() Deprecated.
void	checkPermissionsSubsetOf(ModeFlags subsetModes) Deprecated.
void	checkReadable() Deprecated.
void	checkWritable() Deprecated.
void	clearerr() Deprecated.
void	fclose() Deprecated. Closes IO handler resources.
static Stream	fdopen(Ruby runtime, ChannelDescriptor descriptor, ModeFlags modes) Deprecated.
static Stream	fdopen(Ruby runtime, ChannelDescriptor descriptor, ModeFlags modes, boolean autoclose) Deprecated.
boolean	feof() Deprecated. Return true when at end of file (EOF).
int	fflush() Deprecated.
int	fgetc() Deprecated.
long	fgetpos() Deprecated. Get the current position within the file associated with this handler.
ByteList	fgets(ByteList separatorString) Deprecated.
void	finalize() Deprecated. Ensure close (especially flush) when we're finished with.
static Stream	fopen(Ruby runtime, java.lang.String path, ModeFlags modes) Deprecated.
void	fputc(int c) Deprecated.
ByteList	fread(int number) Deprecated.
void	freopen(Ruby runtime, java.lang.String path, ModeFlags modes) Deprecated.
void	ftruncate(long newLength) Deprecated.
int	fwrite(ByteList string) Deprecated.
java.nio.ByteBuffer	getBuffer() Deprecated.
java.nio.channels.Channel	getChannel() Deprecated.
ChannelDescriptor	getDescriptor() Deprecated.
int	getline(ByteList dst, byte terminator) Deprecated. Read all bytes up to and including a terminator byte.
int	getline(ByteList dst, byte terminator, long limit) Deprecated. Reads all bytes up to and including a terminator byte or until limit is reached.
ModeFlags	getModes() Deprecated.
Ruby	getRuntime() Deprecated.
boolean	isAutoclose() Deprecated.
boolean	isBinmode() Deprecated.
boolean	isBlocking() Deprecated.
boolean	isSync() Deprecated.
void	lseek(long offset, int type) Deprecated. Implementation of libc "lseek", which seeks on seekable streams, raises EPIPE if the fd is assocated with a pipe, socket, or FIFO, and doesn't do anything for other cases (like stdio).
java.io.InputStream	newInputStream() Deprecated.
java.io.OutputStream	newOutputStream() Deprecated.
static Stream	open(Ruby runtime, ChannelDescriptor descriptor) Deprecated.
static Stream	open(Ruby runtime, ChannelDescriptor descriptor, boolean autoclose) Deprecated.
int	read() Deprecated.
int	read(java.nio.ByteBuffer dst) Deprecated.
int	read(java.nio.ByteBuffer dst, boolean partial) Deprecated.
ByteList	read(int number) Deprecated.
ByteList	readall() Deprecated. readall do busy loop for the IO which has NONBLOCK bit. You should implement the logic by yourself with fread().
boolean	readDataBuffered() Deprecated.
ByteList	readnonblock(int number) Deprecated.
ByteList	readpartial(int number) Deprecated.
int	ready() Deprecated. Implement IO#ready? as per io/wait in MRI.
int	refillBuffer() Deprecated.
void	setAutoclose(boolean autoclose) Deprecated.
void	setBinmode() Deprecated.
void	setBlocking(boolean block) Deprecated.
void	setModes(ModeFlags modes) Deprecated.
void	setSync(boolean sync) Deprecated.
void	sync() Deprecated. Flush and sync all writes to the filesystem.
int	ungetc(int c) Deprecated.
void	waitUntilReady() Deprecated. Implement IO#wait as per io/wait in MRI.
int	write(java.nio.ByteBuffer buf) Deprecated.
boolean	writeDataBuffered() Deprecated.
int	writenonblock(ByteList buf) Deprecated.

Methods inherited from class java.lang.Object

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

Field Detail

BUFSIZE

public static final int BUFSIZE

Deprecated.

The size of the read/write buffer allocated for this stream. This size has been scaled back from its original 16k because although the larger buffer size results in raw File.open times being rather slow (due to the cost of instantiating a relatively large buffer). We should try to find a happy medium, or potentially pool buffers, or perhaps even choose a value based on platform(??), but for now I am reducing it along with changes for the "large read" patch from JRUBY-2657.

See Also:

Constant Field Values

modes

protected ModeFlags modes

Deprecated.

sync

protected boolean sync

Deprecated.

buffer

protected volatile java.nio.ByteBuffer buffer

Deprecated.

reading

protected boolean reading

Deprecated.

Method Detail

getBuffer

public java.nio.ByteBuffer getBuffer()

Deprecated.

Specified by:

getBuffer in interface Stream

getRuntime

public Ruby getRuntime()

Deprecated.

checkReadable

public void checkReadable()
                   throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

checkWritable

public void checkWritable()
                   throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

checkPermissionsSubsetOf

public void checkPermissionsSubsetOf(ModeFlags subsetModes)

Deprecated.

getModes

public ModeFlags getModes()

Deprecated.

Specified by:

getModes in interface Stream

setModes

public void setModes(ModeFlags modes)

Deprecated.

Specified by:

setModes in interface Stream

isSync

public boolean isSync()

Deprecated.

Specified by:

isSync in interface Stream

setSync

public void setSync(boolean sync)

Deprecated.

Specified by:

setSync in interface Stream

setBinmode

public void setBinmode()

Deprecated.

Specified by:

setBinmode in interface Stream

isBinmode

public boolean isBinmode()

Deprecated.

Specified by:

isBinmode in interface Stream

isAutoclose

public boolean isAutoclose()

Deprecated.

Specified by:

isAutoclose in interface Stream

setAutoclose

public void setAutoclose(boolean autoclose)

Deprecated.

Specified by:

setAutoclose in interface Stream

waitUntilReady

public void waitUntilReady()
                    throws java.io.IOException,
                           java.lang.InterruptedException

Deprecated.

Implement IO#wait as per io/wait in MRI. waits until input available or timed out and returns self, or nil when EOF reached. The default implementation loops while ready returns 0.

Specified by:

waitUntilReady in interface Stream

Throws:

java.io.IOException

java.lang.InterruptedException

readDataBuffered

public final boolean readDataBuffered()

Deprecated.

Specified by:

readDataBuffered in interface Stream

writeDataBuffered

public final boolean writeDataBuffered()

Deprecated.

Specified by:

writeDataBuffered in interface Stream

bufferedAvailable

public final int bufferedAvailable()

Deprecated.

Specified by:

bufferedAvailable in interface Stream

refillBuffer

public final int refillBuffer()
                       throws java.io.IOException

Deprecated.

Specified by:

refillBuffer in interface Stream

Throws:

java.io.IOException

fgets

public ByteList fgets(ByteList separatorString)
               throws java.io.IOException,
                      BadDescriptorException

Deprecated.

Specified by:

fgets in interface Stream

Throws:

java.io.IOException

BadDescriptorException

getline

public int getline(ByteList dst,
                   byte terminator)
            throws java.io.IOException,
                   BadDescriptorException

Deprecated.

Description copied from interface: Stream

Read all bytes up to and including a terminator byte.

If the terminator byte is found, it will be the last byte in the output buffer.

Specified by:

getline in interface Stream

Parameters:

dst - The output buffer.

terminator - The byte to terminate reading.

Returns:

The number of bytes read, or -1 if EOF is reached.

Throws:

java.io.IOException

BadDescriptorException

getline

public int getline(ByteList dst,
                   byte terminator,
                   long limit)
            throws java.io.IOException,
                   BadDescriptorException

Deprecated.

Description copied from interface: Stream

Reads all bytes up to and including a terminator byte or until limit is reached.

If the terminator byte is found, it will be the last byte in the output buffer.

Specified by:

getline in interface Stream

Parameters:

dst - The output buffer.

terminator - The byte to terminate reading.

limit - the number of bytes to read unless EOF or terminator is found

Returns:

The number of bytes read, or -1 if EOF is reached.

Throws:

java.io.IOException

BadDescriptorException

readall

@Deprecated
public ByteList readall()
                             throws java.io.IOException,
                                    BadDescriptorException

Deprecated. readall do busy loop for the IO which has NONBLOCK bit. You should implement the logic by yourself with fread().

Specified by:

readall in interface Stream

Throws:

java.io.IOException

BadDescriptorException

fclose

public void fclose()
            throws java.io.IOException,
                   BadDescriptorException

Deprecated.

Closes IO handler resources.

Specified by:

fclose in interface Stream

Throws:

java.io.IOException

BadDescriptorException

fflush

public int fflush()
           throws java.io.IOException,
                  BadDescriptorException

Deprecated.

Specified by:

fflush in interface Stream

Throws:

java.io.IOException

BadDescriptorException

newInputStream

public java.io.InputStream newInputStream()

Deprecated.

Specified by:

newInputStream in interface Stream

newOutputStream

public java.io.OutputStream newOutputStream()

Deprecated.

Specified by:

newOutputStream in interface Stream

clearerr

public void clearerr()

Deprecated.

Specified by:

clearerr in interface Stream

feof

public boolean feof()
             throws java.io.IOException,
                    BadDescriptorException

Deprecated.

Description copied from interface: Stream

Return true when at end of file (EOF).

Specified by:

feof in interface Stream

Returns:

true if at EOF; false otherwise

Throws:

java.io.IOException

BadDescriptorException

fgetpos

public long fgetpos()
             throws java.io.IOException,
                    PipeException,
                    InvalidValueException,
                    BadDescriptorException

Deprecated.

Description copied from interface: Stream

Get the current position within the file associated with this handler.

Specified by:

fgetpos in interface Stream

Returns:

the current position in the file.

Throws:

java.io.IOException

PipeException - ESPIPE (illegal seek) when not a file

InvalidValueException

BadDescriptorException

lseek

public void lseek(long offset,
                  int type)
           throws java.io.IOException,
                  InvalidValueException,
                  PipeException,
                  BadDescriptorException

Deprecated.

Implementation of libc "lseek", which seeks on seekable streams, raises EPIPE if the fd is assocated with a pipe, socket, or FIFO, and doesn't do anything for other cases (like stdio).

Specified by:

lseek in interface Stream

Throws:

java.io.IOException

InvalidValueException

PipeException

BadDescriptorException

sync

public void sync()
          throws java.io.IOException,
                 BadDescriptorException

Deprecated.

Description copied from interface: Stream

Flush and sync all writes to the filesystem.

Specified by:

sync in interface Stream

Throws:

java.io.IOException - if the sync does not work

BadDescriptorException

read

public ByteList read(int number)
              throws java.io.IOException,
                     BadDescriptorException

Deprecated.

Specified by:

read in interface Stream

Throws:

java.io.IOException

BadDescriptorException

ftruncate

public void ftruncate(long newLength)
               throws java.io.IOException,
                      BadDescriptorException,
                      InvalidValueException

Deprecated.

Specified by:

ftruncate in interface Stream

Throws:

java.io.IOException

BadDescriptorException

InvalidValueException

finalize

public void finalize()
              throws java.lang.Throwable

Deprecated.

Ensure close (especially flush) when we're finished with.

Specified by:

finalize in interface Finalizable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

ready

public int ready()
          throws java.io.IOException

Deprecated.

Description copied from interface: Stream

Implement IO#ready? as per io/wait in MRI. returns non-nil if input available without blocking, or nil.

Specified by:

ready in interface Stream

Throws:

java.io.IOException

fputc

public void fputc(int c)
           throws java.io.IOException,
                  BadDescriptorException

Deprecated.

Specified by:

fputc in interface Stream

Throws:

java.io.IOException

BadDescriptorException

ungetc

public int ungetc(int c)

Deprecated.

Specified by:

ungetc in interface Stream

fgetc

public int fgetc()
          throws java.io.IOException,
                 BadDescriptorException

Deprecated.

Specified by:

fgetc in interface Stream

Throws:

java.io.IOException

BadDescriptorException

fwrite

public int fwrite(ByteList string)
           throws java.io.IOException,
                  BadDescriptorException

Deprecated.

Specified by:

fwrite in interface Stream

Throws:

java.io.IOException

BadDescriptorException

write

public int write(java.nio.ByteBuffer buf)
          throws java.io.IOException,
                 BadDescriptorException

Deprecated.

Throws:

java.io.IOException

BadDescriptorException

writenonblock

public int writenonblock(ByteList buf)
                  throws java.io.IOException,
                         BadDescriptorException

Deprecated.

Throws:

java.io.IOException

BadDescriptorException

fread

public ByteList fread(int number)
               throws java.io.IOException,
                      BadDescriptorException

Deprecated.

Specified by:

fread in interface Stream

Throws:

java.io.IOException

BadDescriptorException

readnonblock

public ByteList readnonblock(int number)
                      throws java.io.IOException,
                             BadDescriptorException,
                             java.io.EOFException

Deprecated.

Throws:

java.io.IOException

BadDescriptorException

java.io.EOFException

readpartial

public ByteList readpartial(int number)
                     throws java.io.IOException,
                            BadDescriptorException,
                            java.io.EOFException

Deprecated.

Throws:

java.io.IOException

BadDescriptorException

java.io.EOFException

read

public int read(java.nio.ByteBuffer dst)
         throws java.io.IOException,
                BadDescriptorException,
                java.io.EOFException

Deprecated.

Throws:

java.io.IOException

BadDescriptorException

java.io.EOFException

read

public int read(java.nio.ByteBuffer dst,
                boolean partial)
         throws java.io.IOException,
                BadDescriptorException,
                java.io.EOFException

Deprecated.

Throws:

java.io.IOException

BadDescriptorException

java.io.EOFException

read

public int read()
         throws java.io.IOException,
                BadDescriptorException

Deprecated.

Throws:

java.io.IOException

BadDescriptorException

getDescriptor

public ChannelDescriptor getDescriptor()

Deprecated.

Specified by:

getDescriptor in interface Stream

setBlocking

public void setBlocking(boolean block)
                 throws java.io.IOException

Deprecated.

Specified by:

setBlocking in interface Stream

Throws:

java.io.IOException

isBlocking

public boolean isBlocking()

Deprecated.

Specified by:

isBlocking in interface Stream

freopen

public void freopen(Ruby runtime,
                    java.lang.String path,
                    ModeFlags modes)
             throws DirectoryAsFileException,
                    java.io.IOException,
                    InvalidValueException,
                    PipeException,
                    BadDescriptorException

Deprecated.

Specified by:

freopen in interface Stream

Throws:

DirectoryAsFileException

java.io.IOException

InvalidValueException

PipeException

BadDescriptorException

open

public static Stream open(Ruby runtime,
                          ChannelDescriptor descriptor)

Deprecated.

fdopen

public static Stream fdopen(Ruby runtime,
                            ChannelDescriptor descriptor,
                            ModeFlags modes)
                     throws InvalidValueException

Deprecated.

Throws:

InvalidValueException

open

public static Stream open(Ruby runtime,
                          ChannelDescriptor descriptor,
                          boolean autoclose)

Deprecated.

fdopen

public static Stream fdopen(Ruby runtime,
                            ChannelDescriptor descriptor,
                            ModeFlags modes,
                            boolean autoclose)
                     throws InvalidValueException

Deprecated.

Throws:

InvalidValueException

fopen

@Deprecated
public static Stream fopen(Ruby runtime,
                                       java.lang.String path,
                                       ModeFlags modes)
                                throws java.io.FileNotFoundException,
                                       DirectoryAsFileException,
                                       FileExistsException,
                                       java.io.IOException,
                                       InvalidValueException,
                                       PipeException,
                                       BadDescriptorException

Deprecated.

Throws:

java.io.FileNotFoundException

DirectoryAsFileException

FileExistsException

java.io.IOException

InvalidValueException

PipeException

BadDescriptorException

getChannel

public java.nio.channels.Channel getChannel()

Deprecated.

Specified by:

getChannel in interface Stream