Package org.neo4j.cypherdsl.core

Class Cypher

  • @API(status=EXPERIMENTAL,
     since="1.0")
public final class Cypher
extends java.lang.Object
    The main entry point into the Cypher DSL. The Cypher Builder API is intended for framework usage to produce Cypher statements required for database operations.
    Since:
    1.0
    Author:
    Michael J. Simons, Gerrit Meier

    • Method Detail

      • node

        public static Node node​(java.lang.String primaryLabel,
                        java.lang.String... additionalLabels)
        Create a new Node representation with at least one label, the "primary" label. This is required. All other labels are optional.
        Parameters:
        primaryLabel - The primary label this node is identified by.
        additionalLabels - Additional labels
        Returns:
        A new node representation

      • node

        public static Node node​(java.lang.String primaryLabel,
                        java.util.List<java.lang.String> additionalLabels)

      • node

        public static Node node​(java.lang.String primaryLabel,
                        MapExpression properties,
                        java.lang.String... additionalLabels)

      • anyNode

        public static Node anyNode()
        Returns:
        A node matching any node.

      • asterisk

        public static Asterisk asterisk()
        Returns:
        The * wildcard literal.

      • anyNode

        public static Node anyNode​(java.lang.String symbolicName)
        Parameters:
        symbolicName - The new symbolic name
        Returns:
        A node matching any node with the symbolic the given symbolicName.

      • anyNode

        public static Node anyNode​(SymbolicName symbolicName)
        Parameters:
        symbolicName - The new symbolic name
        Returns:
        A node matching any node with the symbolic the given symbolicName.

      • property

        public static Property property​(java.lang.String containerName,
                                java.lang.String name)
        Dereferences a property for a symbolic name, most likely pointing to a property container like a node or a relationship.
        Parameters:
        containerName - The symbolic name of a property container
        name - The name of the property to dereference
        Returns:
        A new property

      • property

        public static Property property​(Expression expression,
                                java.lang.String name)
        Dereferences a property on a arbitrary expression.
        Parameters:
        expression - The expression that describes some sort of accessible map
        name - The name of the property to dereference
        Returns:
        A new property.

      • path

        public static NamedPath.OngoingDefinitionWithName path​(java.lang.String name)
        Starts defining a named path by indicating a name.
        Parameters:
        name - The name of the new path
        Returns:
        An ongoing definition of a named path
        Since:
        1.1

      • path

        public static NamedPath.OngoingDefinitionWithName path​(SymbolicName name)
        Starts defining a named path by indicating a name.
        Parameters:
        name - The name of the new path
        Returns:
        An ongoing definition of a named path
        Since:
        1.1

      • shortestPath

        public static NamedPath.OngoingShortestPathDefinitionWithName shortestPath​(java.lang.String name)
        Starts defining a named path defined by the shortestPath between a relationship by indicating a name.
        Parameters:
        name - The name of the new shortestPath path
        Returns:
        An ongoing definition of a named path
        Since:
        1.1.1

      • shortestPath

        public static NamedPath.OngoingShortestPathDefinitionWithName shortestPath​(SymbolicName name)
        Starts defining a named path defined by the shortestPath between a relationship by indicating a name.
        Parameters:
        name - The name of the new shortestPath path
        Returns:
        An ongoing definition of a named path
        Since:
        1.1.1

      • name

        public static SymbolicName name​(java.lang.String value)
        Creates a new symbolic name.
        Parameters:
        value - The value of the symbolic name
        Returns:
        A new symbolic name

      • parameter

        public static Parameter parameter​(java.lang.String name)
        Creates a new parameter placeholder. Existing $-signs will be removed.
        Parameters:
        name - The name of the parameter, must not be null
        Returns:
        The new parameter

      • optionalMatch

        public static StatementBuilder.OngoingReadingWithoutWhere optionalMatch​(PatternElement... pattern)
        Prepares an optional match statement.
        Parameters:
        pattern - The patterns to match
        Returns:
        An ongoing match that is used to specify an optional where and a required return clause

      • match

        public static StatementBuilder.OngoingReadingWithoutWhere match​(PatternElement... pattern)
        Starts building a statement based on a match clause. Use node(String, String...) and related to retrieve a node or a relationship, which both are pattern elements.
        Parameters:
        pattern - The patterns to match
        Returns:
        An ongoing match that is used to specify an optional where and a required return clause

      • create

        public static <T extends StatementBuilder.OngoingUpdate & StatementBuilder.ExposesSet> T create​(PatternElement... pattern)
        Starts building a statement based on a CREATE clause.
        Type Parameters:
        T - The type of the next step
        Parameters:
        pattern - The patterns to create
        Returns:
        An ongoing CREATE that can be used to specify WITH and RETURNING etc.

      • with

        public static StatementBuilder.OrderableOngoingReadingAndWith with​(AliasedExpression... expressions)
        Starts a statement with a leading WITH. Those are useful for passing on lists of various type that can be unwound later on etc. A leading WITH cannot be used with patterns obviously and needs its arguments to have an alias.
        Parameters:
        expressions - One ore more aliased expressions.
        Returns:
        An ongoing with clause.

      • merge

        public static <T extends StatementBuilder.OngoingUpdate & StatementBuilder.ExposesSet> T merge​(PatternElement... pattern)
        Starts building a statement based on a MERGE clause.
        Type Parameters:
        T - The type of the next step
        Parameters:
        pattern - The patterns to merge
        Returns:
        An ongoing MERGE that can be used to specify WITH and RETURNING etc.

      • unwind

        public static StatementBuilder.OngoingUnwind unwind​(Expression expression)
        Starts building a statement starting with an UNWIND clause. The expression needs to be an expression evaluating to a list, otherwise the query will fail.
        Parameters:
        expression - The expression to unwind
        Returns:
        An ongoing UNWIND.

      • sort

        public static SortItem sort​(Expression expression)
        Creates a new SortItem to be used as part of an Order.
        Parameters:
        expression - The expression by which things should be sorted
        Returns:
        A sort item, providing means to specify ascending or descending order

      • mapOf

        public static MapExpression mapOf​(java.lang.Object... keysAndValues)
        Creates a map of expression from a list of key/value pairs.
        Parameters:
        keysAndValues - A list of key and values. Must be an even number, with alternating String and Expression
        Returns:
        A new map expression.

      • literalOf

        public static <T> Literal<T> literalOf​(java.lang.Object object)
        Creates a new Literal<?> from the given object.
        Parameters:
        object - the object to represent.
        Returns:
        a new Literal<?>.
        Throws:
        java.lang.IllegalArgumentException - when the object cannot be represented as a literal

      • literalTrue

        public static Literal<java.lang.Boolean> literalTrue()
        Returns:
        The true literal.

      • literalFalse

        public static Literal<java.lang.Boolean> literalFalse()
        Returns:
        The false literal.

      • returning

        public static StatementBuilder.OngoingReadingAndReturn returning​(Expression... expressions)
        A RETURN statement without a previous match.
        Parameters:
        expressions - The expressions to return
        Returns:
        A buildable statement
        Since:
        1.0.1

      • quote

        public static java.lang.String quote​(java.lang.String unquotedString)
        Escapes and quotes the unquotedString for safe usage in Neo4j-Browser and Shell.
        Parameters:
        unquotedString - An unquoted string
        Returns:
        A quoted string with special chars escaped.

      • caseExpression

        public static Case caseExpression()
        Returns:
        generic case expression start

      • caseExpression

        public static Case caseExpression​(Expression expression)
        Parameters:
        expression - initial expression for the simple case statement
        Returns:
        simple case expression start

      • call

        public static ProcedureCall.OngoingStandaloneCallWithoutArguments call​(java.lang.String procedureName)
        Starts defining a procedure call of the procedure with the given procedureName. That procedure name might be fully qualified - that is, including a namespace - or just a simple name.
        Parameters:
        procedureName - The procedure name of the procedure to call. Might be fully qualified.
        Returns:
        An ongoing definition of a call

      • call

        public static ProcedureCall.OngoingStandaloneCallWithoutArguments call​(java.lang.String... namespaceAndProcedure)
        Starts defining a procedure call of the procedure with the given qualified name.
        Parameters:
        namespaceAndProcedure - The procedure name of the procedure to call.
        Returns:
        An ongoing definition of a call

      • subList

        public static Expression subList​(Expression targetExpression,
                                 java.lang.Integer start,
                                 java.lang.Integer end)
        Creates a closed range with given boundaries.
        Parameters:
        targetExpression - The target expression for the range
        start - The inclusive start
        end - The exclusive end
        Returns:
        A range literal.
        Since:
        2020.1.0

      • subList

        public static Expression subList​(Expression targetExpression,
                                 Expression start,
                                 Expression end)
        Creates a closed range with given boundaries.
        Parameters:
        targetExpression - The target expression for the range
        start - The inclusive start
        end - The exclusive end
        Returns:
        A range literal.
        Since:
        2020.1.0

      • subListFrom

        public static Expression subListFrom​(Expression targetExpression,
                                     java.lang.Integer start)
        Creates an open range starting at start.
        Parameters:
        targetExpression - The target expression for the range
        start - The inclusive start
        Returns:
        A range literal.
        Since:
        2020.1.0

      • subListFrom

        public static Expression subListFrom​(Expression targetExpression,
                                     Expression start)
        Creates an open range starting at start.
        Parameters:
        targetExpression - The target expression for the range
        start - The inclusive start
        Returns:
        A range literal.
        Since:
        2020.1.0

      • subListUntil

        public static Expression subListUntil​(Expression targetExpression,
                                      java.lang.Integer end)
        Creates an open range starting at start.
        Parameters:
        targetExpression - The target expression for the range
        end - The exclusive end
        Returns:
        A range literal.
        Since:
        2020.1.0

      • subListUntil

        public static Expression subListUntil​(Expression targetExpression,
                                      Expression end)
        Creates an open range starting at start.
        Parameters:
        targetExpression - The target expression for the range
        end - The exclusive end
        Returns:
        A range literal.
        Since:
        2020.1.0

      • valueAt

        public static ListOperator valueAt​(Expression targetExpression,
                                   java.lang.Integer index)
        Creates a single valued range at index.
        Parameters:
        targetExpression - The target expression for the range
        index - The index of the range
        Returns:
        A range literal.
        Since:
        2020.1.0

      • valueAt

        public static ListOperator valueAt​(Expression targetExpression,
                                   Expression index)
        Creates a single valued range at index.
        Parameters:
        targetExpression - The target expression for the range
        index - The index of the range
        Returns:
        A range literal.
        Since:
        2020.1.0