dubbo.apache.org/dubbo-go/v3@v3.1.1/cluster/directory/directory.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  package directory
    19  
    20  import (
    21  	"dubbo.apache.org/dubbo-go/v3/common"
    22  	"dubbo.apache.org/dubbo-go/v3/protocol"
    23  )
    24  
    25  // Directory implementations include RegistryDirectory, ServiceDiscoveryRegistryDirectory, StaticDirectory
    26  type Directory interface {
    27  	common.Node
    28  
    29  	// List candidate invoker list for the current Directory.
    30  	// NOTICE: The invoker list returned to the caller may be backed by the same data hold by the current Directory
    31  	// implementation for the sake of performance consideration. This requires the caller of List() shouldn't modify
    32  	// the return result directly.
    33  	List(invocation protocol.Invocation) []protocol.Invoker
    34  
    35  	// Subscribe listen to registry instances
    36  	Subscribe(url *common.URL) error
    37  }