001 /*
002 * Copyright (c) 2009 The openGion Project.
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
013 * either express or implied. See the License for the specific language
014 * governing permissions and limitations under the License.
015 */
016 package org.opengion.fukurou.db;
017
018 import org.opengion.fukurou.util.ApplicationInfo;
019
020
021 /**
022 * Transaction インターフェースを継承した、リアルタイ?ランザクションクラスです?
023 *
024 * これは??常のトランザクションクラスと異なり?トランザクション処?しません?
025 * つまり?トランザクション処?行わな?きに、メソ?等?共通的な使用ができるようにする?
026 * Connection のラ??クラスになります?
027 * ただし?こ?クラスが生成されてから、クローズされるまでは、?部に保留した Connection は?
028 * ずっと使?けられます?で、ConnectionFactory から取り出した Connection と同様に
029 * トランザクション性は維持されます?
030 * こ?クラスより作?された?Statement は、取り?し?で、きちんとクロース処?
031 *
032 * こ?クラスでは、コミット?ロールバック、クローズ処??、リアルタイ?行われます?
033 *
034 * @og.rev 5.1.9.0 (2010/08/01) 新規作?
035 * @og.rev 5.3.8.0 (2011/08/01) クラスの?構?変更
036 *
037 * @version 5.0
038 * @author Kazuhiko Hasegawa
039 * @since JDK6.0,
040 */
041 public class TransactionReal extends TransactionImpl {
042 //public class TransactionReal implements Transaction {
043 // private final Connection conn ;
044 // private final String dbid ;
045 // private ApplicationInfo appInfo = null;
046 // private String dbid = null;
047 // private Connection conn = null; // 5.3.7.0 (2011/07/01) ?? close するように変更します?
048
049 /**
050 * ApplicationInfo <del>と、DBID</del>を指定して作?する、コンストラクター
051 *
052 * こ?クラスは、トランザクション処?しな??合に、従来の Connection の
053 * 代わりに使用することを想定したクラスのオブジェクトを作?します?
054 *
055 * @og.rev 5.3.7.0 (2011/07/01) dbidを引数から削除
056 * @og.rev 5.3.8.0 (2011/08/01) 親クラスを呼ぶように変更
057 *
058 * @param appInfo ?統制用のアクセス??
059 */
060 // public TransactionReal( final String dbid , final ApplicationInfo appInfo ) {
061 public TransactionReal( final ApplicationInfo appInfo ) {
062 super( appInfo );
063 // this.appInfo = appInfo;
064 // this.dbid = dbid;
065 // this.conn = ConnectionFactory.connection( dbid,appInfo );
066 }
067
068 /**
069 * <del>?キャ?ュされて?、Connection オブジェクトを返します?</del>
070 * <del>??に呼ばれたときに、作?し?以降?、そのコネクションを返します?</del>
071 * 呼ばれる都度、新しい Connection を返します?ただし?Connection 自身は?
072 * ConnectionFactory から取得するため?基本?はキャ?ュされたConnectionです?
073 *
074 * @og.rev 5.3.7.0 (2011/07/01) dbidチェ?
075 * @og.rev 5.3.8.0 (2011/08/01) 親クラスのメソ?を呼ぶ為、?
076 *
077 * @param dbid 接続?ID (こ?クラスでは無視されま?
078 *
079 * @return ??DBID に対応した?Connection オブジェク?
080 */
081 // public Connection getConnection( final String dbid ) {
082 // if( conn != null ) { close(); }
083 //
084 // this.dbid = dbid;
085 // this.conn = ConnectionFactory.connection( dbid,appInfo );
086 // return conn ;
087 // }
088
089 /**
090 * コミット??行います?
091 *
092 * これは、呼ばれる都度、リアルタイ?処?ます?
093 *
094 * @og.rev 5.3.8.0 (2011/08/01) 親クラスのメソ?を呼ぶ為、?
095 *
096 * @return 正常:true/異常:false
097 */
098 // public boolean commit() {
099 // return Closer.commit( conn );
100 // }
101
102 /**
103 * ロールバック処?行います?
104 *
105 * これは、呼ばれる都度、リアルタイ?処?ます?
106 *
107 * @og.rev 5.3.8.0 (2011/08/01) 親クラスのメソ?を呼ぶ為、?
108 *
109 * @return 正常:true/異常:false
110 */
111 // public boolean rollback() {
112 // return Closer.rollback( conn );
113 // }
114
115 /**
116 * トランザクションの、終?処?行います?
117 *
118 * @og.rev 5.3.8.0 (2011/08/01) 親クラスのメソ?を呼ぶ為、?
119 *
120 * @see #close( boolean )
121 *
122 * @return 正常:true/異常:false
123 */
124 // public boolean close() {
125 // return close( false );
126 // }
127
128 /**
129 * コネクションの、終?処?行います?
130 *
131 * 引数は、正常かど?を判定するフラグです?異常の場合?、true をセ?します?
132 * これは、ConnectionFactory のプ?ルに戻すかど?を判断するのに使われます?
133 * ?でも?エラーが発生したコネクションは、??ます?
134 * それ以外?、?ールに戻します?
135 *
136 * @og.rev 5.3.7.0 (2011/07/01) close時に、コネクション?null 化しておく?
137 * @og.rev 5.3.8.0 (2011/08/01) 終???行い、親クラスのrealClose() を呼ぶ?
138 *
139 * @param errFlag [true:エラー状?false:通常]
140 *
141 * @return 正常:true/異常:false
142 */
143 @Override
144 public boolean close( final boolean errFlag ) {
145 // if( errFlag ) { ConnectionFactory.remove( conn,dbid ); } // 削除
146 // else { ConnectionFactory.close( conn,dbid ); } // 返却
147
148 // conn = null; // 5.3.7.0 (2011/07/01)
149 // return true;
150
151 // 5.3.8.0 (2011/08/01) 終???行い、親クラスのrealClose() を呼ぶ?
152 super.close( errFlag );
153 finish();
154 realClose();
155
156 return true;
157 }
158 }