-
Notifications
You must be signed in to change notification settings - Fork 2.3k
/
ExecutionEngine.java
134 lines (122 loc) · 5.03 KB
/
ExecutionEngine.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
/*
* Copyright (c) 2002-2016 "Neo Technology,"
* Network Engine for Objects in Lund AB [http://neotechnology.com]
*
* This file is part of Neo4j.
*
* Neo4j is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package org.neo4j.cypher.internal.javacompat;
import java.util.Map;
import org.neo4j.cypher.CypherException;
import org.neo4j.graphdb.GraphDatabaseService;
import org.neo4j.logging.LogProvider;
import org.neo4j.logging.NullLogProvider;
/**
* To run a Cypher query, use this class.
*
* This class construct and initialize both the cypher compiler and the cypher runtime, which is a very expensive
* operation so please make sure this will be constructed only once and properly reused.
*
*/
public class ExecutionEngine
{
private org.neo4j.cypher.internal.ExecutionEngine inner;
/**
* Creates an execution engine around the give graph database
* @param database The database to wrap
*/
public ExecutionEngine( GraphDatabaseService database )
{
inner = createInnerEngine( database, NullLogProvider.getInstance() );
}
/**
* Creates an execution engine around the give graph database
* @param database The database to wrap
* @param logProvider A {@link LogProvider} for cypher-statements
*/
public ExecutionEngine( GraphDatabaseService database, LogProvider logProvider )
{
inner = createInnerEngine( database, logProvider );
}
protected org.neo4j.cypher.internal.ExecutionEngine createInnerEngine( GraphDatabaseService database, LogProvider logProvider )
{
return new org.neo4j.cypher.internal.ExecutionEngine( database, logProvider );
}
/**
* Executes a query and returns an iterable that contains the result set
* @param query The query to execute
* @return A ExecutionResult that contains the result set
* @throws org.neo4j.cypher.SyntaxException If the Query contains errors,
* a SyntaxException exception might be thrown
*/
public ExecutionResult execute( String query ) throws CypherException
{
return new ExecutionResult( inner.execute( query ) );
}
/**
* Executes a query and returns an iterable that contains the result set
* @param query The query to execute
* @param params Parameters for the query
* @return A ExecutionResult that contains the result set
* @throws org.neo4j.cypher.SyntaxException If the Query contains errors,
* a SyntaxException exception might be thrown
*/
public ExecutionResult execute( String query, Map<String, Object> params) throws CypherException
{
return new ExecutionResult( inner.execute( query, params ) );
}
/**
* Profiles a query and returns an iterable that contains the result set.
* Note that in order to gather profiling information, this actually executes
* the query as well. You can wrap a call to this in a transaction that you
* roll back if you don't want the query to have an actual effect on the data.
*
* @param query The query to profile
* @return A ExecutionResult that contains the result set
* @throws org.neo4j.cypher.SyntaxException If the Query contains errors,
* a SyntaxException exception might be thrown
*/
public ExecutionResult profile( String query ) throws CypherException
{
return new ExecutionResult( inner.profile( query ) );
}
/**
* Profiles a query and returns an iterable that contains the result set.
* Note that in order to gather profiling information, this actually executes
* the query as well. You can wrap a call to this in a transaction that you
* roll back if you don't want the query to have an actual effect on the data.
*
* @param query The query to profile
* @param params Parameters for the query
* @return A ExecutionResult that contains the result set
* @throws org.neo4j.cypher.SyntaxException If the Query contains errors,
* a SyntaxException exception might be thrown
*/
public ExecutionResult profile( String query, Map<String, Object> params) throws CypherException
{
return new ExecutionResult( inner.profile( query, params ) );
}
/**
* Turns a valid Cypher query and returns it with keywords in uppercase,
* and new-lines in the appropriate places.
*
* @param query The query to make pretty
* @return The same query, but prettier
*/
public String prettify( String query )
{
return inner.prettify( query );
}
}