Package org.schwering.irc.lib

Class IRCEventAdapter

  • All Implemented Interfaces:
    java.util.EventListener, IRCConstants, IRCEventListener
    public class IRCEventAdapter
extends java.lang.Object
implements IRCEventListener
    Adapts the events of the IRCEventListener interface.

    Supported events:

    • Connect
    • Disconnect
    • Error
    • Invite
    • Join
    • Kick
    • Private Message
    • Mode (Chan)
    • Mode (User)
    • Nick
    • Notice
    • Numeric Reply
    • Numeric Error
    • Part
    • Ping
    • Quit
    • Topic

    For other, unkown events there's the unknown-method.

    See Also:
    IRCEventListener

    • Constructor Detail

      • IRCEventAdapter

        public IRCEventAdapter()
        The default and only constructor does nothing.

    • Method Detail

      • onRegistered

        public void onRegistered()
        Fired when the own connection is successfully established. This is the case when the first PING? is received.
        This happens between the connection is opened with a socket and the connection is registered: The client sends his information to the server (nickname, username). The server says hello to you by sending you some NOTICEs. And if your nickname is invalid or in use or anything else is wrong with your nickname, it asks you for a new one.
        Specified by:
        onRegistered in interface IRCEventListener

      • onError

        public void onError​(java.lang.String msg)
        Fired when an ERROR command is received.
        Specified by:
        onError in interface IRCEventListener
        Parameters:
        msg - The message of the error.

      • onError

        public void onError​(int num,
                    java.lang.String msg)
        Fired when a numeric error is received. The server often sends numeric errors (wrong nickname etc.). The msg's format is different for every reply. All replies' formats are described in the IRCUtil.
        Specified by:
        onError in interface IRCEventListener
        Parameters:
        num - The identifier (usually a 3-digit number).
        msg - The message of the error.

      • onInvite

        public void onInvite​(java.lang.String chan,
                     IRCUser user,
                     java.lang.String passiveNick)
        Fired when somebody is invited to a channel.
        Specified by:
        onInvite in interface IRCEventListener
        Parameters:
        chan - The channel the user is invited to.
        user - The user who invites another. Contains nick, username and host.
        passiveNick - The nickname of the user who is invited by another user (passive).

      • onJoin

        public void onJoin​(java.lang.String chan,
                   IRCUser user)
        Fired when somebody joins a channel.
        Specified by:
        onJoin in interface IRCEventListener
        Parameters:
        chan - The channel the person joins.
        user - The user who joins. Contains nick, username and host.

      • onKick

        public void onKick​(java.lang.String chan,
                   IRCUser user,
                   java.lang.String passiveNick,
                   java.lang.String msg)
        Fired when somebody is kicked from a channel.
        Specified by:
        onKick in interface IRCEventListener
        Parameters:
        chan - The channel somebody is kicked from.
        user - The user who kicks another user from a channel. Contains nick, username and host.
        passiveNick - The nickname of the user who is kicked from a channel (passive).
        msg - The message the active user has set. This is "" if no message was set.

      • onMode

        public void onMode​(java.lang.String chan,
                   IRCUser user,
                   IRCModeParser modeParser)
        Fired when an operator changes the modes of a channel. For example, he can set somebody as an operator, too, or take him the oper-status. Also keys, moderated and other channelmodes are fired here.
        Specified by:
        onMode in interface IRCEventListener
        Parameters:
        chan - The channel in which the modes are changed.
        user - The user who changes the modes. Contains nick, username and host.
        modeParser - The IRCModeParser object which contains the parsed information about the modes which are changed.

      • onMode

        public void onMode​(IRCUser user,
                   java.lang.String passiveNick,
                   java.lang.String mode)
        Fired when somebody changes somebody's usermodes. Note that this event is not fired when a channel-mode is set, for example when someone sets another user as operator or the mode moderated.
        Specified by:
        onMode in interface IRCEventListener
        Parameters:
        user - The user who changes the modes of another user or himself. Contains nick, username and host.
        passiveNick - The nickname of the person whose modes are changed by another user or himself.
        mode - The changed modes which are set.

      • onNick

        public void onNick​(IRCUser user,
                   java.lang.String newNick)
        Fired when somebody changes his nickname successfully.
        Specified by:
        onNick in interface IRCEventListener
        Parameters:
        user - The user who changes his nickname. Contains nick, username and host.
        newNick - The new nickname of the user who changes his nickname.

      • onNotice

        public void onNotice​(java.lang.String target,
                     IRCUser user,
                     java.lang.String msg)
        Fired when somebody sends a NOTICE to a user or a group.
        Specified by:
        onNotice in interface IRCEventListener
        Parameters:
        target - The channel or nickname the user sent a NOTICE to.
        user - The user who notices another person or a group. Contains nick, username and host.
        msg - The message.

      • onPart

        public void onPart​(java.lang.String chan,
                   IRCUser user,
                   java.lang.String msg)
        Fired when somebody parts from a channel.
        Specified by:
        onPart in interface IRCEventListener
        Parameters:
        chan - The channel somebody parts from.
        user - The user who parts from a channel. Contains nick, username and host.
        msg - The part-message which is optionally. If it's empty, msg is "".

      • onPing

        public void onPing​(java.lang.String ping)
        Fired when a PING comes in. The IRC server tests in different periods if the client is still there by sending PING <ping>. The client must response PONG <ping>.
        Specified by:
        onPing in interface IRCEventListener
        Parameters:
        ping - The ping which is received from the server.

      • onPrivmsg

        public void onPrivmsg​(java.lang.String target,
                      IRCUser user,
                      java.lang.String msg)
        Fired when a user sends a PRIVMSG to a user or to a group.
        Specified by:
        onPrivmsg in interface IRCEventListener
        Parameters:
        target - The channel or nickname the user sent a PRIVMSG to.
        user - The user who sent the PRIVMSG. Contains nick, username and host.
        msg - The message the user transmits.

      • onQuit

        public void onQuit​(IRCUser user,
                   java.lang.String msg)
        Fired when somebody quits from the network.
        Specified by:
        onQuit in interface IRCEventListener
        Parameters:
        user - The user who quits. Contains nick, username and host.
        msg - The optional message. "" if no message is set by the user.

      • onReply

        public void onReply​(int num,
                    java.lang.String value,
                    java.lang.String msg)
        Fired when a numeric reply is received. For example, WHOIS queries are answered by the server with numeric replies. The msg's format is different for every reply. All replies' formats are described in the IRCUtil. The first word in the value is always your own nickname!
        Specified by:
        onReply in interface IRCEventListener
        Parameters:
        num - The numeric reply.
        value - The first part of the message.
        msg - The main part of the message.

      • onTopic

        public void onTopic​(java.lang.String chan,
                    IRCUser user,
                    java.lang.String topic)
        Fired when the topic is changed by operators. Note that the topic is given as a numeric reply fired in onReply when you join a channel.
        Specified by:
        onTopic in interface IRCEventListener
        Parameters:
        chan - The channel where the topic is changed.
        user - The user who changes the topic. Contains nick, username and host.
        topic - The new topic.

      • unknown

        public void unknown​(java.lang.String prefix,
                    java.lang.String command,
                    java.lang.String middle,
                    java.lang.String trailing)
        This event is fired when the incoming line can not be identified as a known event.
        Specified by:
        unknown in interface IRCEventListener
        Parameters:
        prefix - The prefix of the incoming line.
        command - The command of the incoming line.
        middle - The part until the colon (:).
        trailing - The part behind the colon (:).