• Facebook
  • Twitter
  • Youtube
  • LinkedIn
  • RSS
  • 文档
  • 比较
  • 博客
  • 尝试 NCache
  • 联系我们
尝试 NCache
显示/隐藏目录

如何连接到缓存

NCache 应用程序通过以下方式连接到正在运行的缓存: CacheManager.GetCache API。应用程序指定缓存名称,并在需要时提供连接信息,例如服务器端点和安全凭据。如果代码中未提供服务器端点, NCache 从……中读出它们 ncache 应用程序配置部分(appsettings.json, app.config 或 web.config).

以下示例演示了如何连接到单个或多个缓存、指定连接选项、通过负载均衡器连接以及对安全缓存进行身份验证。客户端配置设置由缓存服务器集中管理,而不是通过客户端连接选项进行配置。

警告

从...开始 NCache 5.3.800, CacheConnectionOptions 已弃用,保留仅用于向后兼容。请使用 连接选项 用于配置缓存连接的类。

硬件需求

使用前 NCache 客户端 API 应确保满足以下先决条件:

  • 。NET
  • 爪哇岛
  • Python
  • Node.js
  • 遗留 API
  • 在您的 .NET 客户端应用程序中安装以下 NuGet 包:
    • NCache: Alachisoft.NCache.SDK
    • NCache 开源: Alachisoft.NCache.Opensource.SDK
  • 在您的应用程序中包含以下命名空间:
    • Alachisoft.NCache。客户
    • Alachisoft.NCache.Runtime.Exceptions
  • 缓存必须正在运行。
  • 确保要添加的数据是 可序列化.
  • 有关 API 详细信息,请参阅: 缓存, 缓存管理器, 获取缓存, 连接选项, 服务器信息, 安全选项和 使用凭据创建.
  • 为您的 Java 客户端应用程序添加以下 Maven 依赖项: pom.xml 文件:
<dependency>
    <groupId>com.alachisoft.ncache</groupId>
    <!--for NCache-->
    <artifactId>ncache-client</artifactId>
    <version>x.x.x</version>
</dependency>
  • 在 Java 客户端应用程序中导入以下包:
    • com.alachisoft.ncache.client.*
    • com.alachisoft.ncache.runtime.exceptions.*
  • 缓存必须正在运行。
  • 确保要添加的数据是 可序列化.
  • 有关 API 详细信息,请参阅: 缓存, 缓存管理器, 获取缓存, 缓存连接选项, 时间跨度, 设置重试间隔, 设置启用保持活动, 设置连接重试, 设置KeepAliveInterval, 设置负载平衡, 设置隔离级别, 资历, 设置用户凭据.
  • 在您的 Python 客户端应用程序中安装以下软件包:
    • NCache: ncache-客户端
  • 在您的应用程序中导入以下包:
    • ,来自 ncache.client 导入*
  • 缓存必须正在运行。
  • 确保要添加的数据是 可序列化.
  • 有关 API 详细信息,请参阅: 缓存, 缓存管理器, 获取缓存, 缓存连接选项, 设置重试间隔, 设置连接重试次数, 设置保持活动间隔, 设置负载平衡, 设置隔离级别, 资历, 设置用户凭据.
  • 在您的Node.js客户端应用程序中安装并包含以下模块:
    • NCache: ncache-客户端
  • 在您的应用程序中包含以下类:
    • 缓存
  • 缓存必须正在运行。
  • 确保要添加的数据是 可序列化.
  • 有关 API 详细信息,请参阅: 缓存, 缓存管理器, 获取缓存, 缓存连接选项, 设置重试间隔, 时间跨度, 设置KeepAliveInterval, 设置负载平衡, 设置隔离级别, 资历, 设置用户凭据.
  • 在您的 .NET 客户端应用程序中安装以下任一 NuGet 包:
    • NCache: Install-Package Alachisoft.NCache.SDK -Version 4.9.1.0
  • 创建一个新的控制台应用程序。
  • 确保要添加的数据是 可序列化.
  • 添加 NCache 案例 通过定位 %NCHOME%\NCache\bin\assembly\4.0 并添加 Alachisoft.NCache.Web 和 Alachisoft.NCache.Runtime 作为适当的。
  • 包括 Alachisoft.NCache.Web.Caching 和 Alachisoft.NCache.Web.Security 应用程序中的命名空间。
  • 要了解更多关于 NCache 旧版 API,请下载 NCache 4.9 可作为 邮编 文件在 Alachisoft 官方网站.

