org.neo4j.driver.internal.messaging.request.RouteMessage Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of neo4j-java-driver Show documentation
Access to the Neo4j graph database through Java
There is a newer version: 5.27.0
/*
 * Copyright (c) "Neo4j"
 * Neo4j Sweden AB [http://neo4j.com]
 *
 * This file is part of Neo4j.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.neo4j.driver.internal.messaging.request;

import java.util.Map;
import java.util.Objects;
import java.util.Optional;

import org.neo4j.driver.Bookmark;
import org.neo4j.driver.Value;
import org.neo4j.driver.internal.messaging.Message;

import static java.util.Collections.unmodifiableMap;

/**
 * From the application point of view it is not interesting to know about the role a member plays in the cluster. Instead, the application needs to know which
 * instance can provide the wanted service.
 * 
 * This message is used to fetch this routing information.
 */
public class RouteMessage implements Message
{
    public final static byte SIGNATURE = 0x66;
    private final Map routingContext;
    private final Bookmark bookmark;
    private final String databaseName;
    private final String impersonatedUser;

    /**
     * Constructor
     *
     * @param routingContext   The routing context used to define the routing table. Multi-datacenter deployments is one of its use cases.
     * @param bookmark         The bookmark used when getting the routing table.
     * @param databaseName     The name of the database to get the routing table for.
     * @param impersonatedUser The name of the impersonated user to get the routing table for, should be {@code null} for non-impersonated requests
     */
    public RouteMessage( Map routingContext, Bookmark bookmark, String databaseName, String impersonatedUser )
    {
        this.routingContext = unmodifiableMap( routingContext );
        this.bookmark = bookmark;
        this.databaseName = databaseName;
        this.impersonatedUser = impersonatedUser;
    }

    public Map getRoutingContext()
    {
        return routingContext;
    }

    public Optional getBookmark()
    {
        return Optional.ofNullable( bookmark );
    }

    public String getDatabaseName()
    {
        return databaseName;
    }

    public String getImpersonatedUser()
    {
        return impersonatedUser;
    }

    @Override
    public byte signature()
    {
        return SIGNATURE;
    }

    @Override
    public String toString()
    {
        return String.format( "ROUTE %s %s %s %s", routingContext, bookmark, databaseName, impersonatedUser );
    }

    @Override
    public boolean equals( Object o )
    {
        if ( this == o )
        {
            return true;
        }
        if ( o == null || getClass() != o.getClass() )
        {
            return false;
        }
        RouteMessage that = (RouteMessage) o;
        return routingContext.equals( that.routingContext ) &&
               Objects.equals( databaseName, that.databaseName ) &&
               Objects.equals( impersonatedUser, that.impersonatedUser );
    }

    @Override
    public int hashCode()
    {
        return Objects.hash( routingContext, databaseName, impersonatedUser );
    }
}