Question

LocalSocket

版本：Android 4.0 r1

结构

继承关系

public class LocalSocket extends Object

java.lang.Object

android.net.LocalSocket

类概述

在 UNIX 域名空间内创建一个 socket（非服务器），这种类型的 socket 完全不同于 java.net.socket。

构造函数

public LocalSocket ()

创建一个 AF_LOCAL/UNIX 套接字。

公共方法

public void bind (LocalSocketAddress bindpoint)

绑定 socket 到一个端口。仅可由还没有被绑定的实体对象来调用该方法。​

参数

bindpoint 端口地址

异常

IOException

public void close ()

关闭 socket

异常

IOException

public void connect (LocalSocketAddress endpoint)

将当前 socket 连接到一个端口，只有当终端地址还没有被连接的情况下才能调用该函数。​

参数

endpoint 端口地址

异常

IOException 如果 socket 是无效的或地址不存在。

public void connect (LocalSocketAddress endpoint, int timeout)

将当前 socket 连接到一个端口。

异常

IOException 如果 socket 是无效的或地址不存在。

public FileDescriptor[] getAncillaryFileDescriptors ()

​​获取一组由对端通过附加消息传送过来的文件描述符。这个方法会返回最近发送的文件描述符，并且返回空直到收到一个新的描述符。文件描述符仅可以通过常规数据传送，此方法读取一个描述符后仅能返回非空值。

返回值

空或者文件描符数组

异常

IOException

public FileDescriptor getFileDescriptor ()

返回文件描述符，如果文件没有打开或已关闭则返回空。​

返回值

文件描述符或空​值

public InputStream getInputStream ()

获取输入流。

​返回值​

input stream 对象

异常

若 socket 已经关闭或者还没建立则抛出 IO 异常

​

public LocalSocketAddress getLocalSocketAddress ()

若存在则返回绑定的 socket。

返回值

本地 socket 地址，若匿名则返回空。

public OutputStream getOutputStream ()

获取输出流

返回值

输出流

异常

若 socket 已经关闭或者还没建立则抛出 IO 异常

public Credentials getPeerCredentials ()

获取 socket 对的认证信息。仅对已连接的套接字有效。

返回值

非空; 认证信息

异常

IOException

public int getReceiveBufferSize ()

（译者注：获取接受缓冲区大小）

异常

IOException

public LocalSocketAddress getRemoteSocketAddress ()

（译者注：获取 socket 连接端地址）

public int getSendBufferSize ()

（译者注：获取发送缓冲区大小）

异常

IOException

public int getSoTimeout ()

（译者注：得到远端超时设置）

异常

IOException

public synchronized boolean isBound ()

（译者注：是否已经绑定）

public boolean isClosed ()

（译者注：是否已经关闭连接）

public synchronized boolean isConnected ()

（译者注：是否已连接）

public boolean isInputShutdown ()

（译者注：输入流是否已关闭）

public boolean isOutputShutdown ()

（译者注：输出流是否已关闭）

public void setFileDescriptorsForSend (FileDescriptor[] fds)

将一组文件描述符放入队列准备发送到对端(socket)，这些文件描述符在下次发送普通数据时会作为单个辅助消息一同发送出去，请查看桌面 linux 系统的“main 7 unix” 的 SCM_RIGHT。

参数

Fds 非空，待发送的文件描述符数组。

public void setReceiveBufferSize (int size)

（译者注：设置接受缓冲区大小）

异常

IOException

public void setSendBufferSize (int n)

（译者注：设置发送缓冲区大小）

异常

IOException

public void setSoTimeout (int n)

（译者注：设置远端超时设置）

异常

IOException

public void shutdownInput ()

关闭输入端 socket

异常

IOException

public void shutdownOutput ()

关闭输出端 socket

异常

IOException

补充

文章精选

[推荐] OPhone OS 的网络层架构介绍

示例代码

Android LocalSocket / LocalServerSocket sample code

Platforms: Android SDK 1.0 (Eclipse 3.4.1 + ADT 0.8.0)

main.xml

<Button android:id="@+id/send_1_button"
android:layout_width="fill_parent" android:layout_height="wrap_content"
android:text="send 1 request"/>

java 文件：

import java.io.IOException;
import java.io.InputStream;

import android.app.Activity;
import android.net.LocalServerSocket;
import android.net.LocalSocket;
import android.net.LocalSocketAddress;
import android.os.Bundle;
import android.os.Handler;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

/**
*
* @author Denis Migol
*
*/
public class DemoActivity extends Activity {

public static String SOCKET_ADDRESS = "your.local.socket.address";

// background threads use this Handler to post messages to
// the main application thread
private final Handler handler = new Handler();

public class NotificationRunnable implements Runnable {
private String message = null;

public void run() {
if (message != null && message.length() > 0) {
showNotification(message);
}
}

/**
* @param message the message to set
*/
public void setMessage(String message) {
this.message = message;
}
}

// post this to the Handler when the background thread notifies
private final NotificationRunnable notificationRunnable = new NotificationRunnable();

public void showNotification(String message) {
Toast.makeText(this, message, Toast.LENGTH_SHORT).show();
}

class SocketListener extends Thread {
private Handler handler = null;
private NotificationRunnable runnable = null;

public SocketListener(Handler handler, NotificationRunnable runnable) {
this.handler = handler;
this.runnable = runnable;
this.handler.post(this.runnable);
}

/**
* Show UI notification.
* @param message
*/
private void showMessage(String message) {
this.runnable.setMessage(message);
this.handler.post(this.runnable);
}

@Override
public void run() {
//showMessage("DEMO: SocketListener started!");
try {
LocalServerSocket server = new LocalServerSocket(SOCKET_ADDRESS);
while (true) {
LocalSocket receiver = server.accept();
if (receiver != null) {
InputStream input = receiver.getInputStream();

// simply for java.util.ArrayList
int readed = input.read();
int size = 0;
int capacity = 0;
byte[] bytes = new byte[capacity];

// reading
while (readed != -1) {
// java.util.ArrayList.Add(E e);
capacity = (capacity * 3)/2 + 1;
//bytes = Arrays.copyOf(bytes, capacity);
byte[] copy = new byte[capacity];
System.arraycopy(bytes, 0, copy, 0, bytes.length);
bytes = copy;
bytes[size++] = (byte)readed;

// read next byte
readed = input.read();
}

showMessage(new String(bytes, 0, size));
}
}
} catch (IOException e) {
Log.e(getClass().getName(), e.getMessage());
}
}
}

public static void writeSocket(String message) throws IOException {
LocalSocket sender = new LocalSocket();
sender.connect(new LocalSocketAddress(SOCKET_ADDRESS));
sender.getOutputStream().write(message.getBytes());
sender.getOutputStream().close();
}

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);

new SocketListener(this.handler, this.notificationRunnable).start();

Button send1 = (Button)findViewById(R.id.send_1_button);
send1.setOnClickListener(new OnClickListener() {

@Override
public void onClick(View v) {
try {
writeSocket("hello");
} catch (IOException e) {
Log.e(getClass().getName(), e.getMessage());
}
}

});
}
}