如何连接到单个缓存

NCache 提供了一个 ICache 获取实例的接口 NCache的缓存。 此外, CacheManager 类允许您通过 GetCache 方法。以下示例连接到名为 defaultCache 的缓存,该缓存处于运行状态。

  • 。NET
  • 爪哇岛
  • Python
  • Node.js
  • 遗留 API
try
{
  // Specify the cache name
  string cacheName = "defaultCache";

  // Connect to cache
  ICache cache = CacheManager.GetCache(cacheName);
}
catch (OperationFailedException ex)
{
      // NCache specific exception
      if (ex.ErrorCode == NCacheErrorCodes.NO_SERVER_AVAILABLE)
      {
            // Make sure NCache Service and cache is running
      }
      else
      {
            // Exception can occur due to:
            // Connection Failures
            // Operation Timeout
            // Operation performed during state transfer
      }
}
catch (ConfigurationException ex)
{
      if(ex.ErrorCode == NCacheErrorCodes.SERVER_INFO_NOT_FOUND)
      {
            // The client must have server information
      }
}
catch (Exception ex)
{
      // Any generic exception like ArgumentNullException or ArgumentException
      // Argument exception occurs in case of empty string name
}
try
{
  // Specify the cache name
  String cacheName = "defaultCache";

  // Connect to cache
  Cache cache = CacheManager.getCache(cacheName);

}
catch (OperationFailedException exception)
{

  // NCache specific exception
  if (exception.getErrorCode() == NCacheErrorCodes.NO_SERVER_AVAILABLE)
  {
        // Make sure NCache service and cache are running
  } else
  {
        // Exception can occur due to:
        // Connection failures
        // Operation timeout
        // Operation performed during state transfer
  }
}
catch (ConfigurationException exception)
{
if (exception.getErrorCode() == NCacheErrorCodes.SERVER_INFO_NOT_FOUND)
{
      // The client must have server information
}
}
catch (Exception exception)
{
      // Any generic exception
}
try:
    # Specify the cache name
    cache_name = "defaultCache"

    # Connect to cache
    cache = ncache.CacheManager.get_cache(cache_name)

except Exception as error:
    # Handle any exceptions
    print(f"An error occurred: {error}")
try
{
  // Specify the cache name
  let cacheName = "defaultCache";

  // Connect to cache
  let cache = await ncache.CacheManager.getCache(cacheName);

} catch (error)
{
    // Handle any exceptions
}
// Using NCache 4.9.1

try
{
  // Specify the cache name
  string cacheName = "defaultCache";

  // Connect to cache
  cache = NCache.InitializeCache(cacheName);
}
catch (OperationFailedException ex)
{
      // NCache specific exception
      if (ex.ErrorCode == NCacheErrorCodes.NO_SERVER_AVAILABLE)
      {
            // Make sure NCache Service and cache is running
      }
      else
      {
            // Exception can occur due to:
            // Connection Failures
            // Operation Timeout
            // Operation performed during state transfer
      }
}
catch (ConfigurationException ex)
{
      if(ex.ErrorCode == NCacheErrorCodes.SERVER_INFO_NOT_FOUND)
      {
            // The client must have server information
      }
}
catch (Exception ex)
{
      // Any generic exception like ArgumentNullException or ArgumentException
      // Argument exception occurs in case of empty string name
}
注意:

为确保操作是故障安全的,建议处理应用程序中的任何潜在异常,如中所述 处理故障.

如何连接到多个缓存

使用 GetCache 通过这种方法,您可以在单个应用程序中连接到多个缓存。这将帮助您使用一个应用程序管理多个缓存的数据。以下示例演示了如何从同一客户端连接到两个缓存:defaultCache 和 defaultClusteredCache。

  • 。NET
  • 爪哇岛
  • Python
  • Node.js
  • 遗留 API
