/**
* Used to represent a single row of data from a data store.
*
* @author NathanWolf
*/
public class DataRow {
/**
* Create an empty DataRow.
*
* <p>This can be used to populate with data for setting data.
*/
public DataRow(DataTable dataTable) {
this.table = dataTable;
}
/**
* Retrieve a data field from this row by name.
*
* @param columnName The name of the DataField to find
* @return A data field, or null if not found
*/
public DataField get(String columnName) {
return fieldMap.get(columnName);
}
/**
* Get the table for this row.
*
* @return The table this row comes from
*/
public DataTable getTable() {
return table;
}
/**
* Retrieve all of the fields in this row.
*
* @return The internal list of fields
*/
public final List<DataField> getFields() {
return fields;
}
/**
* Add a new field to this row.
*
* <p>This is used to set up a row for writing to a store. Do not attempt to add the same field
* name twice.
*
* @param newField The datafield to add.
*/
public void add(DataField newField) {
String fieldName = newField.getName();
if (fieldName == null || fieldName.length() <= 0) {
log.warning("Persistence: Empty DataRow name");
return;
}
DataField existingField = fieldMap.get(fieldName);
if (existingField != null) {
log.warning("Persistence: Warning, duplicate field in DataRow: " + fieldName);
return;
}
if (newField.isIdField()) {
table.addIdFieldName(newField.getName());
}
fieldMap.put(fieldName, newField);
fields.add(newField);
}
public DataField getField(String fieldName) {
return fieldMap.get(fieldName);
}
public boolean isMigrationRequired(DataRow storeTableHeader) {
for (DataField field : fields) {
DataField storeField = storeTableHeader.getField(field.getName());
// TODO: Type compatibilty check:
// || storeField.getType() != field.getType())
// not sufficient ^ Will always auto-migrate.
if (storeField == null) {
return true;
}
}
return false;
}
protected DataTable table;
protected static Logger log = Persistence.getLogger();
protected HashMap<String, DataField> fieldMap = new HashMap<String, DataField>();
protected List<DataField> fields = new ArrayList<DataField>();
}
/**
* Represents a single field in a data row.
*
* @author NathanWolf
*/
public class DataField {
public DataField() {}
public DataField(Object value) {
this.value = value;
}
public DataField(String name, DataType type) {
this.name = name;
this.type = type;
}
public DataField(String name, DataType type, Object value) {
this.name = name;
this.type = type;
this.value = value;
}
public void setType(DataType type) {
this.type = type;
}
public DataType getType() {
return type;
}
public void setValue(Object value) {
this.value = value;
if (type == null) {
type = DataType.getTypeFromClass(value.getClass());
}
}
public Object getValue() {
return value;
}
public Object getValue(Class<?> targetClass) {
return DataType.convertValue(value, targetClass);
}
public void setName(String name) {
this.name = name;
}
public String getName() {
return name;
}
public void setAutogenerated(boolean autogenerate) {
this.autogenerate = autogenerate;
}
public boolean isAutogenerated() {
return autogenerate;
}
public void setIdField(boolean id) {
idField = id;
}
public boolean isIdField() {
return idField;
}
protected static Logger log = Persistence.getLogger();
protected DataType type;
protected Object value;
protected String name;
protected boolean autogenerate;
protected boolean idField;
}