IObjectRepositorySimple.cs

using dotSpace.Interfaces.Space;
using System.Collections.Generic;
using System;

namespace dotSpace.Interfaces.Network
{
    /// <summary>
    /// Defines the methods that allow operations on multiple tuple spaces.
    /// These methods are used for supporting networked tuple spaces.
    /// </summary>
    public interface IObjectRepositorySimple
    {
        /// <summary>
        /// Adds a new Gate to the repository based on the provided connectionstring.
        /// </summary>
        void AddGate(string connectionstring);
        /// <summary>
        /// Adds a new Space to the repository, identified by the specified parameter.
        /// </summary>
        void AddSpace(string identifier, IObjectSpaceSimple tuplespace);
        /// <summary>
        /// Returns the local instance of the space identified by the parameter.
        /// </summary>
        IObjectSpaceSimple GetSpace(string target);
        /// <summary>
        /// Retrieves and removes the first object of type T from the target Space, matching the specified condition. The operation will block if no elements match.
        /// </summary>
        T Get<T>(string target);
        /// <summary>
        /// Retrieves and removes the first object of type T from the target Space, matching the specified condition. The operation is non-blocking. The operation will return null if no elements match.
        /// </summary>
        T GetP<T>(string target);
        /// <summary>
        /// Retrieves and removes all objects of type T from the target Space matching the specified condition. The operation is non-blocking. The operation will return an empty set if no elements match.
        /// </summary>
        IEnumerable<T> GetAll<T>(string target);
        /// <summary>
        /// Retrieves the first object of type T from the target Space, matching the specified condition. The operation will block if no elements match.
        /// </summary>
        T Query<T>(string target);
        /// <summary>
        /// Retrieves the first object of type T from the target Space, matching the specified condition. The operation is non-blocking. The operation will return null if no elements match.
        /// </summary>
        T QueryP<T>(string target);
        /// <summary>
        /// Retrieves all objects of type T from the target Space matching the specified condition. The operation is non-blocking. The operation will return an empty set if no elements match.
        /// </summary>
        IEnumerable<T> QueryAll<T>(string target);
        /// <summary>
        /// Inserts the object of type T passed as argument into the target Space.
        /// </summary>
        void Put<T>(string target, T element);
    }
}