// Specify cache names
string cacheName1 = "defaultCache";
string cacheName2 = "defaultClusteredCache";

// Connect to the caches
ICache cache1 = CacheManager.GetCache(cacheName1);
ICache cache2 = CacheManager.GetCache(cacheName2);
// Specify cache names
String cacheName1 = "defaultCache";
String cacheName2 = "defaultClusteredCache";

// Connect to the caches
Cache cache1 = CacheManager.getCache(cacheName1);
Cache cache2 = CacheManager.getCache(cacheName2);
# Specify cache names
cache_name_1 = "defaultCache"
cache_name_2 = "defaultClusteredCache"

# Connect to the caches
cache_1 = ncache.CacheManager.get_cache(cache_name_1)
cache_2 = ncache.CacheManager.get_cache(cache_name_2)
// Specify cache names
let cacheName1 = "defaultCache";
let cacheName2 = "defaultClusteredCache";

// Connect to the caches
let cache1 = await ncache.CacheManager.getCache(cacheName1);
let cache2 = await ncache.CacheManager.getCache(cacheName2);
// Using NCache 4.9.1
// Specify cache names
string cacheName1 = "defaultCache";
string cacheName2 = "defaultClusteredCache";

// Connect to the caches
Cache cache1 = NCache.InitializeCache(cacheName1);
Cache cache2 = NCache.InitializeCache(cacheName2);

如何使用 ConnectionOptions 连接到 Cache

使用 .NET ConnectionOptions 该类用于提供应用程序特定的连接信息,例如服务器端点、安全凭据和本地绑定 IP。连接调优、客户端日志记录和客户端缓存设置均在缓存服务器上配置。

  • 。NET
// Specify the cache name
string cacheName = "defaultCache";

// Configure the cache server endpoints
ConnectionOptions options = new ConnectionOptions();
options.Servers = new List<ServerInfo>
{
    new ServerInfo("20.200.20.11", 9800),
    new ServerInfo("20.200.20.12", 9800)
};

// Connect to the cache
ICache cache = CacheManager.GetCache(cacheName, options);
注意:

此 ConnectionOptions 上面所示的类和重载适用于 .NET API。 NCache 5.3.800. Java、Python 和 Node.js API 可能使用不同的选项类和方法;请参阅它们各自的 API 参考文档以了解支持的签名。

如何通过负载均衡器连接到缓存

当客户端通过负载均衡器连接时,将其地址指定为服务器端点,并使用以下方式将其标识为负载均衡器: ServerInfo.IsLoadBalancer.

  • 。NET
ConnectionOptions options = new ConnectionOptions();
options.Servers = new List<ServerInfo>
{
    new ServerInfo(true, "20.200.20.11", 9800)
};

ICache cache = CacheManager.GetCache("defaultCache", options);
注意:

有关详情,请参阅 负载均衡器.

如何使用安全 API 连接到 Cache

您也可以使用 SecurityOptions 类用于配置缓存连接的身份验证,可以通过启用基于 gMSA 的无密码身份验证或提供显式用户凭据来实现。

使用 gMSA 安全连接

NCache 允许您使用 集团托管服务账户 (gMSA)用于在连接到缓存时进行安全、无密码的身份验证。启用 gMSA 身份验证后,客户端应用程序将使用计算机上配置的 gMSA 身份,该身份由 Active Directory 管理。

重要提示

请注意,客户端应用程序也必须在已配置的 gMSA 用户下运行。

以下示例演示了如何使用基于 gMSA 的身份验证连接到缓存。 CreateWithGMSA 方法。

  • 。NET
string cacheName = "defaultCache";

var connectionOptions = new ConnectionOptions();

// If the user wants to use GMSA, they can set the Security property to use GMSA credentials
connectionOptions.Security = SecurityOptions.CreateWithGMSA();

ICache cache = CacheManager.GetCache(cacheName, connectionOptions);

使用 CreateWithCredentials API 进行连接

