AbstractSocketAppender (logback-android 2.0.0 API)

java.lang.Object
- ch.qos.logback.core.spi.ContextAwareBase
- - ch.qos.logback.core.AppenderBase<E>
  - - ch.qos.logback.core.net.AbstractSocketAppender<E>

All Implemented Interfaces:

Appender<E>, SocketConnector.ExceptionHandler, ContextAware, FilterAttachable<E>, LifeCycle

Direct Known Subclasses:

AbstractSSLSocketAppender, SocketAppender, SSLSocketAppenderBase
```
public abstract class AbstractSocketAppender<E>
extends AppenderBase<E>
implements SocketConnector.ExceptionHandler
```
An abstract base for module specific SocketAppender implementations in other logback modules.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_PORT` The default port number of remote logging server (4560).
`static int`	`DEFAULT_QUEUE_SIZE` Default size of the deque used to hold logging events that are destined for the remote peer.
`static int`	`DEFAULT_RECONNECTION_DELAY` The default reconnection delay (30000 milliseconds or 30 seconds).

Fields inherited from class ch.qos.logback.core.AppenderBase
name, started

Fields inherited from class ch.qos.logback.core.spi.ContextAwareBase
context

Constructor Summary

Constructors
Modifier Constructor and Description

protected AbstractSocketAppender()
Constructs a new appender.

Constructors
Modifier	Constructor and Description
`protected`	`AbstractSocketAppender()` Constructs a new appender.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`append(E event)`
`void`	`connectionFailed(SocketConnector connector, Exception ex)`
`Duration`	`getEventDelayLimit()` Returns the value of the eventDelayLimit property.
`int`	`getPort()` Returns value of the Port property.
`protected abstract PreSerializationTransformer<E>`	`getPST()` Get the pre-serialization transformer that will be used to transform each event into a Serializable object before delivery to the remote receiver.
`int`	`getQueueSize()` Returns the value of the queueSize property.
`Duration`	`getReconnectionDelay()` Returns value of the reconnectionDelay property.
`String`	`getRemoteHost()` Returns value of the RemoteHost property.
`protected SocketFactory`	`getSocketFactory()` Gets the default `SocketFactory` for the platform.
`protected SocketConnector`	`newConnector(InetAddress address, int port, long initialDelay, long retryDelay)` Creates a new `SocketConnector`.
`protected abstract void`	`postProcessEvent(E event)` Post-processes an event before it is serialized for delivery to the remote receiver.
`void`	`setEventDelayLimit(Duration eventDelayLimit)` The eventDelayLimit takes a non-negative integer representing the number of milliseconds to allow the appender to block if the underlying BlockingQueue is full.
`void`	`setPort(int port)` The Port property takes a positive integer representing the port where the server is waiting for connections.
`void`	`setQueueSize(int queueSize)` The queueSize property takes a non-negative integer representing the number of logging events to retain for delivery to the remote receiver.
`void`	`setReconnectionDelay(Duration delay)` The reconnectionDelay property takes a positive `Duration` value representing the time to wait between each failed connection attempt to the server.
`void`	`setRemoteHost(String host)` The RemoteHost property takes the name of of the host where a corresponding server is running.
`void`	`start()`
`void`	`stop()`

Methods inherited from class ch.qos.logback.core.AppenderBase
addFilter, clearAllFilters, doAppend, getCopyOfAttachedFiltersList, getFilterChainDecision, getName, isStarted, setName, toString

Methods inherited from class ch.qos.logback.core.spi.ContextAwareBase
addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, getDeclaredOrigin, getStatusManager, setContext

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ch.qos.logback.core.spi.ContextAware
addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, setContext

- Field Detail
  - DEFAULT_PORT
```
public static final int DEFAULT_PORT
```
    The default port number of remote logging server (4560).
    
    See Also:
    
    Constant Field Values
  - DEFAULT_RECONNECTION_DELAY
```
public static final int DEFAULT_RECONNECTION_DELAY
```
    The default reconnection delay (30000 milliseconds or 30 seconds).
    
    See Also:
    
    Constant Field Values
  - DEFAULT_QUEUE_SIZE
```
public static final int DEFAULT_QUEUE_SIZE
```
    Default size of the deque used to hold logging events that are destined for the remote peer.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - AbstractSocketAppender
```
protected AbstractSocketAppender()
```
    Constructs a new appender.
- Method Detail
  - start
```
public void start()
```
    Specified by:
    
    start in interface LifeCycle
    
    Overrides:
    
    start in class AppenderBase<E>
  - stop
```
public void stop()
```
    Specified by:
    
    stop in interface LifeCycle
    
    Overrides:
    
    stop in class AppenderBase<E>
  - append
```
protected void append(E event)
```
    Specified by:
    
    append in class AppenderBase<E>
  - connectionFailed
```
public void connectionFailed(SocketConnector connector,
                             Exception ex)
