posted by 희정냥★ 2008. 10. 9. 14:02
* Link :

Eclipse Communication Framework (ECF)

Create an IRC bot

A bot is a useful daemon application for a user to automate tasks similar to a script or a macro. An IRC bot is generally a bot that sits in an IRC channel and performs tasks such as answering to commands and logging. This tutorial will explain how to create an IRC bot using the bot framework.


As regular expression pattern matching is used, a Java runtime environment of 1.4.2 or higher is required.

Project Setup

  1. Create a 'Plug-in Project' like how you normally would. Since this is a bot that will be run in headless mode, we do not need any UI components. You do not even need an activator class.
  2. Open the 'MANIFEST.MF' file and go to the 'Dependencies' tab.
  3. Add 'org.eclipse.ecf', 'org.eclipse.ecf.presence', and '' as a 'Required Plug-in'.
  4. Now add 'org.eclipse.core.runtime' as an 'Imported Package'.


 Manifest-Version: 1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: Geir Plug-in
 Bundle-SymbolicName: org.eclipse.ecf.example.geir;singleton:=true
 Bundle-Version: 1.0.0
 Require-Bundle: org.eclipse.ecf,
 Import-Package: org.eclipse.core.runtime


  1. Open the 'Extensions' tab.
  2. Add the '' and the '' extension point.
  3. Select the '' extension.
  4. Fill in something unique for your 'id'. ''
  5. Fill in 'ecf.irc.irclib' for your 'containerFactoryName'.
  6. For the 'connectId', select an IRC server of your choice and a name for the bot. 'irc://'
  7. For the 'chatRoom' field, pick the channel that you want your bot to join upon successful connection to the server above. '#eclipse'
  8. Now select the '' extension point.
  9. For your 'id', copy the same 'id' that you filled in above. ''
  10. In 'filterExpression', enter a regular expression that should be matched for parsing purposes for your bot. '(~bug[0-9]*)
  11. Click on the 'class*' hyperlink and then create a new class that implements the '' interface. For this example, I will assume that your class's name is 'Geir2Bot' under the '' package..


 <?xml version="1.0" encoding="UTF-8"?>
 <?eclipse version="3.2"?>

Writing the Code

  1. Open the 'Geir2Bot' class that you have created.
    • Since we want our bot to be able to say something, we need to retrieve an interface that will provide us with such a functionality.
      • Add a field to the class of type 'IChatMessageSender'.
        • We will retrieve our instance in the 'preChatRoomConnect(IChatRoomContainer, ID)' method. This method will be called right before our bot joins the channel (#eclipse in our case). You can retrieve an instance of an IChatMessageSender by calling 'getChatRoomMessageSender()' on the provided 'IChatRoomContainer' instance.
          • Now that our bot has a mechanism for replying, we should write some code to parse the messages that the bot receives so that it can give a correct response. To get the string that's been said, use the 'getMessage()' method from the 'IChatRoomMessage' interface that's passed into the 'handleRoomMessage(IChatRoomMessage)' method.
            • Our regular expression of '(~bug[0-9]*)' implies that any string beginning with ~bug followed by any number of digits will be a valid input for our bot to read. So let's add some string handling code to route people to Eclipse's bugzilla when they type something like ~bug150000 or ~bug180078.
              • To send a reply to the IRC channel, simply use IChatRoomMessageSender's 'sendMessage(String)' method. This method will throw an 'ECFException', but given this simple scenario, we won't bother to handle it.


               import org.eclipse.ecf.core.IContainer;
               import org.eclipse.ecf.core.identity.ID;
               import org.eclipse.ecf.core.util.ECFException;
               import org.eclipse.ecf.presence.chatroom.IChatRoomContainer;
               import org.eclipse.ecf.presence.chatroom.IChatRoomMessage;
               import org.eclipse.ecf.presence.chatroom.IChatRoomMessageSender;
               public class Geir2Bot implements IChatRoomMessageHandler {
               	private IChatRoomMessageSender sender;
               	public void handleRoomMessage(IChatRoomMessage message) {
               		// use substring 1 to just truncate the opening tilda (~)
               		String msg = message.getMessage().substring(1);
               		try {
               			if (msg.equals("bug")) { //$NON-NLS-1$
               				// if no number was provided, just send them to bugzilla
               				sender.sendMessage(""); //$NON-NLS-1$
               			} else {
               				// otherwise, give the person a direct link to the bug
                				sender.sendMessage("" //$NON-NLS-1$
               						+ "show_bug.cgi?id=" + msg.substring(3)); //$NON-NLS-1$
               		} catch (ECFException e) {
               	public void init(IChatRoomBotEntry robot) {
               		// nothing to do
               	public void preChatRoomConnect(IChatRoomContainer roomContainer, ID roomID) {
               		sender = roomContainer.getChatRoomMessageSender();
               	public void preContainerConnect(IContainer container, ID targetID) {
               		// nothing to do

              Running the Example

              1. Open the 'Run' dialog and then right-click on 'Eclipse Application' and select 'New'.
              2. From the combo drop down in the 'Program to Run' section, select 'Run an pplication:' and choose ''.
              3. Click on the 'Plug-ins' tab.
              4. From the top, select 'plug-ins selected below only' from the drop down box.
              5. Pick the plug-in you created (in the example, this was 'org.eclipse.ecf.example.geir') and 'org.eclipse.ecf.provider.irc'.
              6. Click on the '''Add Required Plug-ins''' button on the right and then hit 'Run'.
              7. Moments later, your bot should appear in the server and channel that you specified in the 'plugin.xml' file.

               * geir2 ( has joined #eclipse
               <user> ~bug
               <user> ~bug76759
              심심할때 해봐야겠심;

              댓글을 달아 주세요