ScopedCacheManager - 범위가 지정됨

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 13분

    • ScopedCacheManager API는 범위가 지정된 애플리케이션에 대한 캐시 데이터를 검색, 설정 및 플러시하는 메서드를 제공합니다.

    이 API에는 범위 지정 캐시(com.glide.scopedcache) 플러그인이 필요하며 sn_scoped_cache 네임스페이스에서 실행됩니다. 플러그인은 기본적으로 설치되고 활성화됩니다.

    이러한 메서드를 사용하려면 하나 이상의 범위가 지정된 캐시와 범위가 지정된 캐시 쌍을 정의해야 합니다. 범위가 지정된 캐시를 만드는 방법에 대한 자세한 내용은 ScopedCacheManager API 개발자 가이드를 참조하세요.

    범위가 지정된 캐시와 함께 이 API를 사용하면 다음과 같은 몇 가지 이점이 있습니다.
    • 트랜잭션 간에 메모리에 상주하는 범위가 지정된 애플리케이션의 캐싱 문자열입니다.
    • 범위가 지정된 애플리케이션 데이터를 메모리에 캐싱하고 기본 테이블의 변경 사항에 따라 이 데이터를 플러시합니다.
    • 트랜잭션 수명주기 외부에서 캐시 데이터 정의 및 사용.
    • 나중에 빠르게 액세스할 수 있도록 비용이 많이 드는 작업 또는 계산의 출력을 캐싱합니다.

    ScopedCacheManager – flushScopedCache(문자열 카탈로그, 문자열 키)

    전체 캐시 또는 캐시에서 단일 항목을 플러시합니다.

    표 1. 매개변수
    이름 유형 설명
    카탈로그 문자열 범위 지정 캐시 [sys_scoped_cache] 테이블에 정의된 캐시의 이름입니다.
    키 문자열 옵션입니다. 캐시 키입니다. 캐시에서 단일 항목을 플러시하도록 이 매개변수를 설정합니다.
    표 2. 반환
    유형 설명
    없음

    다음 예제에서는 myCache라는 캐시에서 "abc" 키를 플러시하는 방법을 보여 줍니다. 전체 캐시를 플러시하려면 키 매개변수를 생략하십시오.

    sn_scoped_cache.ScopedCacheManager.flushScopedCache("myCache", "abc");

    ScopedCacheManager – get(문자열 카탈로그, 문자열 키)

    캐시에서 값을 가져옵니다.

    표 3. 매개변수
    이름 유형 설명
    카탈로그 문자열 범위 지정 캐시 [sys_scoped_cache] 테이블에 정의된 캐시의 이름입니다.
    키 문자열 캐시 키입니다.
    표 4. 반환
    유형 설명
    문자열 캐시 항목입니다.

    다음 예에서는 짧은 설명이 키(50)보다 큰 문자가 있는 인시던트 기록 수를 계산하는 방법을 보여줍니다. 이 경우 짧은 설명이 50자를 넘는 6개의 인시던트 기록이 있습니다. 이 값은 재사용 가능한 문자열로 캐시에 저장되므로 값을 검색할 때마다 계산을 수행할 필요가 없습니다.

    var cache2 = "Cache 2"; // column pair type

// Re-populate the column cache
for (var i = 0; i < 100; i+=10) {
    var inc = new GlideRecord('incident');
    inc.query();
    var counter = 0;
    while (inc.next()) {
        if (inc.getValue('short_description').length > i)
        counter++;
    }
    sn_scoped_cache.ScopedCacheManager.put(cache2, i.toString(), counter.toString());
}

// script to get values from column cache
gs.info(sn_scoped_cache.ScopedCacheManager.get(cache2, "50"));

    출력:

    scoped_app: 6

    ScopedCacheManager – getCacheEntryDetails(문자열 카탈로그, 문자열 키)

    바이트 크기, 객체 유형 및 항목 값을 포함한 캐시 항목 상세 정보를 가져옵니다.

    표 5. 매개변수
    이름 유형 설명
    카탈로그 문자열 범위 지정 캐시 [sys_scoped_cache] 테이블에 정의된 캐시의 이름입니다.

    카탈로그 이름 앞에는 범위 이름과 캐럿 문자가 붙어야 합니다. 예를 들어 전역 범위의 "test_cache"에는 "global^test_cache"이라는 접두사가 붙습니다.
    키 문자열 캐시 키입니다.
    표 6. 반환
    유형 설명
    문자열 <ObjectType> (<EntrySize>): <Value.toString()> 형식의 문자열입니다.

    다음 예제에서는 test_cache라는 범위 지정 캐시에 대한 캐시 항목 세부 정보를 표시하는 방법을 보여 줍니다.

    sn_scoped_cache.ScopedCacheManager.put("test_cache", "key1", "val1");
