Presentation about extending the Oracle JDevelopers Auditing Framework. Presentation from OOW14, including the ADF EMG Audit Rules extension.

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
o runs ojaudit
o converts 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
o Index page for Audit Rules
● www.redheap.com
● www.adfemg.org
o Google Groups
● http://docs.oracle.comJDeveloper Doc (not
ADF documentation)
o Developing Extensions for JDeveloper
o Java API Reference for Extension SDK