本示例展示了如何使用以下方式连接到缓存: CreateWithCredentials 用户名/密码认证方法。

  • 。NET
string cacheName = "defaultCache";

var connectionOptions = new ConnectionOptions();

// If the user wants to use username/password credentials, they can set the Security property to use those credentials
connectionOptions.Security = SecurityOptions.CreateWithCredentials("your-username", "your-password");

ICache cache = CacheManager.GetCache(cacheName, connectionOptions);

使用 API 初始化进程内本地缓存

您可以通过设置以下参数,以编程方式将本地缓存初始化为进程内缓存: IsInproc 的财产 ConnectionOptions 至 true 并将配置的选项传递给 CacheManager.GetCache()这样一来,缓存就可以在应用程序进程内运行。

以下示例初始化一个名为“Local Cache”的本地缓存。 默认缓存 作为 InProc。

  • 。NET
// Specify the cache name
string cacheName = "defaultCache";

// Configure the cache to run as InProc
ConnectionOptions options = new ConnectionOptions();
options.IsInproc = true;

// Initialize the InProc Local Cache
ICache cache = CacheManager.GetCache(cacheName, options);
注意:

此方法适用于本地缓存。设置 IsInproc 至 true 使缓存在应用程序进程内运行。

如何连接到集群和客户端缓存

客户端缓存配置在缓存服务器上,其设置会在客户端连接时自动提供。应用程序使用以下方式连接到集群缓存: GetCache它们无需通过单独的方式初始化客户端缓存。 GetCache 超载。

  • 。NET
// Connect to the clustered cache. The server supplies client cache settings.
ICache cache = CacheManager.GetCache("defaultClusteredCache");

要绕过特定连接的已配置客户端缓存,请设置 IgnoreClientCache 至 true:

ConnectionOptions options = new ConnectionOptions();
options.IgnoreClientCache = true;

ICache cache = CacheManager.GetCache("defaultClusteredCache", options);

故障排除

端口不可访问

有时,由于您的防火墙配置,客户端可能无法连接到缓存。

解决方法: 使用我们的详细信息 安装指南 更改您的防火墙设置。

NCHOME 环境变量未设置

If %NCHOME% 未设置,请按照以下步骤为其设置环境变量:

  • 用鼠标右键单击 开始 按钮并选择 系统.
  • 在右侧窗格中,单击 高级系统设置.
  • 在 系统属性 窗口,转到 先进的 标签并点击 环境变量 按钮。
  • 在 环境变量 窗下,下 系统变量, 点击 全新发布.
  • 对于 变量名称,输入 NCHOME.
  • 对于 变量值,输入 C:\Program Files\NCache.
  • 点击 OK.
  • 现在更新系统路径相同 环境变量 窗口中,找到 途径 变量并单击 编辑.
  • 在 编辑环境变量 窗口中,单击 全新发布 并添加 %NCHOME%\bin 到列表中。 这确保了这些工具在全球范围内可用。
  • 点击 OK 关闭每个窗口。

没有可用于处理请求的服务器

有时客户端可能无法连接到缓存,因为客户端/服务器端口被防火墙阻止。

解决方法

确保客户端/服务器端口(在哪个端口上) NCache 服务启动并接受不同的客户端连接)未被防火墙阻止。默认 TCP 端口为 9800有关特定于平台的服务配置文件和端口设置,请参阅 防火墙和端口.

无法与服务器节点通信

由于集群端口被防火墙阻止,集群节点之间也可能无法通信。

Error: "Unable to communicate with server node"

解决方法

请确保您的防火墙允许配置的客户端/服务器端口和缓存集群端口。默认的客户端/服务器 TCP 端口是 9800默认缓存集群 TCP 端口范围为 9881–9980如果使用自定义端口范围,请允许该范围内的所有端口。参见 防火墙和端口 完整的端口分配信息。

客户端套接字死锁

由于长时间等待来自缓存服务器的响应,您可能会在客户端套接字上遇到死锁情况。 这也可能导致大量等待线程,从而导致性能问题。

解决方法

步骤 1:服务器端的更改

