<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFLOCK</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="説明">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFLOCK</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">説明</span>
<p>
共有データの整合性を維持します。次のロックを適用します。
</p>

<p>
<b>Exclusive</b>&#160;本文内の CFML 構造に対してシングルスレッドのアクセスを行うことができます。このタグの本文は、一度に 1 つのリクエストでしか実行できません。あるリクエストが排他的ロックをかけている間は、タグ内のコードを他のリクエストが開始することはできません。ColdFusion は、排他的ロックを早い者勝ちで適用します。
</p>

<p>
<b>Read-only</b>&#160;複数のリクエストがタグ本文内の CFML 構造に同時にアクセスできます。読み取り専用ロックは、共有データを読み取る場合にのみ使用し、共有データを修正する場合には使用しないでください。あるリクエストが共有データの排他的ロックを取得している場合、新規リクエストはその排他的ロックが解除されるのを待機することになります。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">カテゴリ</span>
<p>
アプリケーションフレームワークタグ
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">シンタックス</span><pre>&lt;cflock
   timeout = &quot;timeout in seconds &quot;
   scope = &quot;Application&quot;、&quot;Server&quot;、&quot;Session&quot;
   name = &quot;lockname&quot;
   throwOnTimeout = &quot;yes&quot;、&quot;no&quot;
   type = &quot;readOnly&quot;、&quot;exclusive&quot;&gt; 
   &lt;!--- 同期化する CFML ---&gt; 
&lt;/cflock&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">関連項目</span>
<p>
cfapplication、cfassociate、cfmodule、『ColdFusion MX 開発ガイド』の第15章の「パーシスタントデータとロックの使用」 
</p>

<p>

</p>
<table>
  <tr valign="top">
    <td width="30"><strong>メモ: </strong></td>
    <td>共有データの構造体、ファイル、および CFX を更新するコードのスコープを制限してください。排他的ロックはこれらの更新の整合性を確保するために必要ですが、読み取り専用ロックの方が高速に処理されます。パフォーマンスを重視するアプリケーションの場合は、共有データを読み取るときなどは、できるかぎり排他的ロックではなく読み取り専用ロックを使用してください。</td>
  </tr>
</table>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">使用方法</span>
<p>
ColdFusion&#160;MX はマルチスレッドサーバーです。したがって、一度に複数のページリクエストを処理することができます。cflock タグは、次の目的で使用します。
</p>
<ul>

<li>同時に実行されるリクエストでの共有データやオブジェクトに対する修正が、整然とした順序で行われるようにします。</li>

<li>ファイル操作の構造をこのタグで囲み、ファイルの更新時に他のアプリケーションやタグがそのファイルを書き込み用に開いていることがないようにします。</li>

<li>CFX 呼び出しをこのタグで囲み、スレッドセーフな方法で実装されていない CFX を ColdFusion で安全に呼び出せるようにします (これは、C++ で開発された CFX にのみ該当します)。 </li>
</ul>

<p>
ColdFusion を安全に動作させるには、共有 (グローバル) データ構造体の管理と操作を行う C++ CFX がスレッドセーフでなければなりません。しかし、これには高度な知識が必要です。CFML カスタムタグラッパーで CFX を囲むと、呼び出しをスレッドセーフにすることができます。
</p>

<p>
共有スコープで変数の表示、設定、更新を行う場合は、scope 属性を使用して Server、Application、Session のいずれかを特定してください。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title"></span>
<p>
デッドロックとは、ページ内のロックされた部分のコードをどのリクエストも実行できない状態です。デッドロックが発生すると、どのユーザーもロックを解除できなくなります。なぜなら、ロックタイムアウトによってデッドロックが解消されるまで、ページ内の保護されたセクションへのリクエストはすべて拒否されるからです。
</p>

<p>
cflock タグでは、カーネルレベルの同期オブジェクトを使用します。このオブジェクトは、それを使用しているスレッドがタイムアウトするか異常終了した時点で、自動的に解放されます。したがって、ColdFusion が cflock タグの処理中に永遠にデッドロックされることはありません。しかし、タイムアウト時間が長すぎると、リクエストスレッドが長時間にわたってブロックされ、スループットが急激に低下する可能性があります。これを避けるには、常に最低限のタイムアウト値を使用してください。
</p>

