Document thread safety.

Author: cyrille-leclerc

src/main/java/com/cloudbees/syslog/sender/SyslogMessageSender.java

@@ -20,13 +20,19 @@
 
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
+import javax.annotation.concurrent.ThreadSafe;
 import java.io.CharArrayWriter;
 import java.io.IOException;
 import java.util.concurrent.TimeUnit;
 
 /**
+ * Send messages to a Syslog server.
+ * <p/>
+ * Implementation <strong>MUST</strong> be thread safe.
+ *
  * @author <a href="mailto:[email protected]">Cyrille Le Clerc</a>
  */
+@ThreadSafe
 public interface SyslogMessageSender {
     public static final long DEFAULT_INET_ADDRESS_TTL_IN_MILLIS = TimeUnit.MILLISECONDS.convert(30, TimeUnit.SECONDS);
     public static final long DEFAULT_INET_ADDRESS_TTL_IN_NANOS = TimeUnit.NANOSECONDS.convert(DEFAULT_INET_ADDRESS_TTL_IN_MILLIS, TimeUnit.MILLISECONDS);

src/main/java/com/cloudbees/syslog/sender/TcpSyslogMessageSender.java

@@ -21,6 +21,7 @@
 
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
+import javax.annotation.concurrent.ThreadSafe;
 import javax.net.SocketFactory;
 import javax.net.ssl.SSLSession;
 import javax.net.ssl.SSLSocket;
@@ -40,6 +41,7 @@
  *
  * @author <a href="mailto:[email protected]">Cyrille Le Clerc</a>
  */
+@ThreadSafe
 public class TcpSyslogMessageSender extends AbstractSyslogMessageSender {
     public final static int SETTING_SOCKET_CONNECT_TIMEOUT_IN_MILLIS_DEFAULT_VALUE = 500;
 

src/main/java/com/cloudbees/syslog/sender/UdpSyslogMessageSender.java

@@ -19,6 +19,7 @@
 import com.cloudbees.syslog.util.CachingReference;
 
 import javax.annotation.Nullable;
+import javax.annotation.concurrent.ThreadSafe;
 import java.io.ByteArrayOutputStream;
 import java.io.IOException;
 import java.io.OutputStreamWriter;
@@ -37,6 +38,7 @@
  *
  * @author <a href="mailto:[email protected]">Cyrille Le Clerc</a>
  */
+@ThreadSafe
 public class UdpSyslogMessageSender extends AbstractSyslogMessageSender {
     /**
      * {@link java.net.InetAddress InetAddress} of the remote Syslog Server.