---
title: "キャッシュへのデータ挿入"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/cache/insert-data-into-cache/
description: "このページでは、Javaアプリケーションでキャッシュにデータを挿入するメソッドについて、サンプルコードスニペットとともに説明します。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Insert Data into the Cache - API"
    url: /ja/api/code-reference/cloud-scale/cache/insert-key-value-in-segment/#InsertKey-ValueinCacheSegment
  - name: "Cache"
    url: /ja/cloud-scale/help/cache/introduction
---

# キャッシュへのデータ挿入

キャッシュ情報の取得に加えて、以下の`putCache()`のバリエーションはキャッシュオブジェクト要素の挿入もサポートしています。

### キーバリューペアの挿入

以下のコードは、`putCacheValue()`メソッドを使用してキャッシュセグメントにキーバリューペアを挿入します。

> **Note:**
有効期限はデフォルトで48時間に設定されています。

#### サンプルコードスニペット

**Package Imports**

```java
import com.zc.component.cache.ZCCache;
import com.zc.component.cache.ZCCacheObject; 
import com.zc.component.cache.ZCSegment;

```

```java
//キャッシュインスタンスを取得する 
ZCCache cacheobj=ZCCache.getInstance(); 
//セグメントIDで特定のセグメントのインスタンスを取得する 
ZCSegment segment = cacheobj.getSegment(1510000000054091L); 
//キャッシュにキー・バリューペアとして値を保存する（デフォルトの有効期限は48時間）
ZCCacheObject cache = segment.putCacheValue("Name", "Amelia Burrows");

```

### 有効期限付きのキーバリューペアの挿入

前述のケースと同様に、キーと値のパラメータに加えて、オプションパラメータの有効期限がこのバリエーションで使用されます。

> **Note:**
有効期限の値は、時間単位のlong値として渡す必要があります。

#### サンプルコードスニペット

**Package Imports**

```java
import com.zc.component.cache.ZCCache; 
import com.zc.component.cache.ZCCacheObject; 
import com.zc.component.cache.ZCSegment;

```

```java
//キャッシュインスタンスを取得する ZCCache
cacheobj=ZCCache.getInstance(); 
//セグメントIDで特定のセグメントのインスタンスを取得する 
ZCSegment segment = cacheobj.getSegment(1510000000054091L); 
//指定した有効期限でキャッシュにキー・バリューペアとして値を保存する。（時間単位） 
ZCCacheObject cache = segment.putCacheValue("LastName", "S", 1L);

```

### キャッシュオブジェクトによるキーバリューペアの挿入

以下のコードは、`putCacheObject()`メソッドを使用してキャッシュセグメントにキーバリューペアを挿入します。

> **Note:**
キー名がキャッシュセグメントに既に存在する場合、新しく挿入された値で置き換えられます。

#### サンプルコードスニペット

**Package Imports**

```java
import com.zc.component.cache.ZCCache; 
import com.zc.component.cache.ZCCacheObject; 
import com.zc.component.cache.ZCSegment;

```

```java
//キャッシュインスタンスを取得する ZCCache
cacheobj=ZCCache.getInstance(); 
//セグメントIDで特定のセグメントのインスタンスを取得する 
ZCSegment segment = cacheobj.getSegment(1510000000054091L); 
//CacheObjectを作成してキャッシュセグメントの属性を設定する 
ZCCacheObject cacheDetails = ZCCacheObject.getInstance(); 
cacheDetails.setKeyName("ObjectKey"); 
cacheDetails.setValue("ObjectValue");
cacheDetails.setExpiryInHours(1L); 
//CacheObjectを使用してキャッシュを作成する 
ZCCacheObject cache = segment.putCacheObject(cacheDetails);

```