```
    Specified by:
    
    connectionFailed in interface SocketConnector.ExceptionHandler
  - newConnector
```
protected SocketConnector newConnector(InetAddress address,
                                       int port,
                                       long initialDelay,
                                       long retryDelay)
```
    Creates a new SocketConnector.
    The default implementation creates an instance of DefaultSocketConnector. A subclass may override to provide a different SocketConnector implementation.
    
    Parameters:
    
    address - target remote address
    
    port - target remote port
    
    initialDelay - delay before the first connection attempt
    
    retryDelay - delay before a reconnection attempt
    
    Returns:
    
    socket connector
  - getSocketFactory
```
protected SocketFactory getSocketFactory()
```
    Gets the default SocketFactory for the platform.
    Subclasses may override to provide a custom socket factory.
    
    Returns:
    
    the socket factory
  - postProcessEvent
```
protected abstract void postProcessEvent(E event)
```
    Post-processes an event before it is serialized for delivery to the remote receiver.
    
    Parameters:
    
    event - the event to post-process
  - getPST
```
protected abstract PreSerializationTransformer<E> getPST()
```
    Get the pre-serialization transformer that will be used to transform each event into a Serializable object before delivery to the remote receiver.
    
    Returns:
    
    transformer object
  - setRemoteHost
```
public void setRemoteHost(String host)
```
    The RemoteHost property takes the name of of the host where a corresponding server is running.
    
    Parameters:
    
    host - the remote hostname
  - getRemoteHost
```
public String getRemoteHost()
```
    Returns value of the RemoteHost property.
    
    Returns:
    
    the RemoteHost value
  - setPort
```
public void setPort(int port)
```
    The Port property takes a positive integer representing the port where the server is waiting for connections.
    
    Parameters:
    
    port - the desired port
  - getPort
```
public int getPort()
```
    Returns value of the Port property.
    
    Returns:
    
    the Port value
  - setReconnectionDelay
```
public void setReconnectionDelay(Duration delay)
```
    The reconnectionDelay property takes a positive Duration value representing the time to wait between each failed connection attempt to the server. The default value of this option is to 30 seconds.
    Setting this option to zero turns off reconnection capability.
    
    Parameters:
    
    delay - the desired reconnection delay
  - getReconnectionDelay
```
public Duration getReconnectionDelay()
```
    Returns value of the reconnectionDelay property.
    
    Returns:
    
    the reconnection delay
  - setQueueSize
```
public void setQueueSize(int queueSize)
```
    The queueSize property takes a non-negative integer representing the number of logging events to retain for delivery to the remote receiver. When the deque size is zero, event delivery to the remote receiver is synchronous. When the deque size is greater than zero, the append(Object) method returns immediately after enqueing the event, assuming that there is space available in the deque. Using a non-zero deque length can improve performance by eliminating delays caused by transient network delays.
    
    Parameters:
    
    queueSize - the deque size to set.
  - getQueueSize
```
public int getQueueSize()
```
    Returns the value of the queueSize property.
    
    Returns:
    
    the size of the queue
  - setEventDelayLimit
```
public void setEventDelayLimit(Duration eventDelayLimit)
```
    The eventDelayLimit takes a non-negative integer representing the number of milliseconds to allow the appender to block if the underlying BlockingQueue is full. Once this limit is reached, the event is dropped.
    
    Parameters:
    
    eventDelayLimit - the event delay limit
  - getEventDelayLimit
```
public Duration getEventDelayLimit()
```
    Returns the value of the eventDelayLimit property.
    
    Returns:
    
    the event delay limit in ms

Class AbstractSocketAppender<E>

Field Summary

Fields inherited from class ch.qos.logback.core.AppenderBase

Fields inherited from class ch.qos.logback.core.spi.ContextAwareBase

Constructor Summary

Method Summary

Methods inherited from class ch.qos.logback.core.AppenderBase

Methods inherited from class ch.qos.logback.core.spi.ContextAwareBase

Methods inherited from class java.lang.Object

Methods inherited from interface ch.qos.logback.core.spi.ContextAware

Field Detail

DEFAULT_PORT

DEFAULT_RECONNECTION_DELAY

DEFAULT_QUEUE_SIZE

Constructor Detail

AbstractSocketAppender

Method Detail

start

stop

append

connectionFailed

newConnector

getSocketFactory

postProcessEvent

getPST

setRemoteHost

getRemoteHost

setPort

getPort

setReconnectionDelay

getReconnectionDelay

setQueueSize

getQueueSize

setEventDelayLimit

getEventDelayLimit