Java tutorial
/** * Genji Scrum Tool and Issue Tracker * Copyright (C) 2015 Steinbeis GmbH & Co. KG Task Management Solutions * <a href="http://www.trackplus.com">Genji Scrum Tool</a> * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>. */ /* $Id:$ */ package com.aurel.track.persist; import java.math.BigDecimal; import java.sql.Connection; import java.util.ArrayList; import java.util.Collections; import java.util.Date; import java.util.List; import org.apache.commons.lang.ObjectUtils; import org.apache.torque.TorqueException; import org.apache.torque.map.TableMap; import org.apache.torque.om.BaseObject; import org.apache.torque.om.ComboKey; import org.apache.torque.om.DateKey; import org.apache.torque.om.NumberKey; import org.apache.torque.om.ObjectKey; import org.apache.torque.om.SimpleKey; import org.apache.torque.om.StringKey; import org.apache.torque.om.Persistent; import org.apache.torque.util.Criteria; import org.apache.torque.util.Transaction; import com.aurel.track.persist.TEscalationEntry; import com.aurel.track.persist.TEscalationEntryPeer; import com.aurel.track.persist.TState; import com.aurel.track.persist.TStatePeer; import org.apache.commons.collections.map.IdentityMap; import java.util.Iterator; import com.aurel.track.beans.TEscalationStateBean; import com.aurel.track.beans.TEscalationEntryBean; import com.aurel.track.beans.TStateBean; /** * You should not use this class directly. It should not even be * extended all references should be to TEscalationState */ public abstract class BaseTEscalationState extends TpBaseObject { /** The Peer class */ private static final TEscalationStatePeer peer = new TEscalationStatePeer(); /** The value for the objectID field */ private Integer objectID; /** The value for the escalationentry field */ private Integer escalationentry; /** The value for the status field */ private Integer status; /** The value for the uuid field */ private String uuid; /** * Get the ObjectID * * @return Integer */ public Integer getObjectID() { return objectID; } /** * Set the value of ObjectID * * @param v new value */ public void setObjectID(Integer v) { if (!ObjectUtils.equals(this.objectID, v)) { this.objectID = v; setModified(true); } } /** * Get the Escalationentry * * @return Integer */ public Integer getEscalationentry() { return escalationentry; } /** * Set the value of Escalationentry * * @param v new value */ public void setEscalationentry(Integer v) throws TorqueException { if (!ObjectUtils.equals(this.escalationentry, v)) { this.escalationentry = v; setModified(true); } if (aTEscalationEntry != null && !ObjectUtils.equals(aTEscalationEntry.getObjectID(), v)) { aTEscalationEntry = null; } } /** * Get the Status * * @return Integer */ public Integer getStatus() { return status; } /** * Set the value of Status * * @param v new value */ public void setStatus(Integer v) throws TorqueException { if (!ObjectUtils.equals(this.status, v)) { this.status = v; setModified(true); } if (aTState != null && !ObjectUtils.equals(aTState.getObjectID(), v)) { aTState = null; } } /** * Get the Uuid * * @return String */ public String getUuid() { return uuid; } /** * Set the value of Uuid * * @param v new value */ public void setUuid(String v) { if (!ObjectUtils.equals(this.uuid, v)) { this.uuid = v; setModified(true); } } private TEscalationEntry aTEscalationEntry; /** * Declares an association between this object and a TEscalationEntry object * * @param v TEscalationEntry * @throws TorqueException */ public void setTEscalationEntry(TEscalationEntry v) throws TorqueException { if (v == null) { setEscalationentry((Integer) null); } else { setEscalationentry(v.getObjectID()); } aTEscalationEntry = v; } /** * Returns the associated TEscalationEntry object. * If it was not retrieved before, the object is retrieved from * the database * * @return the associated TEscalationEntry object * @throws TorqueException */ public TEscalationEntry getTEscalationEntry() throws TorqueException { if (aTEscalationEntry == null && (!ObjectUtils.equals(this.escalationentry, null))) { aTEscalationEntry = TEscalationEntryPeer.retrieveByPK(SimpleKey.keyFor(this.escalationentry)); } return aTEscalationEntry; } /** * Return the associated TEscalationEntry object * If it was not retrieved before, the object is retrieved from * the database using the passed connection * * @param connection the connection used to retrieve the associated object * from the database, if it was not retrieved before * @return the associated TEscalationEntry object * @throws TorqueException */ public TEscalationEntry getTEscalationEntry(Connection connection) throws TorqueException { if (aTEscalationEntry == null && (!ObjectUtils.equals(this.escalationentry, null))) { aTEscalationEntry = TEscalationEntryPeer.retrieveByPK(SimpleKey.keyFor(this.escalationentry), connection); } return aTEscalationEntry; } /** * Provides convenient way to set a relationship based on a * ObjectKey, for example * <code>bar.setFooKey(foo.getPrimaryKey())</code> * */ public void setTEscalationEntryKey(ObjectKey key) throws TorqueException { setEscalationentry(new Integer(((NumberKey) key).intValue())); } private TState aTState; /** * Declares an association between this object and a TState object * * @param v TState * @throws TorqueException */ public void setTState(TState v) throws TorqueException { if (v == null) { setStatus((Integer) null); } else { setStatus(v.getObjectID()); } aTState = v; } /** * Returns the associated TState object. * If it was not retrieved before, the object is retrieved from * the database * * @return the associated TState object * @throws TorqueException */ public TState getTState() throws TorqueException { if (aTState == null && (!ObjectUtils.equals(this.status, null))) { aTState = TStatePeer.retrieveByPK(SimpleKey.keyFor(this.status)); } return aTState; } /** * Return the associated TState object * If it was not retrieved before, the object is retrieved from * the database using the passed connection * * @param connection the connection used to retrieve the associated object * from the database, if it was not retrieved before * @return the associated TState object * @throws TorqueException */ public TState getTState(Connection connection) throws TorqueException { if (aTState == null && (!ObjectUtils.equals(this.status, null))) { aTState = TStatePeer.retrieveByPK(SimpleKey.keyFor(this.status), connection); } return aTState; } /** * Provides convenient way to set a relationship based on a * ObjectKey, for example * <code>bar.setFooKey(foo.getPrimaryKey())</code> * */ public void setTStateKey(ObjectKey key) throws TorqueException { setStatus(new Integer(((NumberKey) key).intValue())); } private static List<String> fieldNames = null; /** * Generate a list of field names. * * @return a list of field names */ public static synchronized List<String> getFieldNames() { if (fieldNames == null) { fieldNames = new ArrayList<String>(); fieldNames.add("ObjectID"); fieldNames.add("Escalationentry"); fieldNames.add("Status"); fieldNames.add("Uuid"); fieldNames = Collections.unmodifiableList(fieldNames); } return fieldNames; } /** * Retrieves a field from the object by field (Java) name passed in as a String. * * @param name field name * @return value */ public Object getByName(String name) { if (name.equals("ObjectID")) { return getObjectID(); } if (name.equals("Escalationentry")) { return getEscalationentry(); } if (name.equals("Status")) { return getStatus(); } if (name.equals("Uuid")) { return getUuid(); } return null; } /** * Set a field in the object by field (Java) name. * * @param name field name * @param value field value * @return True if value was set, false if not (invalid name / protected field). * @throws IllegalArgumentException if object type of value does not match field object type. * @throws TorqueException If a problem occurs with the set[Field] method. */ public boolean setByName(String name, Object value) throws TorqueException, IllegalArgumentException { if (name.equals("ObjectID")) { // Object fields can be null if (value != null && !Integer.class.isInstance(value)) { throw new IllegalArgumentException("Invalid type of object specified for value in setByName"); } setObjectID((Integer) value); return true; } if (name.equals("Escalationentry")) { // Object fields can be null if (value != null && !Integer.class.isInstance(value)) { throw new IllegalArgumentException("Invalid type of object specified for value in setByName"); } setEscalationentry((Integer) value); return true; } if (name.equals("Status")) { // Object fields can be null if (value != null && !Integer.class.isInstance(value)) { throw new IllegalArgumentException("Invalid type of object specified for value in setByName"); } setStatus((Integer) value); return true; } if (name.equals("Uuid")) { // Object fields can be null if (value != null && !String.class.isInstance(value)) { throw new IllegalArgumentException("Invalid type of object specified for value in setByName"); } setUuid((String) value); return true; } return false; } /** * Retrieves a field from the object by name passed in * as a String. The String must be one of the static * Strings defined in this Class' Peer. * * @param name peer name * @return value */ public Object getByPeerName(String name) { if (name.equals(TEscalationStatePeer.OBJECTID)) { return getObjectID(); } if (name.equals(TEscalationStatePeer.ESCALATIONENTRY)) { return getEscalationentry(); } if (name.equals(TEscalationStatePeer.STATUS)) { return getStatus(); } if (name.equals(TEscalationStatePeer.TPUUID)) { return getUuid(); } return null; } /** * Set field values by Peer Field Name * * @param name field name * @param value field value * @return True if value was set, false if not (invalid name / protected field). * @throws IllegalArgumentException if object type of value does not match field object type. * @throws TorqueException If a problem occurs with the set[Field] method. */ public boolean setByPeerName(String name, Object value) throws TorqueException, IllegalArgumentException { if (TEscalationStatePeer.OBJECTID.equals(name)) { return setByName("ObjectID", value); } if (TEscalationStatePeer.ESCALATIONENTRY.equals(name)) { return setByName("Escalationentry", value); } if (TEscalationStatePeer.STATUS.equals(name)) { return setByName("Status", value); } if (TEscalationStatePeer.TPUUID.equals(name)) { return setByName("Uuid", value); } return false; } /** * Retrieves a field from the object by Position as specified * in the xml schema. Zero-based. * * @param pos position in xml schema * @return value */ public Object getByPosition(int pos) { if (pos == 0) { return getObjectID(); } if (pos == 1) { return getEscalationentry(); } if (pos == 2) { return getStatus(); } if (pos == 3) { return getUuid(); } return null; } /** * Set field values by its position (zero based) in the XML schema. * * @param position The field position * @param value field value * @return True if value was set, false if not (invalid position / protected field). * @throws IllegalArgumentException if object type of value does not match field object type. * @throws TorqueException If a problem occurs with the set[Field] method. */ public boolean setByPosition(int position, Object value) throws TorqueException, IllegalArgumentException { if (position == 0) { return setByName("ObjectID", value); } if (position == 1) { return setByName("Escalationentry", value); } if (position == 2) { return setByName("Status", value); } if (position == 3) { return setByName("Uuid", value); } return false; } /** * Stores the object in the database. If the object is new, * it inserts it; otherwise an update is performed. * * @throws Exception */ public void save() throws Exception { save(TEscalationStatePeer.DATABASE_NAME); } /** * Stores the object in the database. If the object is new, * it inserts it; otherwise an update is performed. * Note: this code is here because the method body is * auto-generated conditionally and therefore needs to be * in this file instead of in the super class, BaseObject. * * @param dbName * @throws TorqueException */ public void save(String dbName) throws TorqueException { Connection con = null; try { con = Transaction.begin(dbName); save(con); Transaction.commit(con); } catch (TorqueException e) { Transaction.safeRollback(con); throw e; } } /** flag to prevent endless save loop, if this object is referenced by another object which falls in this transaction. */ private boolean alreadyInSave = false; /** * Stores the object in the database. If the object is new, * it inserts it; otherwise an update is performed. This method * is meant to be used as part of a transaction, otherwise use * the save() method and the connection details will be handled * internally * * @param con * @throws TorqueException */ public void save(Connection con) throws TorqueException { if (!alreadyInSave) { alreadyInSave = true; // If this object has been modified, then save it to the database. if (isModified()) { if (isNew()) { TEscalationStatePeer.doInsert((TEscalationState) this, con); setNew(false); } else { TEscalationStatePeer.doUpdate((TEscalationState) this, con); } } alreadyInSave = false; } } /** * Set the PrimaryKey using ObjectKey. * * @param key objectID ObjectKey */ public void setPrimaryKey(ObjectKey key) { setObjectID(new Integer(((NumberKey) key).intValue())); } /** * Set the PrimaryKey using a String. * * @param key */ public void setPrimaryKey(String key) { setObjectID(new Integer(key)); } /** * returns an id that differentiates this object from others * of its class. */ public ObjectKey getPrimaryKey() { return SimpleKey.keyFor(getObjectID()); } /** * Makes a copy of this object. * It creates a new object filling in the simple attributes. * It then fills all the association collections and sets the * related objects to isNew=true. */ public TEscalationState copy() throws TorqueException { return copy(true); } /** * Makes a copy of this object using connection. * It creates a new object filling in the simple attributes. * It then fills all the association collections and sets the * related objects to isNew=true. * * @param con the database connection to read associated objects. */ public TEscalationState copy(Connection con) throws TorqueException { return copy(true, con); } /** * Makes a copy of this object. * It creates a new object filling in the simple attributes. * If the parameter deepcopy is true, it then fills all the * association collections and sets the related objects to * isNew=true. * * @param deepcopy whether to copy the associated objects. */ public TEscalationState copy(boolean deepcopy) throws TorqueException { return copyInto(new TEscalationState(), deepcopy); } /** * Makes a copy of this object using connection. * It creates a new object filling in the simple attributes. * If the parameter deepcopy is true, it then fills all the * association collections and sets the related objects to * isNew=true. * * @param deepcopy whether to copy the associated objects. * @param con the database connection to read associated objects. */ public TEscalationState copy(boolean deepcopy, Connection con) throws TorqueException { return copyInto(new TEscalationState(), deepcopy, con); } /** * Fills the copyObj with the contents of this object. * The associated objects are also copied and treated as new objects. * * @param copyObj the object to fill. */ protected TEscalationState copyInto(TEscalationState copyObj) throws TorqueException { return copyInto(copyObj, true); } /** * Fills the copyObj with the contents of this object using connection. * The associated objects are also copied and treated as new objects. * * @param copyObj the object to fill. * @param con the database connection to read associated objects. */ protected TEscalationState copyInto(TEscalationState copyObj, Connection con) throws TorqueException { return copyInto(copyObj, true, con); } /** * Fills the copyObj with the contents of this object. * If deepcopy is true, The associated objects are also copied * and treated as new objects. * * @param copyObj the object to fill. * @param deepcopy whether the associated objects should be copied. */ protected TEscalationState copyInto(TEscalationState copyObj, boolean deepcopy) throws TorqueException { copyObj.setObjectID(objectID); copyObj.setEscalationentry(escalationentry); copyObj.setStatus(status); copyObj.setUuid(uuid); copyObj.setObjectID((Integer) null); if (deepcopy) { } return copyObj; } /** * Fills the copyObj with the contents of this object using connection. * If deepcopy is true, The associated objects are also copied * and treated as new objects. * * @param copyObj the object to fill. * @param deepcopy whether the associated objects should be copied. * @param con the database connection to read associated objects. */ protected TEscalationState copyInto(TEscalationState copyObj, boolean deepcopy, Connection con) throws TorqueException { copyObj.setObjectID(objectID); copyObj.setEscalationentry(escalationentry); copyObj.setStatus(status); copyObj.setUuid(uuid); copyObj.setObjectID((Integer) null); if (deepcopy) { } return copyObj; } /** * returns a peer instance associated with this om. Since Peer classes * are not to have any instance attributes, this method returns the * same instance for all member of this class. The method could therefore * be static, but this would prevent one from overriding the behavior. */ public TEscalationStatePeer getPeer() { return peer; } /** * Retrieves the TableMap object related to this Table data without * compiler warnings of using getPeer().getTableMap(). * * @return The associated TableMap object. */ public TableMap getTableMap() throws TorqueException { return TEscalationStatePeer.getTableMap(); } /** * Creates a TEscalationStateBean with the contents of this object * This also creates beans for cached related objects, if they exist * @return a TEscalationStateBean with the contents of this object */ public TEscalationStateBean getBean() { return getBean(new IdentityMap()); } /** * Creates a TEscalationStateBean with the contents of this object * intended for internal use only * @param createdBeans a IdentityMap which maps objects * to already created beans * @return a TEscalationStateBean with the contents of this object */ public TEscalationStateBean getBean(IdentityMap createdBeans) { TEscalationStateBean result = (TEscalationStateBean) createdBeans.get(this); if (result != null) { // we have already created a bean for this object, return it return result; } // no bean exists for this object; create a new one result = new TEscalationStateBean(); createdBeans.put(this, result); result.setObjectID(getObjectID()); result.setEscalationentry(getEscalationentry()); result.setStatus(getStatus()); result.setUuid(getUuid()); if (aTEscalationEntry != null) { TEscalationEntryBean relatedBean = aTEscalationEntry.getBean(createdBeans); result.setTEscalationEntryBean(relatedBean); } if (aTState != null) { TStateBean relatedBean = aTState.getBean(createdBeans); result.setTStateBean(relatedBean); } result.setModified(isModified()); result.setNew(isNew()); return result; } /** * Creates an instance of TEscalationState with the contents * of a TEscalationStateBean. * This behaviour could have also been achieved using a constructor, * however as this class is abstract no constructors are allowed * @param bean the TEscalationStateBean which contents are used to create * the resulting class * @return an instance of TEscalationState with the contents of bean */ public static TEscalationState createTEscalationState(TEscalationStateBean bean) throws TorqueException { return createTEscalationState(bean, new IdentityMap()); } /** * Creates an instance of TEscalationState with the contents * of a TEscalationStateBean. * This behaviour could have also been achieved using a constructor, * however as this class is abstract no constructors are allowed. * * This method is intended for internal use only. * @param bean the TEscalationStateBean which contents are used to create * the resulting class * @param createdObjects a IdentityMap which maps beans * to already created objects * @return an instance of TEscalationState with the contents of bean */ public static TEscalationState createTEscalationState(TEscalationStateBean bean, IdentityMap createdObjects) throws TorqueException { TEscalationState result = (TEscalationState) createdObjects.get(bean); if (result != null) { // we already have an object for the bean, return it return result; } result = new TEscalationState(); createdObjects.put(bean, result); result.setObjectID(bean.getObjectID()); result.setEscalationentry(bean.getEscalationentry()); result.setStatus(bean.getStatus()); result.setUuid(bean.getUuid()); { TEscalationEntryBean relatedBean = bean.getTEscalationEntryBean(); if (relatedBean != null) { TEscalationEntry relatedObject = TEscalationEntry.createTEscalationEntry(relatedBean, createdObjects); result.setTEscalationEntry(relatedObject); } } { TStateBean relatedBean = bean.getTStateBean(); if (relatedBean != null) { TState relatedObject = TState.createTState(relatedBean, createdObjects); result.setTState(relatedObject); } } result.setModified(bean.isModified()); result.setNew(bean.isNew()); return result; } public String toString() { StringBuffer str = new StringBuffer(); str.append("TEscalationState:\n"); str.append("ObjectID = ").append(getObjectID()).append("\n"); str.append("Escalationentry = ").append(getEscalationentry()).append("\n"); str.append("Status = ").append(getStatus()).append("\n"); str.append("Uuid = ").append(getUuid()).append("\n"); return (str.toString()); } }