クッキーは主にCGIなどのウェブプログラムで読み書きするものですが、JAVAスクリプトでも利用する事が出来ます。

ここでは、JAVAスクリプトだけでクッキーを扱う方法を簡単な例を挙げて解説します。

JAVAスクリプトでのクッキー・目次。

▲記事先頭
▽次項目

クッキーを読み書きするサンプルスクリプト
クッキーを読み書きするスクリプトの内容
クッキーを読み書きするスクリプトの実際の構成
クッキーをJAVAスクリプトで扱う場合の注意事項
- クッキーから読み込んだ日本語文字列を扱う場合の注意事項
そもそも、JAVAスクリプトでクッキーを扱う必要があるのか？

クッキーを読み書きするサンプルスクリプト。

▲記事先頭
△前項目
▽次項目

今、JAVAスクリプトを有効にした場合、この後に以下の文字列が表示されるでしょう。

初めてこのページにアクセスされた場合
前回のアクセスが30日以上前の場合
クッキーが有効でないかクッキーを削除している場合: 今回初めてのアクセスですね。と表示されます。
その他の場合: 前回のアクセス日時が表示されます。

尚、このページは恐らくブラウザにキャッシュされるとため、リロードしてもページ自身は更新されない場合がありますが、リロードする度にクッキーを更新するスクリプトが動作するため、表示内容が変化します。

本頁の目次

このクッキーを読み書きするスクリプト「Cookie.js」の内容は以下のようになっております。

読み飛ばす

//    クッキーを焼く。
function set_cookie(nam,val,exp) {
    var i;

    //    値の設定。
    var str=nam+'='+escape(val);

    //    有効期限の計算。
    if (exp!=0) {
        i=new Date()
        i=i.getTime();
        i=new Date(i+(60*60*24*1000*exp));
        str+='; expires= '+i.toGMTString();
        }

    //    クッキー焼き。
    document.cookie=str;
}

//    クッキーから特定のキーの値を受け取る。
function get_cookie(nam) {
    var ck=document.cookie.split('; ');

    var i=-1;
    var j,k;
    while (++i<ck.length) {
        j=ck[i].split('=');
        if (j[0]==nam) return(unescape(j[1]));
        }
    return('');
}

//    前回アクセス時刻を収めたクッキーを読み込む。
var la=get_cookie('lastaccessed');

//    読み込んだ値を返す。
if (la!='') {
    document.write('<ul><li>'+la+'</li></ul>');
    }
else {
    document.write('<ul><li>今回初めてのアクセスですね。</li></ul>');
    }

//    前回アクセス時刻を収めるクッキーを更新する。
//    日付文字列を作る。
var tm=new Date();
var yr=tm.getYear();
var mo=tm.getMonth()+1;
var dt=tm.getDate();
var hr=tm.getHours();
var mn=tm.getMinutes();
var sc=tm.getSeconds();

if (mo<10) { mo='0'+mo; }
if (dt<10) { dt='0'+dt; }
if (hr<10) { hr='0'+hr; }
if (mn<10) { mn='0'+mn; }
if (sc<10) { sc='0'+sc; }

if (yr>=1970) { yr-=1988 }
else { yr-=88; }
la='前回のアクセスは 平成'+yr+'年'+mo+'月'+dt+'日 '+hr+'時'+mn+'分'+sc+'秒でした。';

//    lastaccessedと言う名前の満30日間有効なクッキーに変数laの値を設定する。
set_cookie('lastaccessed',la,30);

本頁の目次

クッキーを読み書きするスクリプトの実際の構成。

▲記事先頭
△前項目
▽次項目

このクッキー読み書きスクリプトは大きく分けて三つに分かれます。

クッキーを焼く(発行する)函数・set_cookie()函数
食べた(読み込んだ)クッキーから特定の名前のものを取り出す函数・get_cookie()函数
クッキーを食べて内容に合わせた表示を行って、その上でクッキーを更新する処理

クッキーを焼く(発行する)函数・set_cookie()函数。

▲記事先頭
△前項目
▽次項目

一番目の処理は、実際にクッキーを焼く(発行する)処理を纏めたset_cookie()函数です。

その内容は以下のようになります。

読み飛ばす

//    クッキーを焼く。
function set_cookie(nam,val,exp) {
    var i;

    //    値の設定。
    var str=nam+'='+escape(val);

    //    有効期限の計算。
    if (exp!=0) {
        i=new Date()
        i=i.getTime();
        i=new Date(i+(60*60*24*1000*exp));
        str+='; expires= '+i.toGMTString();
        }

    //    クッキー焼き。
    document.cookie=str;
}

先ず、クッキーの値を変数strに入れるようにしております。

ここでは、クッキー名と、それに対応する値を先ず設定するようにしております。

詳しくはdocument.cookieプロパティの解説にて解説しておりますが、日本語の文字列などはそのままではクッキーにする事は出来ず、escape()函数でURLエンコードを行う必要があります。

続いて、有効期限の設定です。

このset_cookie()函数では第二引数で有効期間を日数で指定します。

