FileDocCategorySizeDatePackage
LocalServerSocket.javaAPI DocAndroid 1.5 API3232Wed May 06 22:41:54 BST 2009android.net

LocalServerSocket

public class LocalServerSocket extends Object
non-standard class for creating inbound UNIX-domain socket on the Android platform, this is created in the Linux non-filesystem namespace. On simulator platforms, this may be created in a temporary directory on the filesystem

Fields Summary
private final LocalSocketImpl
impl
private final LocalSocketAddress
localAddress
private static final int
LISTEN_BACKLOG
50 seems a bit much, but it's what was here
Constructors Summary
public LocalServerSocket(String name)
Crewates 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).

param
name address for socket
throws
IOException


                                            
        
    
        impl = new LocalSocketImpl();

        impl.create(true);

        localAddress = new LocalSocketAddress(name);
        impl.bind(localAddress);

        impl.listen(LISTEN_BACKLOG);
    
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

param
fd bound file descriptor
throws
IOException

        impl = new LocalSocketImpl(fd);
        impl.listen(LISTEN_BACKLOG);
        localAddress = impl.getSockAddress();
    
Methods Summary
public LocalSocketaccept()
Accepts a new connection to the socket. Blocks until a new connection arrives.

return
a socket representing the new connection.
throws
IOException

        LocalSocketImpl acceptedImpl = new LocalSocketImpl();

        impl.accept (acceptedImpl);

        return new LocalSocket(acceptedImpl);
    
public voidclose()
Closes server socket.

throws
IOException

        impl.close();
    
public java.io.FileDescriptorgetFileDescriptor()
Returns file descriptor or null if not yet open/already closed

return
fd or null

        return impl.getFileDescriptor();
    
public LocalSocketAddressgetLocalSocketAddress()
Obtains the socket's local address

return
local address

        return localAddress;