This document discusses various Java tips and techniques for XPages development, including: 1) Putting Notes documents in memory by wrapping them in a DominoDocument class to avoid memory issues. 2) Using built-in JSON classes to build JSON instead of string concatenation. 3) Creating managed beans to minimize server-side JavaScript and make code more readable. 4) Developing utility classes and extending classes for reusable code.

1. Use Notes objects in
memory and other useful
Java tips for XPages
development
Frank van der Linden
17-3-2014 @EngageUG #engageug 1

2. 17-3-2014 @EngageUG #engageug 2
@flinden68
http://flinden68.wordpress.com
http://nl.linkedin.com/in/flinden68
fli@e-office.com

3. Disclaimer
All the code and the demos in this session will use the Java
Notes Objects which are part of the IBM/Lotus Notes
product.
For a modern way of Java coding with Notes Objects
please use the OpenNTF Domino API.
Please visit the session of Paul Withers and Martin Jinoch.
Or even better use OpenNTF essentials
17-3-2014 @EngageUG #engageug 3

4. Roadmap
• Notes objects in memory
• Use of JSON
• Managed beans
• Java tip for XPages
• Date checks
• Utility class
• Extending classes
• Use of finally
17-3-2014 @EngageUG #engageug 4

5. Notes objects in memory
17-3-2014 @EngageUG #engageug 5

6. Bad practice
• Notes objects are not serializable
• Will not recycled the Java way, it will keep a pointer to the
C object
• Can cause out of memory
17-3-2014 @EngageUG #engageug 6

7. What is Serialization
17-3-2014 @EngageUG #engageug 7

8. XPages Java doc to the rescue
17-3-2014 @EngageUG #engageug 8

9. Put Notes document in memory
• Get Notesdocument
• Wrap Notesdocument into a DominoDocument
17-3-2014 @EngageUG #engageug 9

10. Access fields
• First check if document isRecycled
• Access field
17-3-2014 @EngageUG #engageug 10

11. On a XPage and more
• In a computed field
• In an edit box
• Update the backend document
17-3-2014 @EngageUG #engageug 11

12. Demo
17-3-2014 @EngageUG #engageug 12

13. What about attachments
• Get easy access to your attachements
17-3-2014 @EngageUG #engageug 13

14. What about attachments
• No calculation of paths
• Works both in XPinc and Web
• Call the attachment URL
17-3-2014 @EngageUG #engageug 14

15. Demo
17-3-2014 @EngageUG #engageug 15

16. Use buildin JSON classes
17-3-2014 @EngageUG #engageug 16

17. JSON building classes
• Part of the Extensibility API, since 8.5.2
• Easy way to build JSON
17-3-2014 @EngageUG #engageug 17

18. JSON building classes
• No concatenation of Strings
• Faster
• Readable code
17-3-2014 @EngageUG #engageug 18

19. Managed beans
17-3-2014 @EngageUG #engageug 19

20. The requirements
• Needs to be Serializable
• At least one constructor without parameters
• Needs to be registrated in the Faces-config.xml
• Properties have Getters and Setters
17-3-2014 @EngageUG #engageug 20

21. Faces-config.xml syntax
• Name of the bean
• Full qualified class name
• Scope of the bean
• Optional, initialize properties
17-3-2014 @EngageUG #engageug 21

22. Use the managed beans
• Do the calculation in the class
• Use Expression Language to access properties
• Minimize use of SSJS
• Some examples
17-3-2014 @EngageUG #engageug 22

23. Java tips for XPages
17-3-2014 @EngageUG #engageug 23

24. Utility class
• All kind of methods
• Always available as static class
• I added some methods who were
translated from SSJS
17-3-2014 @EngageUG #engageug 24

25. Date checks
• Remember the TimeDifference horror
• Java provide nice Date checks
• Like… Date.before(Date) or Date.after(Date)
17-3-2014 @EngageUG #engageug 25

26. Extending a class
• Extend a base class
• Use the methods of the base class
17-3-2014 @EngageUG #engageug 26

27. Extending a class
• Using the class
• In a XPage
17-3-2014 @EngageUG #engageug 27

28. Questions
17-3-2014 @EngageUG #engageug 28

29. Credits
• DominoDocument, thanks Jesse Gallaghar for pointing me in the right direction.
• Utility Class, the base taken from the Help Application from OpenNTF
• Presentation, reveal.js
• Demo database runs on Domino 9.0.1
• Demo database needs the Extension Library from OpenNTF
• XPages Java doc, http://public.dhe.ibm.com/software/dw/lotus/Domino-
Designer/JavaDocs/XPagesExtAPI/8.5.2/index.html?overview-summary.html
17-3-2014 @EngageUG #engageug 29

30. 17-3-2014 @EngageUG #engageug 30
@flinden68
http://flinden68.wordpress.com
http://nl.linkedin.com/in/flinden68
fli@e-office.com
Thank you

31. Bonus
17-3-2014 @EngageUG #engageug 31

32. Event Source
17-3-2014 @EngageUG #engageug 32

33. Customizable Toolbar
17-3-2014 @EngageUG #engageug 33