content: /*
   * Licensed to the Apache Software Foundation (ASF) under one
   * or more contributor license agreements.  See the NOTICE file
   * distributed with this work for additional information
   * regarding copyright ownership.  The ASF licenses this file
   * to you 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 com.datastax.oss.driver.api.core;
  
  import com.datastax.dse.driver.api.core.DseProtocolVersion;
  import com.datastax.oss.driver.api.core.detach.Detachable;
  import edu.umd.cs.findbugs.annotations.NonNull;
  
  /**
   * A version of the native protocol used by the driver to communicate with the server.
   *
   * <p>The only reason to model this as an interface (as opposed to an enum type) is to accommodate
   * for custom protocol extensions. If you're connecting to a standard Apache Cassandra cluster, all
   * {@code ProtocolVersion}s are {@link DefaultProtocolVersion} instances.
   */
  public interface ProtocolVersion {
  
    ProtocolVersion V3 = DefaultProtocolVersion.V3;
    ProtocolVersion V4 = DefaultProtocolVersion.V4;
    ProtocolVersion V5 = DefaultProtocolVersion.V5;
    ProtocolVersion V6 = DefaultProtocolVersion.V6;
    ProtocolVersion DSE_V1 = DseProtocolVersion.DSE_V1;
    ProtocolVersion DSE_V2 = DseProtocolVersion.DSE_V2;
  
    /** The default version used for {@link Detachable detached} objects. */
    // Implementation note: we can't use the ProtocolVersionRegistry here, this has to be a
    // compile-time constant.
    ProtocolVersion DEFAULT = DefaultProtocolVersion.V5;
  
    /**
     * A numeric code that uniquely identifies the version (this is the code used in network frames).
     */
    int getCode();
  
    /** A string representation of the version. */
    @NonNull
    String name();
  
    /**
     * Whether the protocol version is in a beta status.
     *
     * <p>Beta versions are intended for Cassandra development. They should not be used in a regular
     * application, as beta features may break at any point.
     */
    boolean isBeta();
  }
  