summaryrefslogtreecommitdiffstats
path: root/java/com/rsyslog/lib/UDPSyslogSender.java
blob: 1a2c4726be3a6f19d6b27225e753e10dae7215bb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
/**
 * A UDP transport implementation of a syslog sender.
 *
 * Note that there is an anomaly in this version of the code: we query the remote system
 * address only once during the connection setup and resue it. If we potentially run for
 * an extended period of time, the remote address may change, what we do not reflect. For
 * the current use case, this is acceptable, but if this code is put into more wide-spread
 * use outside of debugging, a periodic requery should be added.
 *
 * @author Rainer Gerhards
 * 
 * Copyright 2009 Rainer Gerhards and Adiscon GmbH.
 *
 * This file is part of rsyslog.
 *
 * Rsyslog is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Rsyslog is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Rsyslog.  If not, see http://www.gnu.org/licenses/.
 *
 * A copy of the GPL can be found in the file "COPYING" in this distribution.
 */
package com.rsyslog.lib;
import java.net.*;

public class UDPSyslogSender extends SyslogSender {

	private final int port = 514; // TODO: take from target!
	private InetAddress targetAddr;

	/** the socket to communicate over with the remote system. */
	private DatagramSocket sock;

	/** Constructs Sender, sets target system.
	 * @param target the system to connect to. Syntax of target is depending
	 * 		 on the underlying transport.
	 */
	public UDPSyslogSender(String target) throws Exception {
		super(target);
	}

	/** send a message on the wire.
	 * This needs a complete formatted message, which will be extended by
	 * the transport framing, if necessary.
	 *
	 * @param MSG a validly formatted syslog message as of the RFC (all parts)
	 * @throws Exception (depending on transport)
	 */
	protected void sendTransport(String MSG) throws Exception {
		byte msg[] = MSG.getBytes();
		DatagramPacket pkt = new DatagramPacket(msg, msg.length, targetAddr, port);
		sock.send(pkt);
	}


	/** connect to the target. 
	 * For UDP, this means we create the socket.
	 */
	public void connect() throws Exception {
		super.connect();
		sock = new DatagramSocket();

		// TODO: we should extract the actual hostname & port!
		targetAddr = InetAddress.getByName(getTarget());
	}

}