gs.info(sn_scoped_cache.ScopedCacheManager.getCacheEntryDetails("global^test_cache", "key1"));

    출력:

    java.lang.String (48):
val1

    ScopedCacheManager – prefixFlush(문자열 카탈로그, 문자열 접두사)

    지정된 프리픽스로 시작하는 키가 있는 모든 캐시 항목을 플러시합니다.

    표 7. 매개변수
    이름 유형 설명
    카탈로그 문자열 범위 지정 캐시 [sys_scoped_cache] 테이블에 정의된 캐시의 이름입니다.
    프리픽스 문자열 캐시를 플러시할 때 키를 검색하는 데 사용되는 프리픽스입니다.
    표 8. 반환
    유형 설명
    없음

    다음 예제에서는 접두사 a가 있는 키의 캐시 값을 플러시하는 방법을 보여 줍니다.

    sn_scoped_cache.ScopedCacheManager.put("test_cache", "aKey1", "val1");
sn_scoped_cache.ScopedCacheManager.put("test_cache", "aKey2", "val2");
sn_scoped_cache.ScopedCacheManager.put("test_cache", "bKey1", "val3");

sn_scoped_cache.ScopedCacheManager.prefixFlush("test_cache", "a");

gs.info(sn_scoped_cache.ScopedCacheManager.get("test_cache", "aKey1"));
gs.info(sn_scoped_cache.ScopedCacheManager.get("test_cache", "aKey2"));
gs.info(sn_scoped_cache.ScopedCacheManager.get("test_cache", "bKey1"));

    출력:

    *** Script: null
*** Script: null
*** Script: val3

    ScopedCacheManager – put(문자열 카탈로그, 문자열 키, 문자열 값)

    테이블 또는 테이블 열 쌍 유형인 캐시의 범위 캐시에 값을 넣습니다.

    표 9. 매개변수
    이름 유형 설명
    카탈로그 문자열 범위 지정 캐시 [sys_scoped_cache] 테이블에 정의된 캐시의 이름입니다.
    키 문자열 캐시 키입니다.
    값 문자열 캐시 항목입니다.
    표 10. 반환
    유형 설명
    없음

    다음 예제에서는 "abc"라는 키를 정의하고 myCache라는 캐시에 검색하는 방법을 보여 줍니다. 캐시는 인시던트 [incident] 테이블과 쌍을 이룹니다. 이 예는 인시던트 기록의 설명 필드를 업데이트한 후 캐시가 플러시되는 방식도 보여줍니다.

    //put value in cache for key "abc"
gs.info("put key 'abc' into cache with value 'value1'");
sn_scoped_cache.ScopedCacheManager.put("myCache", "abc", "value1");

// retrieve value from cache for key "abc"
gs.info("value of 'abc' in cache: ");
gs.info(sn_scoped_cache.ScopedCacheManager.get("myCache", "abc")+"\n");

//update an incident record (add string to the description field)
gs.info("Updating incident record.");
var gr = new GlideRecord("incident");
gr.get("<incident_sys_id>");
gr.description= "test12345";
if (gr.update()) {
    gs.info("Record updated successfully.\n");
};

//retrieve the value from cache for key "abc"
gs.info("Retrieving 'abc' from cache. Value should be null because a table pair was updated.");
gs.info(sn_scoped_cache.ScopedCacheManager.get("myCache", "abc"));

    출력:

    scoped_app: put key 'abc' into cache with value 'value1'
scoped_app: value of 'abc' in cache: 
scoped_app: value1

scoped_app: Updating incident record.
scoped_app: Record updated successfully.