ブラウザのセッション期間のみ有効なクッキーの場合は日数を0にし、クッキーを即時抹消する場合は負の日数を指定します。

有効期限は決められた形式で書かなければならないため、以下の手順を追っております。

先ず、現在時刻をgetTime()メソッドで取得します。
- 旧式のブラウザでは、new Date().getTime()と言う初期値が認識出来ないため、new Date()と i.getTime()に分けております。
続いて、その時刻から指定された有効日数を加えた時刻を計算してその値をgetTime()メソッドで取得します。
最後に、それをtoGMTStringに依ってクッキーで扱える国際協定時の文字列に変換したものをクッキーの書式に合わせた文字列にしてクッキー文字列に連結します。

必要ならここでその他の値を与える必要があるかも知れませんが(詳細はdocument.cookieプロパティの解説をご覧下さい)、ここでは有効期限のみ設定しております。

最後にdocument.cookieプロパティにクッキー文字列を代入する事で当該クッキーを更新します。

本頁の目次

食べた(読み込んだ)クッキーから特定の名前のものを取り出す函数・get_cookie()函数。

▲記事先頭
△前項目
▽次項目

二番目の処理は、実際に食べた(読み込んだ)クッキーから特定の名前のクッキーの値を取り出す処理を纏めたget_cookie()函数です。

その内容は以下のようになります。

読み飛ばす

//    クッキーから特定のキーの値を受け取る。
function get_cookie(nam) {
    var ck=document.cookie.split('; ');

    var i=-1;
    var j,k;
    while (++i<ck.length) {
        j=ck[i].split('=');
        if (j[0]==nam) return(unescape(j[1]));
        }
    return('');
}

先ず、document.cookieプロパティで読み込んだクッキーをsplit()メソッドで個々のクッキーに分割します。

個々のクッキーは「; 」で区切られているため、split(; )メソッドで文字列型の配列に変換する事が出来ます。

続いて、この中から引数で指定された名前のクッキーを見つけ出します。

これは配列ですので零番目から最後の要素まで(最後の要素の添字はlengthプロパティの値から 1を引いたものです)順番に診て行く事になります。

クッキーは「名前=値」と言うフォーマットになっておりますので、split(=)メソッドで名前と値に分割します。

このメソッドを実行した結果、名前は零番目の要素に、値は一番目の要素に入る事になります。

そして名前(零番目の要素)が引数と一致する場合、その値(一番目の要素)を値として返しますが、set_cookie()函数でも申し上げた通り、日本語文字を含む場合などはescape()函数でURLエンコードを行う必要があるため、読み出し時にはその逆の処理・URLデコードを行う必要があります。

これには、unescape()函数を使えば良いだけの話しです。

全部のクッキーを調べたにも拘らず、該当する名前のクッキーが無かった場合には、空文字列を返すようにしております。

本頁の目次

クッキーを食べて内容に合わせた表示を行って、その上でクッキーを更新する処理。

▲記事先頭
△前項目
▽次項目

今までの処理でJAVAスクリプトでもクッキーの取扱いが可能になりました。

ここから、実際にクッキーを利用する処理に入ります。

その内容は以下の通りです。

読み飛ばす

//    前回アクセス時刻を収めたクッキーを読み込む。
var la=get_cookie('lastaccessed');

//    読み込んだ値を返す。
if (la!='') {
    document.write('<ul><li>'+la+'</li></ul>');
    }
else {
    document.write('<ul><li>今回初めてのアクセスですね。</li></ul>');
    }

//    前回アクセス時刻を収めるクッキーを更新する。
//    日付文字列を作る。
var tm=new Date();
var yr=tm.getYear();
var mo=tm.getMonth()+1;
var dt=tm.getDate();
var hr=tm.getHours();
var mn=tm.getMinutes();
var sc=tm.getSeconds();

if (mo<10) { mo='0'+mo; }
if (dt<10) { dt='0'+dt; }
if (hr<10) { hr='0'+hr; }
if (mn<10) { mn='0'+mn; }
if (sc<10) { sc='0'+sc; }

if (yr>=1970) { yr-=1988 }
else { yr-=88; }
la='前回のアクセスは 平成'+yr+'年'+mo+'月'+dt+'日 '+hr+'時'+mn+'分'+sc+'秒でした。';

//    lastaccessedと言う名前の満30日間有効なクッキーに変数laの値を設定する。
set_cookie('lastaccessed',la,30);

まず、get_cookie('lastaccessed')函数で、'lastaccessed'と言う名前のクッキーを読み出します。

続いて、'lastaccessed'クッキーの内容に合わせてHTMLを書き出します。

クッキーの値が空文字列でない場合はdocument.write()メソッドでこのクッキーの内容HTML化して書き出します。
クッキーの値が空文字列の場合は'lastaccessed'クッキーはまだ存在していない、すなわちこの文書を始めて開いたものと判断して、<ul><li>今回初めてのアクセスですね。</li></ul>と言うHTMLをdocument.write()メソッドで書き出します。

その後、今回のアクセス時刻を日本語形式の文字列にして変数laに代入します。