The Atlassian Platform is full of great technologies to make your life easier. Learn how to leverage UAL and ActiveObjects as well as FishEye/Crucible's public SPI, in order to develop awesome plugins such as the new FishEye/Crucible to Bamboo integration plugin. Jason Hinch, FishEye & Crucible Developer

2. Rapid Development with
ActiveObjects
Jason Hinch
Developer, Atlassian
2

3. About Me
• FishEye/Crucible front-end team
• Java, Python and JavaScript
• 18 months at Atlassian
• Previously:
• Confluence Plugins
• Perl Development
3

4. Agenda
• Why ActiveObjects?
• What is ActiveObjects?
• Getting Started
• Defining an Entity
• CRUD with ActiveObjects
• Upgrade tasks
• Testing 4

5. The Idea
• Bamboo data and actions
from FishEye/Crucible
• Commit Graph
• Changeset
• Review
• Triggering Builds
5

6. Quick Demo
6

7. The First Problem
• Fetching data from Bamboo
• Dependency on External System
• Large amount of data, fast
• Cache data in FishEye
• Storage
• Backup & Restore
7

8. Previous Solutions
• In Memory Cache
• Flat Files (Java/XML/JSON serialisation)
• SAL property sets
• Plugin managed database
8

9. ActiveObjects
9

10. ActiveObjects - What?
• Can refer to two different projects
• ActiveObjects Library
• Atlassian ActiveObjects Framework
10

11. ActiveObjects Library
• Lightweight ORM
• Annotation based DDL
• Create/Read/Update/Delete (CRUD)
• Upgrades
• Built on JDK Technologies
• Java Dynamic Proxies
• JDBC
11

12. ActiveObjects Framework
• Superset of ActiveObjects Library
• Plugin data in the application database
• Adds support for Atlassian application lifecycle
• Backup/Restore
• SAL Transactions
• Plugin lifecycle
12

13. AO Library vs Framework
• ActiveObjects Library
• net.java.ao*
• http://java.net/projects/activeobjects/pages/Home
• ActiveObjects Framework
• com.atlassian.activeobjects*
• https://studio.atlassian.com/wiki/display/AO
13

14. Supported Products
• FishEye 2.7.0 and above
• Crucible 2.7.0 and above
• JIRA 4.4 and above
14

15. ActiveObjects Philosophy
• Implements Active Record Pattern
• Class/Interface maps to a table
• Object instance maps to a row in the table
• Ruby on Rails, Django, CakePHP use this pattern
15

16. Getting Started
16

17. pom.xml
17

18. atlassian-plugin.xml
18

19. Defining an Entity
19

20. Defining an Entity
• Interface
• Extends RawEntity (or subclass)
20

21. Entity interface
21

22. RawEntity interface
22

23. Entity -> SQL Table
23

24. Entity -> SQL Table
24

25. CRUD
Create Read
Update Delete
25

26. Create
26

27. Read
27

28. Read
28

29. Update
29

30. Delete
30

31. Transactions
31

32. The Second Problem
• Change Model between versions
• Data Migration
• Upgrades already run
32

33. Upgrade Tasks
• Versioned
• Schema Migrations
• Data population / manipulation
33

34. atlassian-plugin.xml
34

35. ActiveObjectsUpgradeTask
35

36. Importing Data
36

37. Adding / Deleting
• Entity
• Add / Remove from ao.migrate call
• Field
• Add / Remove from Entity definition
37

38. Renaming
38

39. Renaming
39

40. Renaming
40

41. Renaming
41

42. Renaming
42

43. Third First Problem
• Test the code
• Multiple Databases
• More Power & Trust -> More Responsibility
43

44. pom.xml
44

45. ActiveObjectsJUnitRunner
45

46. Initialising Data
46

47. Targeting a Database
• May have specific requirements
• Target all supported Databases
• Set database via a Java property
• -Dao.test.database=oracle
47

48. Takeaways
• Set up ActiveObjects in your plugin
• Build & evolve complex data structures
• Unit test it against specific databases
48

49. Contact Me
• http://answers.atlassian.com
• Tag with active-objects
• Twitter: @j_hinch
• https://studio.atlassian.com/browse/AO
49

50. Thank you!