// Copyright 2015 The Vanadium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

/**
 * Package rpc defines interfaces for communication via remote procedure call.
 * <p><ul>
 *   <li>Concept: <a href="https://github.com/vanadium/docs/blob/master/concepts/rpc.md">https://github.com/vanadium/docs/blob/master/concepts/rpc.md</a>.</li>
 *   <li>Tutorial: (forthcoming)</li>
 * </ul><p>
 * There are two actors in the system, clients and servers.  {@link io.v.v23.rpc.Client}s invoke
 * methods on {@link io.v.v23.rpc.Server}s, using the
 * {@link io.v.v23.rpc.Client#startCall startCall} method. {@link io.v.v23.rpc.Server}s implement
 * methods on named objects.  The named object is found using a {@link io.v.v23.rpc.Dispatcher} and
 * the method is invoked using an {@link io.v.v23.rpc.Invoker}.
 * <p>
 * Instances of the {@link io.v.v23.VRuntime} host {@link io.v.v23.rpc.Client}s and
 * {@link io.v.v23.rpc.Server}s; such instances may simultaneously host both
 * {@link io.v.v23.rpc.Client}s and {@link io.v.v23.rpc.Server}s.  The {@link io.v.v23.VRuntime}
 * allows multiple names to be simultaneously supported via the {@link io.v.v23.rpc.Dispatcher}
 * interface.
 * <p>
 * The {@code naming} package provides a rendezvous mechanism for {@link io.v.v23.rpc.Client}s and
 * {@link io.v.v23.rpc.Server}s.  In particular, it allows {@link io.v.v23.VRuntime} hosting
 * {@link io.v.v23.rpc.Server}s to share endpoints with {@link io.v.v23.rpc.Client}s that enables
 * communication between them.  Endpoints encode sufficient addressing information to enable
 * communication.
 */
package io.v.v23.rpc;