2. Starting on Stash
STEFAN KOHLER
•
CONSULTANT
•
42 BV
•
@STEFANKOHLER

3. Who am I

4. Stefan Kohler
• Atlassian Expert
• Add-on Developer and
CodeGeist addict
• AUG Founder
• Author of Confluence book
http://amzn.to/15xQIiT

5. Notifyr

6. Just text by itself, for
impact.

7. Badgr

8. Just text by itself, for
impact.

9. The Idea

10. Write down your ideas,
to make them real and
make room for new ideas

11. Research your idea
• Another add-on available?
• It is a requested feature?
• JIRA
• Answers
• Contact a Product Manager

12. JIRA Votes

13. Notifyr Idea

14. Getting Hooked
H ooks
Ev ent s
Indexer

15. HOOKS
Custom scripts that are
executed when certain
actions occur.

16. Repository Hooks

17. SECTION TITLE 1
HOOKS
Available Hooks
• Pre-receive
BLOCKING
• Asynchronous Post-receive
• Merge-checks
BLOCKING

18. SECTION TITLE 1
HOOKS
Pre receive hook
atlassian-plugin.xml
<pre-receive-hook
key="mySummitHook"
name="Summit 2013 Pre-receive Hook"
class="nl.stefankohler.stash.hook.MySummitHook">
<description>
A pre-receive hook that will block all actions
after the Summit Bash
</description>
</pre-receive-hook>

19. SECTION TITLE 1
HOOKS
Pre receive hook
MySummitHook.java
public class MySummitHook implements PreReceiveHook {
/**
* Disables all actions after the Summit Bash.
*/
@Override
public boolean onReceive(Repository repository,
Collection<RefChange> refChanges,
HookResponse hookResponse) {
DateTime summitBash = new DateTime(2013, 10, 2, 19, 0);
if (summitBash.isBeforeNow()) {
hookResponse.err.println("Pushing is disabled " +
"after the Summit Bash, don't drink & code!");
return false;
}
return true;
}
}

20. Getting Hooked
H ooks
Ev ent s
Indexer

21. EVENTS
Events are triggered
throughout Stash, just
listen for them!

22. S E C TEO NNT IS L E 1
I VE T T
Available Events

23. EVENTS
Repository Push Event
atlassian-plugin.xml
<component
key="MySummitPushEvent"
class="nl.stefankohler.stash.events.MySummitPushEvent"
/>

24. EVENTS
Repository Push Event
MySummitPushEvent.java
public class MySummitPushEvent {
@EventListener
public void notifyTwitter(
RepositoryPushEvent pushEvent) {
}
}
twitterClient.tweet("A push was made to " +
pushEvent.getRepository())

25. Getting Hooked
H ooks
Ev ent s
Indexer

26. INDEXER
Get in the Stash indexing
pipeline to get data from,
or add data to a commit

27. INDEXER

28. INDEXER
Dos & Don’ts
Don’t do expensive operations
Don’t handle the same changeset twice
Do consider memory usage
Do consider bulk processing
Do consider security

29. INDEXER
Changeset Indexer
atlassian-plugin.xml
<changeset-indexer
key="SummitIndexer"
class="nl.stefankohler.stash.indexer.SummitIndexer"
/>

30. INDEXER
Changeset Indexer
SummitIndexer.java
public class SummitIndexer implements ChangesetIndexer {
...
@Override
public void onChangesetAdded(
@Nonnull Changeset changeset,
@Nonnull IndexingContext ctx) {
if (changeset.getMessage().contains("summit")) {
ctx.put("duringSummit", true);
}
}
...
}

31. Got Service?

32. Services allow you to get
and add data from and to
Stash

33. Services
Users
UserService
Change history
HistoryService
Project
ProjectService
Repository
RepositoryServic

34. Services
https://developer.atlassian.com/static/
javadoc/stash/latest/api

35. Access to services
public class BadgrChangesetIndex implements ChangesetIndexer {
public BadgrChangesetIndex(
HistoryService historyService,
LoggingService loggingService) {
}
}
this.historyService = checkNotNull(historyService);
...

36. Look the part

37. Atlassian Design Guidelines

38. Soy is the best thing that
happened to templates

39. Soy
• One template for server and client side
• Separation between logic and display
• Reuse of widgets
• JavaScript

40. AUI comes with Soy widgets!

41. Next...

42. Documentation and Examples

43. Resources
• http://developer.atlassian.com
• http://developer.atlassian.com/design
• https://developer.atlassian.com/stash/
• Use the source code for examples and reference
#atlassiansummit

44. Thank you!
STEFAN KOHLER
•
CONSULTANT
•
42 BV
•
@STEFANKOHLER

45. Rate this Talk
Starting on Stash
Text code below to 22333
or visit http://bit.ly/19JRN5S
MEH = Z
NO T BA D = 10
P R ET T Y GO O D = 11
A WES O ME = 12
To join this session, send text 136888 to