WebSVN - OpenConcerto - Diff - Rev 156 and 182 - /trunk/OpenConcerto/src/org/openconcerto/sql/model/SQLRowAccessor.java

 /*
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
- * Copyright 2011 OpenConcerto, by ILM Informatique. All rights reserved.
+ * Copyright 2011-2019 OpenConcerto, by ILM Informatique. All rights reserved.
+ *
  * The contents of this file are subject to the terms of the GNU General Public License Version 3
  * only ("GPL"). You may not use this file except in compliance with the License. You can obtain a
  * copy of the License at http://www.gnu.org/licenses/gpl-3.0.html See the License for the specific
  * language governing permissions and limitations under the License.
  */
  package org.openconcerto.sql.model;
 import org.openconcerto.sql.Log;
+import org.openconcerto.sql.model.SQLTable.VirtualFields;
 import org.openconcerto.sql.model.graph.DatabaseGraph;
 import org.openconcerto.sql.model.graph.Link;
 import org.openconcerto.sql.model.graph.Link.Direction;
 import org.openconcerto.sql.model.graph.Step;
 import org.openconcerto.utils.NumberUtils;
 import org.openconcerto.utils.convertor.StringClobConvertor;
 import java.math.BigDecimal;
 import java.sql.Clob;
 import java.text.DateFormat;
+import java.util.ArrayList;
 import java.util.Calendar;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.Date;
 import java.util.HashSet;
     public abstract int getID();
     public abstract Number getIDNumber();
     /**
+     * Get the row reference.
+     *
+     * @return the row reference, <code>null</code> if some fields of the
+     *         {@link SQLTable#getPrimaryKeyFields() primary key} are missing or <code>null</code>.
+     */
+    public final RowRef getRowRef() {
+        final List<String> pkFields = this.getTable().getPKsNames();
+        final List<Object> pk = new ArrayList<>(pkFields.size());
+        for (final String f : pkFields) {
+            final Object o = this.getObject(f);
+            // Don't need contains() because a PK cannot contain NULL in the DB.
+            if (o == null)
+                return null;
+            pk.add(o);
+        }
+        return new RowRef(this.getTable(), Collections.unmodifiableList(pk), true);
+    }
+    /**
      * Whether this row is the undefined row. Return <code>false</code> if both the
      * {@link #getIDNumber() ID} and {@link SQLTable#getUndefinedIDNumber()} are <code>null</code>
      * since no row can have <code>null</code> primary key in the database. IOW when
      * {@link SQLTable#getUndefinedIDNumber()} is <code>null</code> the empty
      * <strong>foreign</strong> keys are <code>null</code>.
             return ((Boolean) archiveVal).booleanValue();
         else
             return ((Number) archiveVal).intValue() > 0;
+    }
+    public abstract SQLRowAccessor toImmutable();
+    public abstract boolean isFrozen();
     /**
      * Creates an SQLRow from these values, without any DB access.
+     *
      * @return an SQLRow with the same values as this.
      */
-    public abstract SQLRow asRow();
+    public final SQLRow asRow() {
+        return this.asRow(null);
+    }
+    public abstract SQLRow asRow(final Boolean immutable);
+    /**
+     * Return an immutable SQLRow with only the passed fields retained. I.e. the returned instance
+     * can consume less memory.
+     *
+     * @param fields which fields to retain.
+     * @return a {@link #isFrozen() frozen} SQLRow.
+     */
+    public final SQLRow trimmedRow(final VirtualFields fields) {
+        final Set<String> fieldsNames = this.getTable().getFieldsNames(fields);
+        if (this instanceof SQLRow && this.isFrozen() && fieldsNames.containsAll(this.getFields()))
+            return (SQLRow) this;
+        return SQLRow.trim(this, SQLRowAccessor::getValues, fieldsNames);
+    }
+    public final SQLRow fetchNewRow() {
+        return this.fetchNewRow(true);
+    }
+    /**
+     * Return a new instance with up-to-date values.
+     *
+     * @param useCache <code>true</code> to use the {@link SQLDataSource#isCacheEnabled() cache}.
+     * @return a new instance.
+     */
+    public final SQLRow fetchNewRow(final boolean useCache) {
+        return new SQLRow(this.getTable(), this.getID()).fetchValues(useCache);
+    }
     /**
      * Creates an SQLRowValues from these values, without any DB access.
+     *
      * @return an SQLRowValues with the same values as this.
      */
-    public abstract SQLRowValues asRowValues();
+    public final SQLRowValues asRowValues() {
+        return this.asRowValues(null);
+    }
+    /**
+     * Creates an SQLRowValues from these values, without any DB access.
+     *
+     * @param immutable <code>true</code> if the result must be
+     *        {@link SQLRowValuesCluster#isFrozen() frozen}, <code>false</code> if it must not,
+     *        <code>null</code> if the caller doesn't care and just wants the fastest result.
+     * @return an SQLRowValues with the same values as this.
+     */
+    public abstract SQLRowValues asRowValues(final Boolean immutable);
     /**
      * Creates an SQLRowValues with just this ID, and no other values.
+     *
      * @return an empty SQLRowValues.
         return this.getFields().contains(fieldName);
+    }
     public abstract Object getObject(String fieldName);
+    public abstract Object getObjectNoCheck(String fieldName);
     /**
      * Return the value for the passed field only if already present in this instance.
+     *
      * @param fieldName a field name.
      * @return the existing value for the passed field.

Dépôt officiel du code source de l'ERP OpenConcerto

svn://code.openconcerto.org/openconcerto

(root)/trunk/OpenConcerto/src/org/openconcerto/sql/model/SQLRowAccessor.java - Rev 156 → 182