Added in API level 1

LocalServerSocket


public class LocalServerSocket
extends Object implements Closeable

java.lang.Object
   ↳ android.net.LocalServerSocket


Non-standard class for creating an inbound UNIX-domain socket in the Linux abstract namespace.

Summary

Public constructors

LocalServerSocket(String name)

Creates a new server socket listening at specified name.

LocalServerSocket(FileDescriptor fd)

Create a LocalServerSocket from a file descriptor that's already been created and bound.

Public methods

LocalSocket accept()

Accepts a new connection to the socket.

void close()

Closes server socket.

FileDescriptor getFileDescriptor()

Returns file descriptor or null if not yet open/already closed

LocalSocketAddress getLocalSocketAddress()

Obtains the socket's local address

Inherited methods

Public constructors

LocalServerSocket

Added in API level 1
public LocalServerSocket (String name)

Creates a new server socket listening at specified name. On the Android platform, the name is created in the Linux abstract namespace (instead of on the filesystem).

Parameters
name String: address for socket

Throws
java.io.IOException
IOException

LocalServerSocket

Added in API level 1
public LocalServerSocket (FileDescriptor fd)

Create a LocalServerSocket from a file descriptor that's already been created and bound. listen() will be called immediately on it. Used for cases where file descriptors are passed in via environment variables. The passed-in FileDescriptor is not managed by this class and must be closed by the caller. Calling close() on a socket created by this method has no effect.

Parameters
fd FileDescriptor: bound file descriptor

Throws
java.io.IOException
IOException

Public methods

accept

Added in API level 1
public LocalSocket accept ()

Accepts a new connection to the socket. Blocks until a new connection arrives.

Returns
LocalSocket a socket representing the new connection.

Throws
java.io.IOException
IOException

close

Added in API level 1
public void close ()

Closes server socket.

Throws
java.io.IOException
IOException

getFileDescriptor

Added in API level 1
public FileDescriptor getFileDescriptor ()

Returns file descriptor or null if not yet open/already closed

Returns
FileDescriptor fd or null

getLocalSocketAddress

Added in API level 1
public LocalSocketAddress getLocalSocketAddress ()

Obtains the socket's local address

Returns
LocalSocketAddress local address