Using NGStreams

NGStreams is a library somewhat comparable to the java.io package. It contains various "stream" classes for accessing network sockets, local files or data objects in a "streaming fashion"

Introduction

This library contains Objective-C classes to access files and network sockets using a java.io like streaming mechanism. It also abstracts the Unix socket API (that is, we have extensible classes for socket domains, addresses etc)

Notable Features

Nonblocking IO

Support for libFoundation runloop

Extensible socket() support

Structured error objects

Separation of data and text (unicode) streams

Does explicitly not use thread-locks (use NGLockingStream for that)

Support for datagram (UDP) sockets

Defaults

  ProfileByteBufferEnabled = NO;

Protocols

  NGSerializer
  NGActiveSocket
  NGPositionableStream
  NGDatagramPacket
  NGSocketAddress
  NGSocketDomain

Class Hierarchy

  NSObject
    NGStream < NGStream, NGByteSequenceStream > (serialization) <NGSerializer>
      NGFileStream          < NGPositionableStream >
      NGDataStream          < NGPositionableStream >
      NGTaskStream
      NGFilterStream
        NGBase64Stream
        NGBufferedStream
        NGByteBuffer
        NGByteCountStream
        NGLockingStream
    NGSocket                < NGSocket >
      NGActiveSocket        < NGActiveSocket > (serialization) < NGSerializer >
      NGPassiveSocket       < NGPassiveSocket >
      NGDatagramSocket
    NGTextStream            < NGExtendedTextStream >
      NGStringTextStream
      NGCTextStream
      NGFilterTextStream
        NGCharBuffer
    NGDatagramPacket        < NGDatagramPacket >
    NGInternetSocketAddress < NSCopying, NSCoding, NGSocketAddress >
    NGInternetSocketDomain  < NSCoding, NSCopying, NGSocketDomain >
    NGLocalSocketAddress    < NSCopying, NGSocketAddress >
    NGLocalSocketDomain     < NSCopying, NSCoding, NGSocketDomain >
    NSFileHandle
      NGConcreteStreamFileHandle
    NSCoder
      NGStreamCoder         < NSObjCTypeSerializationCallBack >
    NSPipe
      NGStreamPipe          < NGStream, NGByteSequenceStream >

Exceptions

  NSException
    NGIOException
      NGStreamException
        NGEndOfStreamException
          NGSocketShutdownException
            NGSocketShutdownDuringReadException
            NGSocketShutdownDuringWriteException
            NGSocketTimedOutException
            NGSocketConnectionResetException
        NGCouldNotOpenStreamException
        NGCouldNotCloseStreamException
        NGStreamNotOpenException
        NGStreamErrorException
          NGStreamReadErrorException
          NGStreamWriteErrorException
          NGStreamSeekErrorException
        NGStreamModeException
          NGUnknownStreamModeException
          NGReadOnlyStreamException
          NGWriteOnlyStreamException
      NGIOAccessException
        NGIOSearchAccessException
      NGSocketException
        NGCouldNotResolveHostNameException
        NGDidNotFindServiceException
        NGInvalidSocketDomainException
        NGCouldNotCreateSocketException
        NGSocketBindException
          NGSocketAlreadyBoundException
          NGCouldNotBindSocketException
        NGSocketConnectException
          NGSocketNotConnectedException
          NGSocketAlreadyConnectedException
          NGCouldNotConnectException
        NGSocketIsAlreadyListeningException
        NGCouldNotListenException
        NGCouldNotAcceptException
        NGSocketOptionException
          NGCouldNotSetSocketOptionException
          NGCouldNotGetSocketOptionException