CQLinq Performance

JArchitect Documentation

  • Docs
  • CQLinq Performance

CQLinq Performance
This document assumes that you have read the document about the CQLinq syntax. Also please have a look at the wikipedia definition for time complexity if you don't know what this notion means.

CQLinq is designed to run hundreds of queries per seconds against a large real-world code base. This means that most CQLinq queries should be executed in a few milliseconds in theory. In practices, this is true for most queries, but if you look at the set of default CQLinq queries and rules, you'll see that a few of them are executed in a few dozens of milliseconds on large code bases.

The default value for the time-out for CQLinq query execution duration is equals to two seconds, but this value is easily changeable in the Tools > Options > Code Query panel.

While writing the set of dozens of default CQLinq rules and queries, we have adapted the CQLinq design to make sure that it is always possible to run quickly even complex queries. The result of this work is shared in the present document.

Performance is an important topic for CQLinq, because the philosophy of the JArchitect tool is to provide useful feedbacks to the user as quickly as possible, in a few seconds.



Always strive for linear time complexity

When writing a complex query that needs some sort of nested processing, often the most obvious approach is to nest a query inside another one. This is illustrated by the query below, where we are interested to match all methods that calls any method named Add: 

from m in Methods
from users in Methods
where m.SimpleName == @"Add" && users.IsUsingMethod(m)
select users


