java.util.logging
類別 SocketHandler

java.lang.Object
  java.util.logging.Handler
      java.util.logging.StreamHandler
          java.util.logging.SocketHandler

public class SocketHandler
extends StreamHandler

簡單的網路日誌 Handler。

將 LogRecords 發佈到網路串流連接。預設情況下，XMLFormatter 類別用於格式化。

配置：預設情況下，每個 SocketHandler 是使用以下 LogManager 配置屬性執行初始化的。如果未定義屬性（或者屬性具有無效值），則使用指定的預設值。

• java.util.logging.SocketHandler.level 指定 Handler 的預設級別（預設值為 Level.ALL）。
• java.util.logging.SocketHandler.filter 指定要使用的 Filter 類別的名稱（預設值非 Filter）。
• java.util.logging.SocketHandler.formatter 指定要使用的 Formatter（預設值為 java.util.logging.XMLFormatter）。
• java.util.logging.SocketHandler.encoding 要使用的字元集編碼的名稱（預設值為預設平臺編碼）。
• java.util.logging.SocketHandler.host 指定要連接到的目標主機名（無預設值）。
• java.util.logging.SocketHandler.port 指定要使用的目標 TCP 埠號（無預設值）。

輸出 IO 串流是緩衝的，但是在每次寫入 LogRecord 後都將刷新。

從以下版本開始：

1.4

建構子摘要

SocketHandler()
僅使用 LogManager 屬性（或其預設值）創建 SocketHandler。

SocketHandler(String host, int port)
建構一個帶有指定主機和埠號的 SocketHandler。

方法摘要

void	close() 關閉此輸出串流。
void	publish(LogRecord record) 格式化共時布 LogRecord。

從類別 java.util.logging.StreamHandler 繼承的方法

flush, isLoggable, setEncoding, setOutputStream

從類別 java.util.logging.Handler 繼承的方法

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

SocketHandler

public SocketHandler()
              throws IOException

僅使用 LogManager 屬性（或其預設值）創建 SocketHandler。

拋出：

IllegalArgumentException - 如果主機或埠號無效或者沒有指定為 LogManager 屬性。

IOException - 如果未能連接到目標主機和埠號。

SocketHandler

public SocketHandler(String host,
                     int port)
              throws IOException

建構一個帶有指定主機和埠號的 SocketHandler。 SocketHandler 是基於 LogManager 屬性（或其預設值）配置的，除非使用了給定的目標主機和埠號參數。如果主機參數為空，但不是 null 字元串，則使用本地主機。

參數：

host - 目標主機。

port - 目標埠號。

拋出：

IllegalArgumentException - 如果主機或埠號無效。

IOException - 如果未能連接到目標主機和埠號。

方法詳細資訊

close

public void close()
           throws SecurityException

關閉此輸出串流。

覆寫：

類別 StreamHandler 中的 close

拋出：

SecurityException - 如果存在安全管理器，且調用者不具有 LoggingPermission("control")。

publish

public void publish(LogRecord record)

格式化共時布 LogRecord。

覆寫：

類別 StreamHandler 中的 publish

參數：

record - 對日誌事件的描述。預設忽略 null 記錄，並且不進行發佈。