[LOG4J2-1557] Add a Builder for the SocketAppender (deprecates factory method)

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 2.7
• Component/s: Appenders
• Assignee: Gary D. Gregory
• Reporter: Gary D. Gregory
• Created: 01/Sep/16 17:39
• Updated: 01/Sep/16 22:02
• Resolved: 01/Sep/16 17:53

Description

Add a Builder for the SocketAppender and deprecate the factory method.

I need to add parameters for bufferedIo and bufferSize to the SocketAppender and the SyslogAppender as I am embarking on a project that will use Syslog events in large quantities. Then I'd like to also add these to other streaming appenders. I'll create a different ticket for these.

Deprecated:

• org.apache.logging.log4j.core.appender.SocketAppender.createAppender(String, int, Protocol, SslConfiguration, int, int, boolean, String, boolean, boolean, Layout<? extends Serializable>, Filter, boolean, Configuration)
• org.apache.logging.log4j.core.appender.SocketAppender.createAppender(String, String, String, SslConfiguration, int, String, String, String, String, String, Layout<? extends Serializable>, Filter, String, Configuration)

When should we deprecate these?

Issue Links

• is required by: LOG4J2-1558 SocketAppender should support IO buffering