The problem with this approach is that it leads to query that are executed in a slow polynomial time complexity ( O(#Method^2) here ).

In most cases it is possible to transform a slow polynomial time complexity, into a linear time complexity. For example our query can be rewritten: 

let addMethods =   
   from m in Methods
   where m.SimpleName == @"Add"   
   select m
 
from m in addMethods
from user in m.MethodsCallingMe
select user


The query has now a linear time complexity O(#Methods) and concretely it gets executed in a few milliseconds, instead of several dozens of seconds!
Notice that here we rely on the fact that CQLinq allows a query to begin with a let clause.

Go to top

Use sequence usage operations if possible

Actually, the query obtained in the section above can be rewritten to be even faster and more concise thanks to the method UsingAny(). 

Methods.UsingAny(Methods.WithSimpleName(@"Add")).Select(m => m)


Let's take another example to match types that inherit from any interface defined in the package MyPackage. This can be written this way: 

let types = Packages.WithName("MyPackage").ChildTypes()
from t in Application.Types
from t2 in types 
where t.DeriveFrom(t2)
select t


But by using the extension method ThatDeriveFromAny() tests shows that the rewritten version of query runs 10 times faster. 

Types.ThatDeriveFromAny(
  Packages.WithName("MyPackage").ChildTypes()
).Select(t => t)


The internal optimization of these extension methods is based on the fact that they actually replace a loop. Hence such implementation is free to rely on a smarter algorithm to filter the input sequence faster than with a loop.

Go to top

Declare sub-sets before the main query loop

If you need to query over a sub-set of the code base, make sure to define this sub-set once for all, before the main query loop.
For example the following query... 

from m in Application.Methods where
  m.IsUsing("MyClass.MyMethod()".AllowNoMatch()) ||
  m.IsUsing("MyClass.MyMethod(int)".AllowNoMatch()) ||
  m.IsUsing("MyClass.MyMethod(int,int)".AllowNoMatch())
select m


... can be rewritten this way, to be 5 to 10 times faster. 

let gcCollectMethods = ThirdParty.Methods.WithFullNameIn(
   "MyClass.MyMethod()",
   "MyClass.MyMethod(int)",
   "MyClass.MyMethod(int,int)")
from m in Application.Methods.UsingAny(gcCollectMethods)
select m


Go to top

Rely extensively on hashset

The HashSet<T> class is essential to implement high performance algorithms. Indeed this class represents a collection on which the Contains(T) method is executed in a constant time O(1) (i.e constant no matter the collection size!).

CQLinq offers several extension methods to work more effectively with the HashSet<T> class. The most important one is the method ToHashSet() that transforms any enumerable in a hashset.
When a query relies on set operations (union, intersection...) it is often performance wise to transform enumerables into hashsets. For example, by removing the call to the extension method ToHashSet(), the following queries is more than 200 times slower! 

// <Name>Callers of refactored methods</Name>
let refactoredMethods = Application.Methods.Where(m => m.CodeWasChanged()).ToHashSet() 
from caller in Application.Methods.UsingAny(refactoredMethods)
let refactoredMethodsCalled = caller.MethodsCalled.Intersect(refactoredMethods)
where refactoredMethodsCalled.Count() > 0
select new { caller, refactoredMethodsCalled }


Go to top

Avoid many let clauses in the main query loop

Defining a range variable through a let clause is a convenient syntax possibility offered by CQLinq. The problem is that this syntax bonus can significantly slow down query execution because under the hood, each let clause forces to create a new object and copy all values already obtained before its declaration.

So we have here a trade-off here between performance and syntax elegance. The performance doesn't necessarily win, for example we decided to keep this default rule with 3 let clauses... 

// <Name>CRAP methods</Name>
// Source: http://www.artima.com/weblogs/viewpost.jsp?thread=215899
from method in Application.Methods
where method.CyclomaticComplexity != null && method.PercentageCoverage != null
let CC = method.CyclomaticComplexity 
let uncov = (100 - method.PercentageCoverage) / 100f
let CRAP = (CC * CC * uncov * uncov * uncov) + CC
where CRAP > 30
orderby CRAP descending, method.NbLinesOfCode descending
select new { method, CRAP, CC, uncov, method.PercentageCoverage, method.NbLinesOfCode }


...that is around two times slower than this much less elegant version with a single let clause: 

// <Name>CRAP methods</Name>
// Source: http://www.artima.com/weblogs/viewpost.jsp?thread=215899
from method in Application.Methods
where method.CyclomaticComplexity != null && method.PercentageCoverage != null
let CRAP = (method.CyclomaticComplexity * method.CyclomaticComplexity * 
            ((100 - method.PercentageCoverage) / 100f)* 
            ((100 - method.PercentageCoverage) / 100f)* 
            ((100 - method.PercentageCoverage) / 100f)) + method.CyclomaticComplexity 
where CRAP > 30
orderby CRAP descending, method.NbLinesOfCode descending
select new { method, 
             CRAP, 
             CC = method.CyclomaticComplexity , 
             uncov = ((100 - method.PercentageCoverage) / 100f), 
             method.PercentageCoverage, 
             method.NbLinesOfCode }


Go to top

Performance with many strings constants

It might happen that a query needs to enumerate a list of code elements names to match them. For example: 

from t in Types where
t.Name == "int" || t.Name == "Uint" || t.Name == "Int16" || t.Name == "UInt16" ||
t.Name == "Int64" || t.Name == "UInt64" || t.Name == "Byte" || t.Name == "SByte" ||
t.Name == "Single" || t.Name == "Double" || t.Name == "Decimal"
select t


On a very large code base with 50.000 types this query takes 25ms at best to run. A small optimization is possible to avoid calling again and again the property Name on t by using an override of the method EqualsAny(): 

from t in Types where
t.Name.EqualsAny("int","Uint", "Int16","UInt16", 
                 "Int16","UInt16", "Byte","SByte",
                 "Single","Double", "Decimal")
select t


Now, this version of the query takes at best 20ms to run. The small performance gain is compensated by the fact that the 9 string parameters are passed again and again to the method EqualsAny().

An idea is to use an instance of HashSet<string> to get a string comparison in a constant time: 

let hashset = new [] { "int","Uint", "Int16","UInt16", 
                       "Int16","UInt16", "Byte","SByte",
                       "Single","Double", "Decimal" }.ToHashSet()
from t in Types where
hashset.Contains(t.Name)
select t


Unfortunatly this version is much slower with a best run time equals to 150ms, because under the hood, the let clause provoques a performance hit for each loop. If we were facing dozens of string constants to compare with, this version with HashSet could end up being faster.

CQlinq provides the method WithNameIn() that can be used this way: 

Types.WithNameIn("int","Uint", "Int16","UInt16", 
                 "Int16","UInt16", "Byte","SByte",
                 "Single","Double", "Decimal").Select(t => t)


This version is now much faster with a best run time of 12ms because it removes the need for a CQLinq loop, and internally replaces it with a faster loop based on the for syntax, coupled with the usage of a HashSet<string> without the let performance hit.

Go to top