Ground Sunlight

Windowsで作る - PHPプログラミングの開発環境

ユーザ用ツール

サイト用ツール

トレース:
apricot:app:db-model

差分

このページの2つのバージョン間の差分を表示します。

この比較画面にリンクする

両方とも前のリビジョン 前のリビジョン
次のリビジョン 		前のリビジョン
apricot:app:db-model [2020/05/11 21:53]
y2sunlight [モデルクラス] 		apricot:app:db-model [2020/05/23 14:58] (現在)
y2sunlight [モデルクラス]
行 1: 行 1:
->編集中 
- 
------ 
- 
 ====== Apricot データベースとモデル ====== ====== Apricot データベースとモデル ======
  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-05-06//  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-05-06//
行 18: 行 14:
     * Apricot データベースとモデル     * Apricot データベースとモデル
     * [[apricot:app:user-list|Apricot ユーザ一覧画面]]     * [[apricot:app:user-list|Apricot ユーザ一覧画面]]
-    * [[apricot:app:user-edit|Apricot ユーザ編集画面]]+    * [[apricot:app:user-edit|Apricot ユーザ登録画面]]
     * [[apricot:app:validation|Apricot バリデーション]]     * [[apricot:app:validation|Apricot バリデーション]]
     * [[apricot:app:transaction|Apricot トランザクション]]     * [[apricot:app:transaction|Apricot トランザクション]]
-  * [[apricot:ext:top|Apricot 拡張]]+  * [[apricot:ext:middleware|Apricot 拡張]]
  
 \\ \\
行 296: 行 292:
 ===== モデルクラス ===== ===== モデルクラス =====
  
-ORマッパーが使えるようになったので、モデルのベースクラス( Model )を作ります。Modelクラスは以下のメソッドを持ちます。詳しくはソースコードを参照して下さい。+ORマッパーが使えるようになったので、モデルのベースクラス( Model )を作ります。Modelクラスは必ず継承して使い、以下のメソッドを持ちます。詳しくはソースコードを参照して下さい。
  
 ^メソッド名^機能^ ^メソッド名^機能^
-|for_table()\\ :ORM|ORMオブジェクトを返します\\ テーブル名(snake_case)はクラス名(UpperCamelCase)から自動判定します。| +|tableName()\\ :string|テーブル名の取得\\ テーブル名(snake_case)はクラス名(UpperCamelCase)から自動判定します。| 
-|findAll()\\ :array|全件検索\\ ORMの配列を返します| +|for_table()\\ :ORM|ORMオブジェクトの取得| 
-|findOne\\ (int $id):mixed|主キー検索\\ 見つかった場合は ORM を、それ以外は false を返します|+|findAll()\\ :array|全件検索\\ ORMの配列を返します。| 
 +|findOne\\ (int $id):mixed|主キー検索\\ 見つかった場合は ORM を、それ以外は false を返します。|
 |create\\ (array $inputs=null):ORM|モデルの新規作成| |create\\ (array $inputs=null):ORM|モデルの新規作成|
-|insert\\ (array $inputs):bool|レコードの挿入| +|insert\\ (array $inputs):ORM|レコードの挿入| 
-|update\\ ($id, array $inputs):bool|レコードの更新\\ レコードが存在しない時、ApplicationExceptionが発生します。\\ 楽観的ロック例外を検知した時、OptimissticLockExceptionが発生します| +|update\\ ($id, array $inputs):ORM|レコードの更新\\ レコードが存在しない時、ApplicationExceptionが発生します。\\ 楽観的ロック例外を検知した時、OptimissticLockExceptionが発生します。| 
-|delete\\ ($id):bool|レコードの削除\\ レコードが存在しない時、ApplicationExceptionが発生します|+|delete\\ ($id):ORM|レコードの削除\\ レコードが存在しない時、ApplicationExceptionが発生します。| 
 +|isSuccess()\\ :bool|最新の更新結果を取得します(insert/update/delete)|
  
 ソースコードを以下に示します。 ソースコードを以下に示します。
