SocketHandler Class

Definition

Simple network logging Handler.

[Android.Runtime.Register("java/util/logging/SocketHandler", DoNotGenerateAcw=true)]
public class SocketHandler : Java.Util.Logging.StreamHandler
[<Android.Runtime.Register("java/util/logging/SocketHandler", DoNotGenerateAcw=true)>]
type SocketHandler = class
    inherit StreamHandler
Inheritance
Attributes

Remarks

Simple network logging Handler.

LogRecords are published to a network stream connection. By default the XMLFormatter class is used for formatting.

<b>Configuration:</b> By default each SocketHandler is initialized using the following LogManager configuration properties where &lt;handler-name&gt; refers to the fully-qualified class name of the handler. If properties are not defined (or have invalid values) then the specified default values are used. <ul> <li> &lt;handler-name&gt;.level specifies the default level for the Handler (defaults to Level.ALL). </li> <li> &lt;handler-name&gt;.filter specifies the name of a Filter class to use (defaults to no Filter). </li> <li> &lt;handler-name&gt;.formatter specifies the name of a Formatter class to use (defaults to java.util.logging.XMLFormatter). </li> <li> &lt;handler-name&gt;.encoding the name of the character set encoding to use (defaults to the default platform encoding). </li> <li> &lt;handler-name&gt;.host specifies the target host name to connect to (no default). </li> <li> &lt;handler-name&gt;.port specifies the target TCP port to use (no default). </li> </ul>

For example, the properties for SocketHandler would be: <ul> <li> java.util.logging.SocketHandler.level=INFO </li> <li> java.util.logging.SocketHandler.formatter=java.util.logging.SimpleFormatter </li> </ul>

For a custom handler, e.g. com.foo.MyHandler, the properties would be: <ul> <li> com.foo.MyHandler.level=INFO </li> <li> com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter </li> </ul>

The output IO stream is buffered, but is flushed after each LogRecord is written.

Added in 1.4.

Java documentation for java.util.logging.SocketHandler.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

SocketHandler()

Create a SocketHandler, using only LogManager properties (or their defaults).

SocketHandler(IntPtr, JniHandleOwnership)

A constructor used when creating managed representations of JNI objects; called by the runtime.

SocketHandler(String, Int32)

Construct a SocketHandler using a specified host and port.

Properties

Class

Returns the runtime class of this Object.

(Inherited from Object)
Encoding

Return the character encoding for this Handler. -or- Set the character encoding used by this Handler.

(Inherited from Handler)
ErrorManager

Retrieves the ErrorManager for this Handler. -or- Define an ErrorManager for this Handler.

(Inherited from Handler)
Filter

Get the current Filter for this Handler. -or- Set a Filter to control output on this Handler.

(Inherited from Handler)
Formatter

Return the Formatter for this Handler. -or- Set a Formatter.

(Inherited from Handler)
Handle

The handle to the underlying Android instance.

(Inherited from Object)
JniIdentityHashCode (Inherited from Object)
JniPeerMembers
Level

Get the log level specifying which messages will be logged by this Handler. -or- Set the log level specifying which message levels will be logged by this Handler.

(Inherited from Handler)
PeerReference (Inherited from Object)
ThresholdClass

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

ThresholdType

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

Methods

Clone()

Creates and returns a copy of this object.

(Inherited from Object)
Close()

Close the current output stream.

(Inherited from StreamHandler)
Dispose() (Inherited from Object)
Dispose(Boolean) (Inherited from Object)
Equals(Object)

Indicates whether some other object is "equal to" this one.

(Inherited from Object)
Flush()

Flush any buffered messages.

(Inherited from StreamHandler)
GetHashCode()

Returns a hash code value for the object.

(Inherited from Object)
IsLoggable(LogRecord)

Check if this Handler would actually log a given LogRecord.

(Inherited from Handler)
JavaFinalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

(Inherited from Object)
Notify()

Wakes up a single thread that is waiting on this object's monitor.

(Inherited from Object)
NotifyAll()

Wakes up all threads that are waiting on this object's monitor.

(Inherited from Object)
Publish(LogRecord)

Format and publish a LogRecord.

(Inherited from StreamHandler)
ReportError(String, Exception, Int32)

Protected convenience method to report an error to this Handler's ErrorManager.

(Inherited from Handler)
SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Object)
SetOutputStream(Stream)

Change the output stream.

(Inherited from StreamHandler)
ToArray<T>() (Inherited from Object)
ToString()

Returns a string representation of the object.

(Inherited from Object)
UnregisterFromRuntime() (Inherited from Object)
Wait()

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>.

(Inherited from Object)
Wait(Int64)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)
Wait(Int64, Int32)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed() (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Object)
IJavaPeerable.Finalized() (Inherited from Object)
IJavaPeerable.JniManagedPeerState (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to