15.2.2　key，value，キャッシュ名，EADsクライアント名に指定できるデータ

key，value，キャッシュ名，EADsクライアント名に指定できるデータについて説明します。

〈この項の構成〉

(1)　keyとして指定できるデータ

keyとして指定できるデータ型と文字数を，APを作成する言語ごとに次の表に示します。

表15‒1　keyとして指定できるデータ
APを作成する言語	keyとして指定できるデータ型	文字数	備考
Java言語	文字列（java.lang.String）	1〜1,024	ASCIIコード「0x20」〜「0x7E」の文字が指定できます。 keyをグルーピングする場合，作成できるグループ数，およびグループの階層数に上限はありません。 keyをグルーピングする場合，グループ名，区切り文字（:），要素名を合わせて1,024文字までとなります。 keyをグルーピングする場合，グループ名と要素名にコロン（:）は指定できません。 nullまたは空文字列は不正となります。
C言語	'`\`0'を終端記号とする文字列（char *）	1〜1,024	ASCIIコード「0x20」〜「0x7E」の文字が指定できます。 keyをグルーピングする場合，作成できるグループ数，およびグループの階層数に上限はありません。 keyをグルーピングする場合，グループ名，区切り文字（:），要素名を合わせて1,024文字までとなります。 keyをグルーピングする場合，グループ名と要素名にコロン（:）は指定できません。文字列の最大サイズは，'`\`0'を含まないバイト数となります。長さ0の文字列（'`\`0'だけ）は指定できません。

注意事項: eztool put，eztool get，eztool removeの各コマンドは，構築後の実行環境が正常に動作するかどうかテストするために使用します。そのため，コマンドで指定できるデータ型とサイズと，API（put，get，remove）で指定できるデータ型とサイズの間に完全な互換性はありません。

valueとして指定できるデータ型とサイズを，APを作成する言語ごとに次の表に示します。

表15‒2　valueとして指定できるデータ
APを作成する言語	valueとして指定できるデータ型	サイズ（単位：バイト）	備考
Java言語	シリアライズ可能な任意のオブジェクト（java.lang.Object）	1〜262,144	シリアライズ後のバイト配列の長さとなります。 nullの場合は不正となります。
C言語	任意のバイト配列（void *）	1〜262,144	任意のバイト配列の長さとなります。

注意事項

指定できるデータ型とサイズについて，API（put，get，remove）・コマンド（eztool put，eztool get，eztool remove）間に完全な互換性はありません。
Java言語のクライアントAPまたはユーザファンクションと，C言語のクライアントAPで同一のkeyを扱う場合，valueはバイト配列にしてください。Java言語のクライアントAPまたはユーザファンクションから格納したバイト配列のvalueを，C言語のクライアントAPで取得できます。バイト配列でないvalueをC言語のクライアントAPで取得した場合，エラーとなります。

C言語のクライアントAPから格納したvalueは，Java言語のクライアントAPまたはユーザファンクションでバイト配列として取得できます。
C言語のクライアントAPからユーザファンクションを実行する場合，ユーザファンクションの戻り値として扱うことができるオブジェクトは，バイト配列とnullだけです。バイト配列およびnull以外のオブジェクトを戻り値とした場合，エラーとなります。

キャッシュ名として指定できるデータ型と文字数を，APを作成する言語ごとに次の表に示します。

表15‒3　キャッシュ名として指定できるデータ
APを作成する言語	キャッシュ名として指定できるデータ型	文字数	備考
Java言語	文字列（java.lang.String）	1〜32	ASCIIコード「0x20」〜「0x7E」の文字が指定できます。 nullまたは空文字列は不正となります。
C言語	'`\`0'を終端記号とする文字列（char *）	1〜32	ASCIIコード「0x20」〜「0x7E」の文字が指定できます。文字列の最大サイズは，'`\`0'を含まないバイト数となります。長さ0の文字列（'`\`0'だけ）は指定できません。

EADsクライアント名として指定できるデータ型と文字数を，APを作成する言語ごとに次の表に示します。

表15‒4　EADsクライアント名として指定できるデータ
APを作成する言語	EADsクライアント名として指定できるデータ型	文字数	備考
Java言語	文字列（java.lang.String）	0〜16	半角英数字（0〜9，A〜Z，a〜z），アンダースコア（_）が指定できます。空文字列を指定できます。 nullは不正となります。
C言語	'`\`0'を終端記号とする文字列（char *）	0〜16	半角英数字（0〜9，A〜Z，a〜z），アンダースコア（_）が指定できます。文字列の最大サイズは，'`\`0'を含まないバイト数となります。長さ0の文字列（'`\`0'だけ）を指定できます。