<p>
リクエストスレッドがブロックされる別の原因としては、cflock タグのネスト構造やロック名が一貫していないことが考えられます。ロックをネストする場合は、ロックされた変数にアクセスするコードが、一貫して同じ順序で cflock タグをネストする必要があります。そうしないと、デッドロックが発生する可能性があります。 
</p>

<p>
次に、デッドロックが発生する例を示します。
</p>

<p>
</p><div align="left">
<table border="1">
  <caption></caption>
  <tr align="center">    <th colspan="2" rowspan="1"><strong>ユーザーが 2 人の場合のデッドロックの例</strong></th>
</tr>
  <tr align="center">    <th><strong>ユーザー 1</strong></th>
    <th><strong>ユーザー 2</strong></th>
</tr>
  <tr align="left">    <td>
<p>Session スコープをロックします。</p></td>
    <td>
<p>Application スコープをロックします。</p></td>
</tr>
  <tr align="left">    <td>
<p>デッドロック : Application スコープをロックしようとしますが、Application スコープはユーザー 2 によって既にロックされています。</p></td>
    <td>
<p>デッドロック : Session スコープをロックしようとしますが、Session スコープはユーザー 1 によって既にロックされています。</p></td>
</tr>
</table>
</div>
<p>
</p>

<p>
読み取りロックの中に排他的ロックをネストしようとすると、次のようなデッドロックが発生する可能性があります。 
</p>

<p>
</p><div align="left">
<table border="1">
  <caption></caption>
  <tr align="center">    <th><strong>ユーザーが 1 人の場合のデッドロックの例</strong></th>
</tr>
  <tr align="center">    <th><strong>ユーザー 1</strong></th>
</tr>
  <tr align="left">    <td>
<p>Session スコープを読み取りロックでロックします。</p></td>
</tr>
  <tr align="left">    <td>
<p>Session スコープを排他的ロックでロックしようとします。 </p></td>
</tr>
  <tr align="left">    <td>
<p>デッドロック : Session スコープは既に読み取りロックでロックされているので、Session スコープを排他的ロックでロックすることはできません。</p></td>
</tr>
</table>
</div>
<p>
</p>

<p>
次のコードは、この事例を示しています。
</p>
<pre>&lt;cflock timeout = &quot;60&quot; scope = &quot;SESSION&quot; type = &quot;readOnly&quot;&gt;
   ...............
   &lt;cflock timeout = &quot;60&quot; scope = &quot;SESSION&quot; type = &quot;Exclusive&quot;&gt;
   .........
   &lt;/cflock&gt;
&lt;/cflock&gt;
</pre>
<p>
デッドロックを避けるには、ロックをネストするすべてのコードが、一貫した順序でネストし、一貫した名前を付ける必要があります。Server、Application、および Session スコープへのアクセスをロックする必要がある場合は、次の順序に従ってください。
</p>
<ol type="1">

<li>Session スコープをロックします。cflock タグ内で、scope = &quot;session&quot; を指定します。</li>

<li>Application スコープをロックします。cflock タグ内で、scope = &quot;Application&quot; を指定します。</li>

<li>Server スコープをロックします。cflock タグ内で、scope = &quot;server&quot; を指定します。</li>

<li>Server スコープのロックを解除します。</li>

<li>Application スコープのロックを解除します。</li>

<li>Session スコープのロックを解除します。</li>
</ol>
<table>
  <tr valign="top">
    <td width="30"><strong>メモ: </strong></td>
    <td>スコープをロックする必要がない場合は、そのスコープのロックとロック解除の手順を省略できます。たとえば、Server スコープをロックする必要がない場合は、手順 3 と 4 を省略できます。名前付きロックにも同様のルールが適用されます。</td>
  </tr>
</table>
<p>
詳細については、次のドキュメントや Web サイトを参照してください。
</p>
<ul>

<li>『ColdFusion MX 開発ガイド』の第15章の「パーシスタントデータとロックの使用」  </li>

<li>弊社 Web サイト http://www.macromedia.com/support/service/</a> の記事 20370、「ColdFusion Locking Best Practices」</li>
</ul>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">例</span><pre>&lt;!--- この例では、cflock を使用して Application、Server、および Session スコープ内の変数に対する
データ更新の一貫性を保つ方法を示します。 ---&gt;

