Quality Assurance doesn’t always get the attention it needs during a project. Maintaining and enforcing organization defined quality rules can be seen as a chore. Having code quality audited while coding is much more efficient than manually peer reviewing afterwards. We will not only demonstrate the powerful Oracle JDeveloper built-in auditing tools, but will also show how to extend it with your own auditing rules, create your own automated code fixes, and how to integrate automated auditing with your build automation. This session shows JDeveloper’s Auditing features and other free tools to enable you and your team to consistently deliver high quality code whether it is ADF, SOA, BPM or any other technology supported by JDeveloper.

1. Quality Assurance
Enforcing Code Guidelines by Extending JDeveloper’s Auditing Framework

2. About Us
Richard Olrichs
MN
www.olrichs.nl
@richardolrichs
Wilfred van der Deijl
The Future Group
www.redheap.com
@wilfreddeijl

3. Agenda
●Audit Profiles and Preferences
●Audit JDeveloper Extension Project
●Creating Custom Rules
●SuppressWarnings
●ADF EMG Audit Rules
●Automated QA

5. Aborts Compile On Error

13. Custom Rules

14. Custom Rules
●Setting up JDeveloper Extension Project
●Implementing Custom Rule
●Implementing Custom Fix

15. Setting up JDev Extension Project
●Install Extension SDK (Help>CheckForUpdates)
●File > New > Applications > Extension Application
●extension.xml and MANIFEST.MF
●Bundled as .ZIP
●Can be distributed through custom JDeveloper Update Center (aka network drive or URL)

21. Violation Overload

23. Violation Overload
●Even ADF Sample Application from OTN has 157 issues
●Too many violations cause developers to ignore all of them

24. Violation Overload

25. SuppressWarnings Java Annotation
@SuppressWarnings annotation introduced in Java 1.5 and tells Java Compiler to suppress warnings

26. SuppressWarnings Java Annotation
JDeveloper 12c now also “listens” to annotation and suppresses warnings itself (not only javac)

27. JDeveloper 12c Suppression Scheme
Why not create our own for non-Java (aka XML)?

28. Suppress Warnings in XML

29. Suppress Warnings in XML

32. ADF EMG Audit Rules

37. ADF Code Guidelines Extension
●JDeveloper extension available today
●ADF Code Guidelines auditing during development
●Community project at java.net: adfemg- auditrules
●Contribute and discuss at ADF EMG
●JDeveloper 12c & JDeveloper 11g

38. Automated QA

39. OJAudit
●Command line auditing
●JDEV_HOME/jdev/bin/ojaudit -help
●Output in XML/text/HTML or custom xsl

41. Automated QA
●Simple solution: Run ojaudit from CI server and publish output
●Benefit: Same rules during development and CI QA
●@SuppressWarnings and<!-- SuppressWarning--> keep list of violations short and actionable

42. Automated QA
SonarQube

44. SonarQube
●Tool to manage Code Quality
●Rules, Violations, Metrics, Test Coverage, etc
●Free Open Source
●Initially Java, but now 20+ languages
●Historical data, thus trends
●Highly extensible through plugins

49. ADF EMG SonarQube plugin
●SonarQube plugin
oruns ojaudit
oconverts ojaudit output to SonarQube violations
●www.sonarqube.com for base product
●Watch ADF EMG for availability of plugin
●Not specific to ADF, but for any JDev project
●Tested with JDeveloper 12c, but should work with any version

50. Summary
●Audit Profiles and Preferences
●Creating Custom Rules
●SuppressWarnings JDev Extension
●ADF EMG Audit Rules Extension
●SonarQube ojaudit plugin

51. Further Reading
●www.olrichs.nl
oIndex page for Audit Rules
●www.redheap.com
●www.adfemg.org
oGoogle Groups
●http://docs.oracle.comJDeveloper Doc (not ADF documentation)
oDeveloping Extensions for JDeveloper
oJava API Reference for Extension SDK