캐시의 데이터 구조에 대한 검색 가능한 속성 구성

NCache 이 기능을 사용하면 HashSet, List, Queue와 같은 분산 데이터 구조를 검색 가능한 메타데이터와 연결하여 구성할 수 있습니다. 데이터 구조는 다음과 같은 검색 가능한 속성과 연결될 수 있습니다.

이러한 검색 가능한 속성은 에 설명된 대로 모든 관련 항목을 쿼리하는 데 사용할 수 있습니다. 데이터 구조 쿼리. 예를 들어, a CacheItem HashSet은 같은 그룹에 속할 수 있습니다. 이러한 속성은 다음을 사용하여 지정됩니다. DataTypeAttributes 클래스입니다.

중대한

데이터 구조가 생성된 후에는 이러한 속성을 수정할 수 없습니다. 하지만 데이터 구조 자체는 수정할 수 있습니다.

사전 조건

사용하기 전에 NCache 클라이언트 측 API를 사용할 때 다음 전제 조건을 충족하는지 확인하십시오.

다음 예제는 라는 이름의 데이터 구조에 대해 검색 가능한 속성을 구성합니다. 제품 ID 집합.NET 및 Java 예제는 HashSet을 생성하는 반면 Node.js 예제는 List를 생성합니다. 그룹화 전자태그와 명명된 태그는 다음을 사용하여 데이터 구조와 연결됩니다. DataTypeAttributes or DataStructureAttributes.

팁

데이터 구조가 생성되었는지 확인하는 빠른 방법 중 하나는 다음 중 하나의 속성을 사용하는 것입니다. Cache 수업:

  • Count 캐시에 있는 항목 수를 반환합니다.
  • Contains 데이터 구조의 지정된 키가 캐시에 존재하는지 확인합니다.
try
{
  // Precondition: Cache is already connected

  // Specify unique cache key for set
  string key = "ProductIDSet";

  // Specify attributes for HashSet
  var attributes = new DataTypeAttributes();

  // Specify group "Electronics"
  attributes.Group = "Electronics";

  // Specify tags
  Tag[] tags = new Tag[2];
  tags[0] = new Tag("2 Year Warranty");
  tags[1] = new Tag("Stainless Steel");
  attributes.Tags = tags;

  // Specify Named Tag
  var namedTag = new NamedTagsDictionary();
  namedTag.Add("Discount", 0.4);
  attributes.NamedTags = namedTag;

  // Create HashSet with attributes
  IDistributedHashSet<int> hashSet = cache.DataTypeManager.CreateHashSet<int>(key, attributes);

  // Adding Product IDs to HashSet
  int[] productIDs = FetchProductIDs();
  foreach(var productID in productIDs)
  {
      // Add product IDs to HashSet
      hashSet.Add(productID);
  }
  // You can also query on this HashSet using these attributes
}
catch (OperationFailedException ex)
{
    // NCache specific exception
    if(ex.ErrorCode == NCacheErrorCodes.KEY_ALREADY_EXISTS)
    {
        // An item with the same key already exists
    }
    else if (ex.ErrorCode == NCacheErrorCodes.CACHEITEM_IN_DATA_STRUCTURES)
    {
        // Data structures cannot be of CacheItem type
        // CacheItems cannot be added in data structures
    }
    else
    {
        // NCache specific exception
        // Exception can occur due to:
        // Connection Failures
        // Operation Timeout
        // Operation performed during state transfer
    }
}
catch (Exception ex)
{
    // Any generic exception like ArgumentNullException or ArgumentException
}
주의 사항

작업이 오류로부터 안전한지 확인하려면 에 설명된 대로 애플리케이션 내에서 잠재적인 예외를 처리하는 것이 좋습니다. 처리 실패.

추가 자료

NCache 데이터 구조로 검색 가능한 속성을 구성하기 위한 샘플 애플리케이션을 제공합니다. GitHub의.

도 참조

.그물: Alachisoft.NCache.클라이언트.데이터 유형 네임 스페이스
자바 : com.alachisoft.ncache.client.데이터 구조 네임 스페이스
Node.js : 데이터 구조 관리자 수업