GraphConnect Europe 2016 buschmais

1. by
Lightning Talk @ GraphConnect Europe
26th April 2016
Dirk Mahler, buschmais GbR

2. 2
 I‘m a Java developer
 I‘m a human
 I make mistakes
 I need fast feedback
 I use analysis tools in my build chain
 They‘re valuable, but…
Maven
Enforcer Plugin
PMD
FindBugs
Checkstyle
…

3. 3
tunnel
vision

4. 4
closed set of
rules & metrics

5. 5
opinionated rules

6. 6
low level
of abstraction

7. 7
closed
data models

8. 8
(jQAssistant:Tool)-[:USES]->(neo4j:Graph:Database)
http://jqassistant.org
http://neo4j.org

9. 9
 Scan software structures
 Store in a database
 Execute queries
 Explore
 Add high level concepts
 Find constraint violations
 Create Reports
Neo4j

10. 10
connected
extensible
natural

11. 11
Maven
CREATES
Project
Web
Artifact
Beans
HAS_INTERCEPTOR
Xml
Java
Type
Java
Method
CONTAINS
DECLARES
Maven
Xml
Java
Provided by
plugins

12. 12
accessible

13. 13
(project:Maven:Project)-[:CREATES]->(war:Web:Artifact)
(war)-[:CONTAINS]->(beans:Beans:Xml)
(beans)-[:HAS_INTERCEPTOR]->(type:Java:Type)
(type:Java:Type)-[:DECLARES]->(method:Java:Method)

14. 14
multi dimensional

15. Maven
Repository
CONTAINS_ARTIFACT
Web
Artifact
Java
Type
CONTAINS
CONTAINS_ARTIFACT
Web
Artifact
Java
Type
CONTAINS
HAS_PREDECESSORHAS_PREDECESSOR

16. 16
concrete
&
abstract

17. 17
Type
Class
Annotation
ANNOTATED_BY
Type
OF_TYPE
Entity
Jpa
MATCH
(entity:Type)-[:ANNOTATED_BY]->(annotation),
(annotation)-[:OF_TYPE)->(:Type{fqn:"javax.persistence.Entity"})
SET
entity:Jpa:Entity
RETURN
entity.fqn
Concept

18. 18
MATCH
(package:Package)-[:CONTAINS]->(entity:Jpa:Entity)
WHERE
package.name <> "model"
RETURN
package.fqn, collect(entity.fqn)
Constraint

19. 19
MATCH
(service:Spring:Service)-[:DEPENDS_ON]->(other:Spring:Type)
WHERE NOT
other:Service
or other:Repository // Controller is disallowed
RETURN
service.fqn as Service, collect(other.fqn) as ForbiddenDeps

20. 20
rules = queries

21. 21
[[model:JpaEntityInModelPackage]]
.All JPA entities must be located in packages named "model".
[source,cypher,role=constraint,requiresConcepts="jpa2:Entity"]
----
MATCH
(package:Package)-[:CONTAINS]->(entity:Jpa:Entity)
WHERE
package.name <> "model"
RETURN
entity AS EntityInWrongPackage
----
Asciidoc

22. 22
documentation = rules

23. 23

24. 24
 Holistic and extensible view on code structure and system
architecture
 Exploration of existing structures
 Validation of rules using concepts from architecture & design
language
 Executable architecture and design specification

25. Mail: info@jqassistant.org
Web: jqassistant.org
Twitter: @jqassistant
by