GroovyNotificationTutorial (XWiki.org)

1 Notifications

#warning("The notification mechanism is being refactored and will most likely change in XWiki Core 1.4. Thus if you're using the code below you'll have to update your code when you'll upgrade to XWiki Core 1.4.")

4

5

XWiki supports notifications and it's possible to do some action when a document is modified, when a document's objects are modified, etc.

6

7

This tutorial explains how to implement an action in a XWiki page that responds to document changes. This is done in Groovy. It can also be implemented as a Plugin.

8

9

We need to write 2 pages:

10

* A page containing a Groovy class that registers against the XWiki Event Manager and that has the method to be called when the event happens.

11

* Another page that parses the Groovy page and loads it in the Groovy context.

12

13

1.1 Groovy Notification Class

14

15

Your Groovy needs to extend the <tt>com.xpn.xwiki.notify.XWikiDocChangeNotificationInterface</tt> as shown below.

16

17

{code:none}

18

/* Groovy Class #* */

19

20

import com.xpn.xwiki.api.*;

21

import com.xpn.xwiki.notify.*;

22

import com.xpn.xwiki.*;

23

import com.xpn.xwiki.doc.*;

24

25

public class MyGroovyClass implements XWikiDocChangeNotificationInterface

{

def xwiki;

def rule;

public MyGroovyClass()

31

{

32

this.rule = new DocChangeRule(this);

33

}

34

35

public void init(xwiki)

36

{

37

this.xwiki = xwiki;

38

xwiki.getXWiki().getNotificationManager().addGeneralRule(this.rule);

39

}

40

41

public void cleanup()

42

{

43

xwiki.getXWiki().getNotificationManager().removeGeneralRule(this.rule);

44

}

45

46

public void notify(XWikiNotificationRule rule, XWikiDocument newdoc, XWikiDocument olddoc,

47

int event, XWikiContext context)

48

{

49

// Do some action here.

}

}

/* *# */

{code}

In this example we've used a <tt>DocChangeRule</tt> rule. There are also [other rules>http://svn.xwiki.org/svnroot/xwiki/xwiki-platform/core/trunk/xwiki-core/src/main/java/com/xpn/xwiki/notify/].

57

58

1.1 Calling the Groovy Class

59

60

{code:none}

61

#set($mygroovyclass = $xwiki.parseGroovyFromPage("MySpace.MyGroovyClass"))

62

$mygroovyclass.init($xwiki)

63

{code}

64

65

1.1 Example: IRC notification on document change

66

67

#warning("The code below uses the parseGroovyFromPage method which takes 2 parameters. The second one is the name of page containing JARS as attachments. These JARs are put in the classloader used by Groovy when parsing the page. This feature is only working in XWiki Core 1.3 and later.")

68

69

* Step 1: Groovy Class

70

71

{code:none}

72

/* Groovy Class #* */

73

74

import org.jibble.pircbot.*;

75