Download to read offline
![xdat_core & Maven $ cd xdat_core $ mvn clean install [INFO] Scanning for projects... ... [INFO] BUILD SUCCESSFUL 24](https://image.slidesharecdn.com/xnatopensource-100701162918-phpapp01/75/XNAT-Open-Source-Development-24-2048.jpg)
XNAT Open Source Development
- 1. XNAT Custom Features &Open Source Development John Paulett jpaulett@wustl.edu June 30, 2010
- 2. Goal Introducepotential contributors to the methods and tools for contributing to XNAT 2
- 3. XNAT is OpenSource! 3
- 4. XNAT is OpenSource! Freedom Leverage others’ work Contribute 4
- 5. HOW CAN ICONTRIBUTE? 5
- 6. Bug Reports &Feature Requests xnat_discussion@googlegroups.com For sensitive issues, bugs@xnat.org Provide details! • Environment • Versions • Steps to reproduce • Screenshots • Logs 6
- 7.
- 8. Share Custom Schemas (JennyGurney’s previous Customizations talk) 8
- 9. Create Something New Leveragethe REST API Examples: PyXNAT, xnatfs 9
- 10. Develop XNAT Fix Bugs AddFeatures 10
- 11.
- 12.
- 13. XNAT Internals xdat_core -org.nrg.xft – translates between XML schema & other formats – XFTItem.java xdat_core - org.nrg.xdat – admin, security, search infrastructure around XFT – Web app structure 13
- 14. XNAT Internals xdat_release/plugin_resources -org.nrg.xnat – REST API – Uploading & Downloading – Neuroimaging specific models xdat_release/projects – Site customizations 14
- 15. 3 TOOLS OFA XNAT DEVELOPER 15
- 16. #1 – VersionControl with Mercurial hg.xnat.org Replacement for CVS & Subversion Distributed (everyone has full repo & can commit) Sane branching & merging 16
- 17. Why Leave CVS? Networkconnectivity required Lack of support for renaming/moving files Lack of atomic commits Single point of failure Expensive branch operations Day-long merges 17
- 18. Mercurial Quick Start hgclone http://hg.xnat.org/xdat_release # view differences hg diff # commit and send changes to remote repo hg commit hg push # get the latest remote changes hg pull --update 18
- 19. hg.xnat.org 19
- 20. Integration Manager Workflow blessed developer developer repository public public integration developer developer manager private private 20
- 21.
- 22. #2 – Maven Build& Dependency Management Migrating to Maven 2 – xdat_release & pipelines still use Maven 1 (hidden behind bin/setup.sh) – New projects should use Maven 2 22
- 23. Why not Ant? Dependencymanagement – Reduce blobs in version control system Standardized project layout & commands 23
- 24. xdat_core & Maven $cd xdat_core $ mvn clean install [INFO] Scanning for projects... ... [INFO] BUILD SUCCESSFUL 24
- 25. #2 – EclipseIDE 25
- 26. Useful Eclipse Plugins • Mercurial • Maven • XML Schema Editor • Velocity 26
- 27.
- 28. Debugging with JPDA Connectto external Tomcat & Applet processes with Eclipse debugger Set breakpoints, examine state 28
- 29. Connect Tomcat processwith Eclipse debugger
- 30. DEMO: FIX ABUG & SUBMIT A PATCH 30
- 31. 1) Clone &Set up Projects hg clone http://hg.xnat.org/xdat_core mvn clean install hg clone http://hg.xnat.org/xdat_release ... bin/setup.sh -Ddeploy=true ... 31
- 32. 2) Register inEclipse cp sample.classpath .classpath cp sample.project .project 32
- 33. 3) Fix Code 33
- 36. 4) Test it! 36
- 37. 5) Commit 37
- 38. 6) Publish theChange Options include: • Sending patch file • Forking on Bitbucket 38
- 40.
- 41.
- 43. Go Forth andDevelop http://nrg.wikispaces.com/XNAT+2010+Workshop+- +Custom+Features+and+Open+Source+Development 43
- 44.