transient キーワードの使用
transient キーワードは、保存ができず、Visualforce ページのビューステートの一部として送信することもできないインスタンス変数の宣言に使用します。次に例を示します。
1Transient Integer currentTotal;また、逐次化可能な Apex クラス (つまり、コントローラ、コントローラ拡張、Batchable または Schedulable インターフェースを実装するクラス) で transient キーワードを使用できます。また、逐次化可能なクラスで宣言する項目の型を定義するクラスで transient を使用できます。
変数を transient として宣言すると、ビューステートのサイズが縮小されます。transient キーワードは、Visualforce ページでページ要求の間のみ必要な項目でよく使用されます。この項目は、ページのビューステートには含まれず、要求中に何度も再計算するには非常に大きなシステムリソースを使用します。
Apex オブジェクトの中には、自動的に transient と判断されるものもあります。つまり、その値はページのビューステートの一部として保存されません。例として次のようなオブジェクトがあります。
- PageReferences
- XmlStream クラス
- コレクションが自動的に transient とマーキングされるのは、Savepoints のコレクションなど、コレクションに含まれているオブジェクトが自動的に transient とマーキングされている場合だけです。
- Schema.getGlobalDescribe などほとんどのオブジェクトがシステムメソッドにより自動的に生成されます。
- JSONParser クラスインスタンス。
また、静的な変数はページのビューステートを使用して転送されません。
次の例には、Visualforce ページとカスタムコントローラの両方が含まれてます。ページが更新されるごとに transient 日付は再作成されるため、[refresh] ボタンをクリックすると、日付が更新されます。非 transient 日付には、ビューステートから逐次化されなかった元の値が保持されるため、変わりません。
1<apex:page controller="ExampleController">
2 T1: {!t1} <br/>
3 T2: {!t2} <br/>
4 <apex:form>
5 <apex:commandLink value="refresh"/>
6 </apex:form>
7</apex:page>1public class ExampleController {
2
3 DateTime t1;
4 transient DateTime t2;
5
6 public String getT1() {
7 if (t1 == null) t1 = System.now();
8 return '' + t1;
9 }
10
11 public String getT2() {
12 if (t2 == null) t2 = System.now();
13 return '' + t2;
14 }
15}