进入服务配置文件:

  • Windows: Alachisoft.NCache.Service.dll.config 位于 %NCHOME%\bin\服务
  • Linux: Alachisoft.NCache.Daemon.dll.config 位于 /opt/ncache/bin/服务

在配置文件中添加以下行:

<add key ="NCacheServer.EnableBadClientDetection" value = "true"/>

价值 true 表示 BadClientDetection 已在客户端套接字上启用。这意味着,如果客户端套接字出现死锁情况,套接字将被重置。此属性的默认值为 false.

<add key ="NCacheServer.ClientSocketSendTimeout" value = "10"/>

当您启用 BadClientDetection,您可以指定发生死锁时重置套接字的时间间隔。此属性的默认值为 10 并且该值不能小于 1.

服务配置文件中也提供了有助于解决此问题的属性。请按如下方式配置这些属性:

<add key ="NCacheServer.EventPriorityRatio" value="30"/>

在服务器端,优先级队列用于事件和缓存操作。您可以通过名为的属性配置此队列的事件和缓存操作的比例 EventPriorityRatio。此属性的默认值是 30 这表明 30:70 用于事件和缓存操作。此属性的值不能小于 1.

<add key ="NCacheServer.EventBulkCount" value="50"/>

缓存服务器现在会批量向客户端发送事件。通过此属性,您可以设置批量发送的项目数量。默认情况下,此值为 50 且该值不能小于 1.

<add key ="NCacheServer.EventBulkCollectionInterval" value="2"/>

此属性用于设置时间间隔(以秒为单位),在此时间间隔后,即使批量计数未达到指定值,也会触发批量事件。 EventBulkCount 用户指定的。此属性的默认值为 2秒 且该值不能小于 1.

重新启动 NCache 服务以使这些更改生效。

步骤 2:客户端的更改

请在您的 应用配置/网页配置 文件:

<configuration>
    <appSettings>
          <add key ="NCacheClient.AsynchronousEventNotification" value="true"/>
          <add key ="NCacheClient.NumberofEventProccesingThreads" value="2"/>
     </appSettings>
</configuration>
  • AsynchronousEventNotification:指定在客户端是否以异步或同步方式触发事件。默认值为 true 表示事件将异步触发。值 false 意味着事件将在客户端同步触发。

  • NumberofEventProcessingThreads:当用户将事件配置为同步触发时,此标志用于指定在客户端处理这些事件的线程数。过大的值可能会导致性能问题。

参见

.NET: Alachisoft.NCache。客户 命名空间。
Java的: com.alachisoft.ncache.client 命名空间。
Python: ncache.客户端 模块。
节点.js: 缓存 类。

联系我们

联系电话

+1 214-619-2601   (美国)

+44 20 7993 8327   (英国)

 
邮箱地址

sales@alachisoft.com

support@alachisoft.com

NCache
  • 版本比较
  • NCache 卓越
  • 基准
尝试 NCache
定价
NCache 兒童遊樂區

部署
  • 云端
  • Docker
  • Kubernetes
  • 内部部署
技术用例
  • ASP.NET 会话
  • ASP.NET Core 会话
  • 发布/订阅消息
  • SignalR 背板
  • 物联网(IOT)
  • NoSQL 数据库
  • 流处理
  • 微服务
相关资源
  • 博客
  • Foundations
  • 视频
  • 比较
  • 作品
  • 白皮书
  • 专题文章
  • 技术讲座
  • 杂志文章
  • 第三方文章
客户案例研究
  • 评价
  • 客户
支持
  • 文档
  • 安排演示
  • 小技巧
关于我们
  • 领导团队
  • 合作伙伴
  • 新闻
  • 活动
  • 加入我们
联系我们

  • 英语简体中文法语版德语版意大利语版日语版韩语版葡萄牙语西班牙语

  • 使用条款
  •  
  • 隐私政策
  •  
  • Cookie政策
©版权所有 Alachisoft 2002 - 版权所有。 NCache 是 Diyatech Corp. 的注册商标。
  • Facebook
  • Twitter
  • Youtube
  • LinkedIn
  • RSS