com.hp.hpl.jena.sparql.mgt
Class Explain

java.lang.Object
  extended by com.hp.hpl.jena.sparql.mgt.Explain

public class Explain
extends Object

Execution logging for query processing on a per query basis. This class provides an overlay on top of the system logging to provide control of log message down to a per query basis. The associated logging channel must also be enabled. An execution can detail the query, the algebra and every point at which the dataset is touched. Caution: logging can be a significant cost for small queries and for memory-backed datasets because of formatting the output and disk or console output overhead.

See Also:
ARQ.logExec, ARQ.getExecutionLogging(), ARQ.setExecutionLogging(com.hp.hpl.jena.sparql.mgt.Explain.InfoLevel)

Nested Class Summary
static class Explain.InfoLevel
          Information level for query execution.
 
Field Summary
static org.slf4j.Logger logExec
           
static org.slf4j.Logger logInfo
           
static boolean MultiLineMode
          Control whether messages include multiple line output.
 
Constructor Summary
Explain()
           
 
Method Summary
static void explain(BasicPattern bgp, Context context)
           
static void explain(Context context, String message)
           
static void explain(Context context, String format, Object... args)
           
static void explain(com.hp.hpl.jena.graph.Node s, Path path, com.hp.hpl.jena.graph.Node o, Context context)
           
static void explain(Op op, Context context)
           
static void explain(Query query, Context context)
           
static void explain(String message, BasicPattern bgp, Context context)
           
static void explain(String message, com.hp.hpl.jena.graph.Node s, Path path, com.hp.hpl.jena.graph.Node o, Context context)
           
static void explain(String message, Op op, Context context)
           
static void explain(String message, QuadPattern quads, Context context)
           
static void explain(String message, Query query, Context context)
           
static boolean explaining(Explain.InfoLevel level, org.slf4j.Logger logger, Context context)
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

MultiLineMode

public static boolean MultiLineMode
Control whether messages include multiple line output. In multiple line output, subsequent lines start with a space to help log file parsing.


logExec

public static final org.slf4j.Logger logExec

logInfo

public static final org.slf4j.Logger logInfo
Constructor Detail

Explain

public Explain()
Method Detail

explain

public static void explain(Query query,
                           Context context)

explain

public static void explain(String message,
                           Query query,
                           Context context)

explain

public static void explain(Op op,
                           Context context)

explain

public static void explain(String message,
                           Op op,
                           Context context)

explain

public static void explain(BasicPattern bgp,
                           Context context)

explain

public static void explain(String message,
                           BasicPattern bgp,
                           Context context)

explain

public static void explain(String message,
                           QuadPattern quads,
                           Context context)

explain

public static void explain(Context context,
                           String message)

explain

public static void explain(Context context,
                           String format,
                           Object... args)

explaining

public static boolean explaining(Explain.InfoLevel level,
                                 org.slf4j.Logger logger,
                                 Context context)

explain

public static void explain(com.hp.hpl.jena.graph.Node s,
                           Path path,
                           com.hp.hpl.jena.graph.Node o,
                           Context context)

explain

public static void explain(String message,
                           com.hp.hpl.jena.graph.Node s,
                           Path path,
                           com.hp.hpl.jena.graph.Node o,
                           Context context)


Licenced under the Apache License, Version 2.0