&lt;!---&#160;次のコードをアプリケーションのルートディレクトリの &quot;Application.cfm&quot; ファイルにコピーします。 ---&gt;
&lt;!----------------&#160;&#160;&#160;Application.cfm のコードの先頭&#160;&#160;&#160;---------------&gt;
&lt;!--- cfapplication タグは、ColdFusion アプリケーションのスコープを定義し、
アプリケーション変数やセッション変数の保管を有効または無効にします。
このタグを、Application.cfm という特殊なファイルに挿入します。
このファイルは、同じディレクトリ内にある他のどの ColdFusion ページよりも先に実行されます。 ---&gt;

&lt;!--- このアプリケーションのセッション管理を有効化します。 ---&gt;
&lt;cfapplication name = &quot;ETurtle&quot;
   sessionTimeout = #CreateTimeSpan(0,0, 0, 60)# 
   sessionManagement = &quot;yes&quot;&gt;

&lt;!--- E-Turtleneck で使用されるセッション変数とアプリケーション変数を初期化します。 
セッション変数にセッションスコープを使用します。 ---&gt; 
&lt;cflock scope = &quot;Session&quot;
   timeout = &quot;30&quot; type = &quot;Exclusive&quot;&gt;
   &lt;cfif NOT IsDefined(&quot;session.size&quot;)&gt;
      &lt;cfset session.size = &quot;&quot;&gt;
   &lt;/cfif&gt;
   &lt;cfif NOT IsDefined(&quot;session.color&quot;)&gt;
      &lt;cfset session.color = &quot;&quot;&gt;
   &lt;/cfif&gt;
&lt;/cflock&gt;

&lt;!--- タートルネックの販売数を記録する、アプリケーション全体を対象とする変数に
      対してアプリケーションロックを使用します。
      Application スコープを扱うためのより効率的な (ただし少々複雑な) 方法については、
      『ColdFusion MX 開発ガイド』を参照してください。---&gt;
&lt;cflock scope = &quot;Application&quot;       timeout = &quot;30&quot; type = &quot;Exclusive&quot;&gt;
   &lt;cfif NOT IsDefined(&quot;application.number&quot;)&gt;
      &lt;cfset application.number = 0&gt;
   &lt;/cfif&gt;
&lt;/cflock&gt;

&lt;!----------------------- Application.cfm の末尾 -----------------------&gt;    

&lt;h3&gt;cflock の例&lt;/h3&gt;

&lt;cfif IsDefined(&quot;form.submit&quot;)&gt;
&lt;!--- フォームが送信されているので、リクエストを処理します。 ---&gt;
   &lt;cfoutput&gt;
      E-Turtleneck をご利用いただき、ありがとうございます。ご注文いただいたタートルネックのサイズは 
&lt;b&gt;#form.size#&lt;/b&gt;、
      色は &lt;b&gt;#form.color#&lt;/b&gt; です。&lt;br&gt;&lt;br&gt;
   &lt;/cfoutput&gt;

&lt;!--- セッション変数に値を代入するコードをロックします。 ----&gt; 
   &lt;cflock scope = &quot;Session&quot; timeout = &quot;30&quot; type = &quot;Exclusive&quot;&gt;
      &lt;cfparam name = session.size Default = #form.size#&gt;
      &lt;cfparam name = session.color Default = #form.color#&gt;
   &lt;/cflock&gt;

&lt;!---- Application スコープで販売されたタートルネックの数を更新する
      コードをロックします。 ---&gt; 
   &lt;cflock scope = &quot;Application&quot; timeout = &quot;30&quot; type = &quot;Exclusive&quot;&gt;
      &lt;cfset application.number = application.number + 1&gt;
   &lt;cfoutput&gt;
      これで、E-Turtleneck のタートルネック販売数は #application.number# 枚になりました。
   &lt;/cfoutput&gt;
   &lt;/cflock&gt;