行 323: 行 321:
 class Model class Model
 { {
 +    /**
 +     * 最新の更新結果(insert/update/delete)
 +     * @var bool
 +     */
 +    private $success = false;
 +
 +    /**
 +     * テーブル名の取得
 +     * @return string
 +     */
 +    public function tableName():string
 +    {
 +        return snake_case(get_short_class_name($this));
 +    }
 +    
     /**     /**
      * テーブルの取得      * テーブルの取得
行 329: 行 342:
     public function for_table():ORM     public function for_table():ORM
     {     {
-        return ORM::for_table(strtolower(get_short_class_name($this)));+        return ORM::for_table(snake_case(get_short_class_name($this)));
     }     }
  
行 363: 行 376:
      * 新規保存      * 新規保存
      * @param array $inputs      * @param array $inputs
-     * @return bool true on success or false on failure+     * @return \ORM
      */      */
-    public function insert(array $inputs):bool+    public function insert(array $inputs):ORM
     {     {
         $row = $this->for_table()->create($inputs);         $row = $this->for_table()->create($inputs);
         $row->set_expr('created_at', "datetime('now','localtime')");         $row->set_expr('created_at', "datetime('now','localtime')");
         $row->set_expr('updated_at', "datetime('now','localtime')");         $row->set_expr('updated_at', "datetime('now','localtime')");
-        return $row->save();+        $this->success = $row->save(); 
 +        return $row;
     }     }
  
行 377: 行 391:
      * @param mixed $id      * @param mixed $id
      * @param array $inputs      * @param array $inputs
-     * @return bool true on success or false on failure+     * @return \ORM
      */      */
-    public function update($id, array $inputs):bool+    public function update($id, array $inputs):ORM
     {     {
 +        // ApricotではSQLite3.0.8以上の使用を前提としており、トランザクション分離レベルはデフォルト値がDEFERREDです。
 +        // DEFERRED は最初の読み取り時に共有ロックが掛かります(SQLiteのロックはデータベースロックです)。
 +        // 従って、version_no読み取り後はトランザクション終了まで他の更新は発生しません。
 +        // NOTE: 他のデータベースの場合は、ここで行ロックを取得してレコードの検索を行います(select for update)
         $row = $this->for_table()->find_one($id);         $row = $this->for_table()->find_one($id);
         if ($row===false)         if ($row===false)
行 397: 行 415:
         $row->set_expr('updated_at', "datetime('now','localtime')");         $row->set_expr('updated_at', "datetime('now','localtime')");
         $row->set_expr('version_no', "version_no+1");         $row->set_expr('version_no', "version_no+1");
-        return $row->save();+        $this->success = $row->save(); 
 +        return $row;
     }     }
  
行 403: 行 422:
      * データ削除      * データ削除
      * @param mixed $id      * @param mixed $id
-     * @return bool true on success or false on failure+     * @return \ORM
      */      */
-    public function delete($id):bool+    public function delete($id):ORM
     {     {
         $row = $this->for_table()->find_one($id);         $row = $this->for_table()->find_one($id);
行 412: 行 431:
             throw new ApplicationException(__('messages.error.db.delete'));             throw new ApplicationException(__('messages.error.db.delete'));
         }         }
-        return $row->delete();+        $this->success = $row->delete(); 
 +        return $row; 
 +    } 
 + 
 +    /** 
 +     * 最新の更新結果の取得(insert/update/delete) 
 +     * @return bool 
 +     */ 
 +    public function isSuccess():bool 
 +    { 
 +        return $this->success;
     }     }
 } }
apricot/app/db-model.1589201592.txt.gz · 最終更新: 2020/05/11 21:53 by y2sunlight

ページ用ツール

特に明示されていない限り、本Wikiの内容は次のライセンスに従います： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki