dubbo.apache.org/dubbo-go/v3@v3.1.1/xds/client/pubsub/interface.go (about)

     1  /*
     2   * Licensed to the Apache Software Foundation (ASF) under one or more
     3   * contributor license agreements.  See the NOTICE file distributed with
     4   * this work for additional information regarding copyright ownership.
     5   * The ASF licenses this file to You under the Apache License, Version 2.0
     6   * (the "License"); you may not use this file except in compliance with
     7   * the License.  You may obtain a copy of the License at
     8   *
     9   *     http://www.apache.org/licenses/LICENSE-2.0
    10   *
    11   * Unless required by applicable law or agreed to in writing, software
    12   * distributed under the License is distributed on an "AS IS" BASIS,
    13   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    14   * See the License for the specific language governing permissions and
    15   * limitations under the License.
    16   */
    17  
    18  /*
    19   *
    20   * Copyright 2021 gRPC authors.
    21   *
    22   */
    23  
    24  package pubsub
    25  
    26  import (
    27  	"dubbo.apache.org/dubbo-go/v3/xds/client/resource"
    28  )
    29  
    30  // UpdateHandler receives and processes (by taking appropriate actions) xDS
    31  // resource updates from an APIClient for a specific version.
    32  //
    33  // It's a subset of the APIs of a *Pubsub.
    34  type UpdateHandler interface {
    35  	// NewListeners handles updates to xDS listener resources.
    36  	NewListeners(map[string]resource.ListenerUpdateErrTuple, resource.UpdateMetadata)
    37  	// NewRouteConfigs handles updates to xDS RouteConfiguration resources.
    38  	NewRouteConfigs(map[string]resource.RouteConfigUpdateErrTuple, resource.UpdateMetadata)
    39  	// NewClusters handles updates to xDS Cluster resources.
    40  	NewClusters(map[string]resource.ClusterUpdateErrTuple, resource.UpdateMetadata)
    41  	// NewEndpoints handles updates to xDS ClusterLoadAssignment (or tersely
    42  	// referred to as Endpoints) resources.
    43  	NewEndpoints(map[string]resource.EndpointsUpdateErrTuple, resource.UpdateMetadata)
    44  	// NewConnectionError handles connection errors from the xDS stream. The
    45  	// error will be reported to all the resource watchers.
    46  	NewConnectionError(err error)
    47  }