&lt;cfelse&gt;
&lt;!--- 送信されていない場合にのみフォームを表示します。 ---&gt;
   &lt;cflock scope = &quot;Application&quot; timeout = &quot;30&quot; type = &quot;Readonly&quot;&gt;
      &lt;cfoutput&gt;
         E-Turtleneck は、これまでに、#application.number# 枚のタートルネックを販売しました。
      &lt;/cfoutput&gt;
   &lt;/cflock&gt;

   &lt;form method=&quot;post&quot; action=&quot;cflocktest.cfm&quot;&gt;
      &lt;p&gt;おめでとうございます。世界で最も快適な着心地のタートルネックをお選びいただきました。
      ご希望の色とサイズをお選びください。&lt;/p&gt;
      &lt;table cellspacing = &quot;2&quot; cellpadding = &quot;2&quot; border = &quot;0&quot;&gt;
         &lt;tr&gt;
            &lt;td&gt;色をお選びください。&lt;/td&gt;
            &lt;td&gt;&lt;select type = &quot;Text&quot; name = &quot;color&quot;&gt;
                  &lt;option&gt;レッド
                  &lt;option&gt;ホワイト
                  &lt;option&gt;ブルー
                  &lt;option&gt;ターコイズ
                  &lt;option&gt;ブラック
                  &lt;option&gt;オリーブグリーン
               &lt;/select&gt;
            &lt;/td&gt;
         &lt;/tr&gt;
         &lt;tr&gt;
            &lt;td&gt;サイズをお選びください。&lt;/td&gt;
            &lt;td&gt;&lt;select type = &quot;Text&quot; name = &quot;size&quot; &gt;
                  &lt;option&gt;XX スモール
                  &lt;option&gt;X スモール
                  &lt;option&gt;スモール
                  &lt;option&gt;ミディアム
                  &lt;option&gt;ラージ
                  &lt;option&gt;X ラージ
               &lt;/select&gt;
            &lt;/td&gt;
         &lt;/tr&gt;
         &lt;tr&gt;
            &lt;td&gt;選択したら [送信] を押してください。&lt;/td&gt;
            &lt;td&gt;&lt;input type = &quot;Submit&quot; name = &quot;submit&quot; value = &quot;送信&quot;&gt; &lt;/td&gt;
         &lt;/tr&gt;
      &lt;/table&gt;
   &lt;/form&gt;
&lt;/cfif&gt;
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="TIMEOUT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TIMEOUT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>ロックを取得するときに待機する最大時間を秒単位で指定します。ロックが取得されると、タグの実行は継続します。ロックを取得できない場合の動作は、throwOnTimeout 属性の値によって異なります。timout=&quot;0&quot; を指定した場合、タイムアウトは ColdFusion MX Administrator の [設定] ページでの &quot;リクエストタイムアウト x&quot; の設定 (この設定が有効なとき) により決まります。ただし、この設定が有効でない場合に timeout=&quot;0&quot; を指定すると、ColdFusion はロックを取得するまで無限に待機することになります。</p>

  </td>
  </tr>
  </table>
</div>
<div id="SCOPE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SCOPE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>ロックのスコープです。name 属性とは排他の関係です。ロック名です。指定のスコープ内では、一度に 1 つのリクエストだけがこのタグ内のコード (または同じロックスコープの別の cflock タグ内のコード) を実行できます。 </p><ul>

<li>Application</li>

<li>Server</li>

<li>Session</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="NAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">NAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>ロック名です。scope 属性と併用することはできません。特定の名前を持つ cflock タグ内のコードを実行できるのは、一度に 1 つのリクエストだけに限られます。空の文字列は指定できません。</p>
<p>アプリケーションのさまざまな部分からのリソースへのアクセスを同期化できます。ロック名は、ColdFusion サーバーに対してグローバルです。ロック名は、アプリケーションおよびユーザーセッション間で共有できますが、クラスタ化された複数のサーバー間にわたって共有することはできません。</p>

  </td>
  </tr>
  </table>
</div>
<div id="THROWONTIMEOUT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">THROWONTIMEOUT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "yes"


<p>タイムアウト条件を処理する方法です。</p><ul>

<li>yes: タイムアウト時に例外が生成されます。</li>

<li>no: このタグの時間を経過しても実行が継続されます。</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="TYPE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TYPE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "Exclusive"

<ul>

<li>readOnly: 複数のリクエストで共有データを読み取ることができます。</li>

<li>exclusive: 1 つのリクエストで共有データを読み書きできます。</li>
</ul>


  </td>
  </tr>
  </table>
</div>

  </body>
</html>