scoped_app: Retrieving 'abc' from cache. Value should be null because a table pair was updated.
scoped_app: null

    ScopedCacheManager – putMultiRow(문자열 카탈로그, 문자열 키, 문자열 값, 배열 ID)

    항목을 캐시에 넣고 지정된 sys_ids 있는 모든 레코드를 해당 항목의 플러시 소스로 설정합니다. 이 메서드는 테이블 또는 테이블 열 쌍 유형인 캐시를 위한 것입니다.

    표 11. 매개변수
    이름 유형 설명
    카탈로그 문자열 플러시할 카탈로그입니다. 범위 지정 캐시 [sys_scoped_cache] 테이블에 정의된 캐시의 이름입니다.
    키 문자열 새 항목의 캐시 키입니다.
    값 문자열 새 항목의 값입니다.
    id 배열 항목의 플러시 소스로 사용할 sys_ids 기록 목록입니다. 이러한 기록은 서로 다른 테이블에서 나올 수 있습니다.
    표 12. 반환
    유형 설명
    없음

    다음 예시에서는 인시던트와 사용자 기록을 플러시 포인트로 사용하는 방법을 보여줍니다. 지정된 기록 중 하나가 업데이트되면 test_cache 키 INC0000060 플러시됩니다.

    // This example requires a table-row pair for the "incident" and "sys_user" tables assigned to a cache named test_cache
var inc1ID = "1c741bd70b2322007518478d83673af3";
var userID = "681ccaf9c0a8016400b98a06818d57c7";

// update to email should invalidate the entry
gs.info("initial put");
putCacheEntry();
gs.info("cache value for INC0060: " + sn_scoped_cache.ScopedCacheManager.get("test_cache", "INC0000060"));
var gr = new GlideRecord("sys_user");
gr.get(userID);
gr.setValue("email", "a" + gr.getValue("email"));
gr.update();
gs.info("updated user email");
gs.info("cache value: " + sn_scoped_cache.ScopedCacheManager.get("test_cache", "INC0000060"));

// update to incident number should invalidate the entry.
gs.info("second put");
putCacheEntry();
gs.info("cache value: " + sn_scoped_cache.ScopedCacheManager.get("test_cache", "INC0000060"));
var gr = new GlideRecord("incident");
gr.get(inc1ID);
gr.setValue("number", gr.getValue("number") + "1");
gr.update();
gs.info("updated incident number");
gs.info("cache value: " + sn_scoped_cache.ScopedCacheManager.get("test_cache", "INC0000060"));

function putCacheEntry() {
    var incGr = new GlideRecord("incident");
    incGr.get(inc1ID);
    var userGr = new GlideRecord("sys_user");
    userGr.get(userID);
    // the cache stores that the incident is assigned to a specific user. So if the incident or user record changes, we should flush.
    sn_scoped_cache.ScopedCacheManager.putMultiRow("test_cache",incGr.getValue("number"), userGr.getValue("email"), [inc1ID, userID]);
}

    출력:

    *** Script: initial put
*** Script: cache value for INC0060: employee@example.com
*** Script: Updating Joe Employee's primary email device based on change to user record email address
*** Script: updated user email
*** Script: cache value: null
*** Script: second put
*** Script: cache value: aemployee@example.com
*** Script: updated incident number
*** Script: cache value: null

    ScopedCacheManager – putRow(문자열 카탈로그, 문자열 키, 문자열 값, 문자열 sysId)

    캐시의 단일 행(테이블)에 값을 넣습니다. 테이블 행 또는 테이블 행과 열 쌍 유형의 캐시에 이 방법을 사용합니다.

    표 13. 매개변수
    이름 유형 설명
    카탈로그 문자열 범위 지정 캐시 [sys_scoped_cache] 테이블에 정의된 캐시의 이름입니다.
    키 문자열 캐시 키입니다.
    값 문자열 캐시 항목입니다.
    sysId 문자열 옵션입니다. 테이블의 행 Sys_id, 즉 추적 중인 기록입니다.
    표 14. 반환
    유형 설명
    없음

    다음 예에서는 incident_cache라는 테이블 행 쌍 캐시 유형을 사용합니다. 캐시에 인시던트 호출자 ID가 추가되고 변경된 레코드의 sys_id와 연결된 캐시 항목이 지워집니다.

    // build the cache:
var number = 'INC0009009';
var inc = new GlideRecord('incident');
inc.addQuery('number', number);
inc.query();
inc.next();
var entry = inc.caller_id.getDisplayValue();
sn_scoped_cache.ScopedCacheManager.putRow("incident_cache", inc.getValue('number'), entry, inc.getValue('sys_id'));
gs.info(sn_scoped_cache.ScopedCacheManager.get("incident_cache", number));

// when the incident is altered, the cache entry will be flushed.
inc = new GlideRecord('incident');
inc.addQuery('number', number);
inc.query();
inc.next();
inc.setValue('short_description', inc.getValue('short_description') + "a");
inc.update();
gs.info(sn_scoped_cache.ScopedCacheManager.get("incident_cache", number));

    출력:

    scoped_app: John Jones
scoped_app: null