1: <?php
2:
3: namespace Thelia\Model\om;
4:
5: use \BasePeer;
6: use \Criteria;
7: use \PDO;
8: use \PDOStatement;
9: use \Propel;
10: use \PropelException;
11: use \PropelPDO;
12: use Thelia\Model\Lang;
13: use Thelia\Model\LangPeer;
14: use Thelia\Model\map\LangTableMap;
15:
16: /**
17: * Base static class for performing query and update operations on the 'lang' table.
18: *
19: *
20: *
21: * @package propel.generator.Thelia.Model.om
22: */
23: abstract class BaseLangPeer
24: {
25:
26: /** the default database name for this class */
27: const DATABASE_NAME = 'thelia';
28:
29: /** the table name for this class */
30: const TABLE_NAME = 'lang';
31:
32: /** the related Propel class for this table */
33: const OM_CLASS = 'Thelia\\Model\\Lang';
34:
35: /** the related TableMap class for this table */
36: const TM_CLASS = 'LangTableMap';
37:
38: /** The total number of columns. */
39: const NUM_COLUMNS = 8;
40:
41: /** The number of lazy-loaded columns. */
42: const NUM_LAZY_LOAD_COLUMNS = 0;
43:
44: /** The number of columns to hydrate (NUM_COLUMNS - NUM_LAZY_LOAD_COLUMNS) */
45: const NUM_HYDRATE_COLUMNS = 8;
46:
47: /** the column name for the ID field */
48: const ID = 'lang.ID';
49:
50: /** the column name for the TITLE field */
51: const TITLE = 'lang.TITLE';
52:
53: /** the column name for the CODE field */
54: const CODE = 'lang.CODE';
55:
56: /** the column name for the LOCALE field */
57: const LOCALE = 'lang.LOCALE';
58:
59: /** the column name for the URL field */
60: const URL = 'lang.URL';
61:
62: /** the column name for the BY_DEFAULT field */
63: const BY_DEFAULT = 'lang.BY_DEFAULT';
64:
65: /** the column name for the CREATED_AT field */
66: const CREATED_AT = 'lang.CREATED_AT';
67:
68: /** the column name for the UPDATED_AT field */
69: const UPDATED_AT = 'lang.UPDATED_AT';
70:
71: /** The default string format for model objects of the related table **/
72: const DEFAULT_STRING_FORMAT = 'YAML';
73:
74: /**
75: * An identiy map to hold any loaded instances of Lang objects.
76: * This must be public so that other peer classes can access this when hydrating from JOIN
77: * queries.
78: * @var array Lang[]
79: */
80: public static $instances = array();
81:
82:
83: /**
84: * holds an array of fieldnames
85: *
86: * first dimension keys are the type constants
87: * e.g. LangPeer::$fieldNames[LangPeer::TYPE_PHPNAME][0] = 'Id'
88: */
89: protected static $fieldNames = array (
90: BasePeer::TYPE_PHPNAME => array ('Id', 'Title', 'Code', 'Locale', 'Url', 'ByDefault', 'CreatedAt', 'UpdatedAt', ),
91: BasePeer::TYPE_STUDLYPHPNAME => array ('id', 'title', 'code', 'locale', 'url', 'byDefault', 'createdAt', 'updatedAt', ),
92: BasePeer::TYPE_COLNAME => array (LangPeer::ID, LangPeer::TITLE, LangPeer::CODE, LangPeer::LOCALE, LangPeer::URL, LangPeer::BY_DEFAULT, LangPeer::CREATED_AT, LangPeer::UPDATED_AT, ),
93: BasePeer::TYPE_RAW_COLNAME => array ('ID', 'TITLE', 'CODE', 'LOCALE', 'URL', 'BY_DEFAULT', 'CREATED_AT', 'UPDATED_AT', ),
94: BasePeer::TYPE_FIELDNAME => array ('id', 'title', 'code', 'locale', 'url', 'by_default', 'created_at', 'updated_at', ),
95: BasePeer::TYPE_NUM => array (0, 1, 2, 3, 4, 5, 6, 7, )
96: );
97:
98: /**
99: * holds an array of keys for quick access to the fieldnames array
100: *
101: * first dimension keys are the type constants
102: * e.g. LangPeer::$fieldNames[BasePeer::TYPE_PHPNAME]['Id'] = 0
103: */
104: protected static $fieldKeys = array (
105: BasePeer::TYPE_PHPNAME => array ('Id' => 0, 'Title' => 1, 'Code' => 2, 'Locale' => 3, 'Url' => 4, 'ByDefault' => 5, 'CreatedAt' => 6, 'UpdatedAt' => 7, ),
106: BasePeer::TYPE_STUDLYPHPNAME => array ('id' => 0, 'title' => 1, 'code' => 2, 'locale' => 3, 'url' => 4, 'byDefault' => 5, 'createdAt' => 6, 'updatedAt' => 7, ),
107: BasePeer::TYPE_COLNAME => array (LangPeer::ID => 0, LangPeer::TITLE => 1, LangPeer::CODE => 2, LangPeer::LOCALE => 3, LangPeer::URL => 4, LangPeer::BY_DEFAULT => 5, LangPeer::CREATED_AT => 6, LangPeer::UPDATED_AT => 7, ),
108: BasePeer::TYPE_RAW_COLNAME => array ('ID' => 0, 'TITLE' => 1, 'CODE' => 2, 'LOCALE' => 3, 'URL' => 4, 'BY_DEFAULT' => 5, 'CREATED_AT' => 6, 'UPDATED_AT' => 7, ),
109: BasePeer::TYPE_FIELDNAME => array ('id' => 0, 'title' => 1, 'code' => 2, 'locale' => 3, 'url' => 4, 'by_default' => 5, 'created_at' => 6, 'updated_at' => 7, ),
110: BasePeer::TYPE_NUM => array (0, 1, 2, 3, 4, 5, 6, 7, )
111: );
112:
113: /**
114: * Translates a fieldname to another type
115: *
116: * @param string $name field name
117: * @param string $fromType One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME
118: * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM
119: * @param string $toType One of the class type constants
120: * @return string translated name of the field.
121: * @throws PropelException - if the specified name could not be found in the fieldname mappings.
122: */
123: public static function translateFieldName($name, $fromType, $toType)
124: {
125: $toNames = LangPeer::getFieldNames($toType);
126: $key = isset(LangPeer::$fieldKeys[$fromType][$name]) ? LangPeer::$fieldKeys[$fromType][$name] : null;
127: if ($key === null) {
128: throw new PropelException("'$name' could not be found in the field names of type '$fromType'. These are: " . print_r(LangPeer::$fieldKeys[$fromType], true));
129: }
130:
131: return $toNames[$key];
132: }
133:
134: /**
135: * Returns an array of field names.
136: *
137: * @param string $type The type of fieldnames to return:
138: * One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME
139: * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM
140: * @return array A list of field names
141: * @throws PropelException - if the type is not valid.
142: */
143: public static function getFieldNames($type = BasePeer::TYPE_PHPNAME)
144: {
145: if (!array_key_exists($type, LangPeer::$fieldNames)) {
146: throw new PropelException('Method getFieldNames() expects the parameter $type to be one of the class constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME, BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. ' . $type . ' was given.');
147: }
148:
149: return LangPeer::$fieldNames[$type];
150: }
151:
152: /**
153: * Convenience method which changes table.column to alias.column.
154: *
155: * Using this method you can maintain SQL abstraction while using column aliases.
156: * <code>
157: * $c->addAlias("alias1", TablePeer::TABLE_NAME);
158: * $c->addJoin(TablePeer::alias("alias1", TablePeer::PRIMARY_KEY_COLUMN), TablePeer::PRIMARY_KEY_COLUMN);
159: * </code>
160: * @param string $alias The alias for the current table.
161: * @param string $column The column name for current table. (i.e. LangPeer::COLUMN_NAME).
162: * @return string
163: */
164: public static function alias($alias, $column)
165: {
166: return str_replace(LangPeer::TABLE_NAME.'.', $alias.'.', $column);
167: }
168:
169: /**
170: * Add all the columns needed to create a new object.
171: *
172: * Note: any columns that were marked with lazyLoad="true" in the
173: * XML schema will not be added to the select list and only loaded
174: * on demand.
175: *
176: * @param Criteria $criteria object containing the columns to add.
177: * @param string $alias optional table alias
178: * @throws PropelException Any exceptions caught during processing will be
179: * rethrown wrapped into a PropelException.
180: */
181: public static function addSelectColumns(Criteria $criteria, $alias = null)
182: {
183: if (null === $alias) {
184: $criteria->addSelectColumn(LangPeer::ID);
185: $criteria->addSelectColumn(LangPeer::TITLE);
186: $criteria->addSelectColumn(LangPeer::CODE);
187: $criteria->addSelectColumn(LangPeer::LOCALE);
188: $criteria->addSelectColumn(LangPeer::URL);
189: $criteria->addSelectColumn(LangPeer::BY_DEFAULT);
190: $criteria->addSelectColumn(LangPeer::CREATED_AT);
191: $criteria->addSelectColumn(LangPeer::UPDATED_AT);
192: } else {
193: $criteria->addSelectColumn($alias . '.ID');
194: $criteria->addSelectColumn($alias . '.TITLE');
195: $criteria->addSelectColumn($alias . '.CODE');
196: $criteria->addSelectColumn($alias . '.LOCALE');
197: $criteria->addSelectColumn($alias . '.URL');
198: $criteria->addSelectColumn($alias . '.BY_DEFAULT');
199: $criteria->addSelectColumn($alias . '.CREATED_AT');
200: $criteria->addSelectColumn($alias . '.UPDATED_AT');
201: }
202: }
203:
204: /**
205: * Returns the number of rows matching criteria.
206: *
207: * @param Criteria $criteria
208: * @param boolean $distinct Whether to select only distinct columns; deprecated: use Criteria->setDistinct() instead.
209: * @param PropelPDO $con
210: * @return int Number of matching rows.
211: */
212: public static function doCount(Criteria $criteria, $distinct = false, PropelPDO $con = null)
213: {
214: // we may modify criteria, so copy it first
215: $criteria = clone $criteria;
216:
217: // We need to set the primary table name, since in the case that there are no WHERE columns
218: // it will be impossible for the BasePeer::createSelectSql() method to determine which
219: // tables go into the FROM clause.
220: $criteria->setPrimaryTableName(LangPeer::TABLE_NAME);
221:
222: if ($distinct && !in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) {
223: $criteria->setDistinct();
224: }
225:
226: if (!$criteria->hasSelectClause()) {
227: LangPeer::addSelectColumns($criteria);
228: }
229:
230: $criteria->clearOrderByColumns(); // ORDER BY won't ever affect the count
231: $criteria->setDbName(LangPeer::DATABASE_NAME); // Set the correct dbName
232:
233: if ($con === null) {
234: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_READ);
235: }
236: // BasePeer returns a PDOStatement
237: $stmt = BasePeer::doCount($criteria, $con);
238:
239: if ($row = $stmt->fetch(PDO::FETCH_NUM)) {
240: $count = (int) $row[0];
241: } else {
242: $count = 0; // no rows returned; we infer that means 0 matches.
243: }
244: $stmt->closeCursor();
245:
246: return $count;
247: }
248: /**
249: * Selects one object from the DB.
250: *
251: * @param Criteria $criteria object used to create the SELECT statement.
252: * @param PropelPDO $con
253: * @return Lang
254: * @throws PropelException Any exceptions caught during processing will be
255: * rethrown wrapped into a PropelException.
256: */
257: public static function doSelectOne(Criteria $criteria, PropelPDO $con = null)
258: {
259: $critcopy = clone $criteria;
260: $critcopy->setLimit(1);
261: $objects = LangPeer::doSelect($critcopy, $con);
262: if ($objects) {
263: return $objects[0];
264: }
265:
266: return null;
267: }
268: /**
269: * Selects several row from the DB.
270: *
271: * @param Criteria $criteria The Criteria object used to build the SELECT statement.
272: * @param PropelPDO $con
273: * @return array Array of selected Objects
274: * @throws PropelException Any exceptions caught during processing will be
275: * rethrown wrapped into a PropelException.
276: */
277: public static function doSelect(Criteria $criteria, PropelPDO $con = null)
278: {
279: return LangPeer::populateObjects(LangPeer::doSelectStmt($criteria, $con));
280: }
281: /**
282: * Prepares the Criteria object and uses the parent doSelect() method to execute a PDOStatement.
283: *
284: * Use this method directly if you want to work with an executed statement durirectly (for example
285: * to perform your own object hydration).
286: *
287: * @param Criteria $criteria The Criteria object used to build the SELECT statement.
288: * @param PropelPDO $con The connection to use
289: * @throws PropelException Any exceptions caught during processing will be
290: * rethrown wrapped into a PropelException.
291: * @return PDOStatement The executed PDOStatement object.
292: * @see BasePeer::doSelect()
293: */
294: public static function doSelectStmt(Criteria $criteria, PropelPDO $con = null)
295: {
296: if ($con === null) {
297: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_READ);
298: }
299:
300: if (!$criteria->hasSelectClause()) {
301: $criteria = clone $criteria;
302: LangPeer::addSelectColumns($criteria);
303: }
304:
305: // Set the correct dbName
306: $criteria->setDbName(LangPeer::DATABASE_NAME);
307:
308: // BasePeer returns a PDOStatement
309: return BasePeer::doSelect($criteria, $con);
310: }
311: /**
312: * Adds an object to the instance pool.
313: *
314: * Propel keeps cached copies of objects in an instance pool when they are retrieved
315: * from the database. In some cases -- especially when you override doSelect*()
316: * methods in your stub classes -- you may need to explicitly add objects
317: * to the cache in order to ensure that the same objects are always returned by doSelect*()
318: * and retrieveByPK*() calls.
319: *
320: * @param Lang $obj A Lang object.
321: * @param string $key (optional) key to use for instance map (for performance boost if key was already calculated externally).
322: */
323: public static function addInstanceToPool($obj, $key = null)
324: {
325: if (Propel::isInstancePoolingEnabled()) {
326: if ($key === null) {
327: $key = (string) $obj->getId();
328: } // if key === null
329: LangPeer::$instances[$key] = $obj;
330: }
331: }
332:
333: /**
334: * Removes an object from the instance pool.
335: *
336: * Propel keeps cached copies of objects in an instance pool when they are retrieved
337: * from the database. In some cases -- especially when you override doDelete
338: * methods in your stub classes -- you may need to explicitly remove objects
339: * from the cache in order to prevent returning objects that no longer exist.
340: *
341: * @param mixed $value A Lang object or a primary key value.
342: *
343: * @return void
344: * @throws PropelException - if the value is invalid.
345: */
346: public static function removeInstanceFromPool($value)
347: {
348: if (Propel::isInstancePoolingEnabled() && $value !== null) {
349: if (is_object($value) && $value instanceof Lang) {
350: $key = (string) $value->getId();
351: } elseif (is_scalar($value)) {
352: // assume we've been passed a primary key
353: $key = (string) $value;
354: } else {
355: $e = new PropelException("Invalid value passed to removeInstanceFromPool(). Expected primary key or Lang object; got " . (is_object($value) ? get_class($value) . ' object.' : var_export($value,true)));
356: throw $e;
357: }
358:
359: unset(LangPeer::$instances[$key]);
360: }
361: } // removeInstanceFromPool()
362:
363: /**
364: * Retrieves a string version of the primary key from the DB resultset row that can be used to uniquely identify a row in this table.
365: *
366: * For tables with a single-column primary key, that simple pkey value will be returned. For tables with
367: * a multi-column primary key, a serialize()d version of the primary key will be returned.
368: *
369: * @param string $key The key (@see getPrimaryKeyHash()) for this instance.
370: * @return Lang Found object or null if 1) no instance exists for specified key or 2) instance pooling has been disabled.
371: * @see getPrimaryKeyHash()
372: */
373: public static function getInstanceFromPool($key)
374: {
375: if (Propel::isInstancePoolingEnabled()) {
376: if (isset(LangPeer::$instances[$key])) {
377: return LangPeer::$instances[$key];
378: }
379: }
380:
381: return null; // just to be explicit
382: }
383:
384: /**
385: * Clear the instance pool.
386: *
387: * @return void
388: */
389: public static function clearInstancePool()
390: {
391: LangPeer::$instances = array();
392: }
393:
394: /**
395: * Method to invalidate the instance pool of all tables related to lang
396: * by a foreign key with ON DELETE CASCADE
397: */
398: public static function clearRelatedInstancePool()
399: {
400: }
401:
402: /**
403: * Retrieves a string version of the primary key from the DB resultset row that can be used to uniquely identify a row in this table.
404: *
405: * For tables with a single-column primary key, that simple pkey value will be returned. For tables with
406: * a multi-column primary key, a serialize()d version of the primary key will be returned.
407: *
408: * @param array $row PropelPDO resultset row.
409: * @param int $startcol The 0-based offset for reading from the resultset row.
410: * @return string A string version of PK or null if the components of primary key in result array are all null.
411: */
412: public static function getPrimaryKeyHashFromRow($row, $startcol = 0)
413: {
414: // If the PK cannot be derived from the row, return null.
415: if ($row[$startcol] === null) {
416: return null;
417: }
418:
419: return (string) $row[$startcol];
420: }
421:
422: /**
423: * Retrieves the primary key from the DB resultset row
424: * For tables with a single-column primary key, that simple pkey value will be returned. For tables with
425: * a multi-column primary key, an array of the primary key columns will be returned.
426: *
427: * @param array $row PropelPDO resultset row.
428: * @param int $startcol The 0-based offset for reading from the resultset row.
429: * @return mixed The primary key of the row
430: */
431: public static function getPrimaryKeyFromRow($row, $startcol = 0)
432: {
433:
434: return (int) $row[$startcol];
435: }
436:
437: /**
438: * The returned array will contain objects of the default type or
439: * objects that inherit from the default.
440: *
441: * @throws PropelException Any exceptions caught during processing will be
442: * rethrown wrapped into a PropelException.
443: */
444: public static function populateObjects(PDOStatement $stmt)
445: {
446: $results = array();
447:
448: // set the class once to avoid overhead in the loop
449: $cls = LangPeer::getOMClass();
450: // populate the object(s)
451: while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
452: $key = LangPeer::getPrimaryKeyHashFromRow($row, 0);
453: if (null !== ($obj = LangPeer::getInstanceFromPool($key))) {
454: // We no longer rehydrate the object, since this can cause data loss.
455: // See http://www.propelorm.org/ticket/509
456: // $obj->hydrate($row, 0, true); // rehydrate
457: $results[] = $obj;
458: } else {
459: $obj = new $cls();
460: $obj->hydrate($row);
461: $results[] = $obj;
462: LangPeer::addInstanceToPool($obj, $key);
463: } // if key exists
464: }
465: $stmt->closeCursor();
466:
467: return $results;
468: }
469: /**
470: * Populates an object of the default type or an object that inherit from the default.
471: *
472: * @param array $row PropelPDO resultset row.
473: * @param int $startcol The 0-based offset for reading from the resultset row.
474: * @throws PropelException Any exceptions caught during processing will be
475: * rethrown wrapped into a PropelException.
476: * @return array (Lang object, last column rank)
477: */
478: public static function populateObject($row, $startcol = 0)
479: {
480: $key = LangPeer::getPrimaryKeyHashFromRow($row, $startcol);
481: if (null !== ($obj = LangPeer::getInstanceFromPool($key))) {
482: // We no longer rehydrate the object, since this can cause data loss.
483: // See http://www.propelorm.org/ticket/509
484: // $obj->hydrate($row, $startcol, true); // rehydrate
485: $col = $startcol + LangPeer::NUM_HYDRATE_COLUMNS;
486: } else {
487: $cls = LangPeer::OM_CLASS;
488: $obj = new $cls();
489: $col = $obj->hydrate($row, $startcol);
490: LangPeer::addInstanceToPool($obj, $key);
491: }
492:
493: return array($obj, $col);
494: }
495:
496: /**
497: * Returns the TableMap related to this peer.
498: * This method is not needed for general use but a specific application could have a need.
499: * @return TableMap
500: * @throws PropelException Any exceptions caught during processing will be
501: * rethrown wrapped into a PropelException.
502: */
503: public static function getTableMap()
504: {
505: return Propel::getDatabaseMap(LangPeer::DATABASE_NAME)->getTable(LangPeer::TABLE_NAME);
506: }
507:
508: /**
509: * Add a TableMap instance to the database for this peer class.
510: */
511: public static function buildTableMap()
512: {
513: $dbMap = Propel::getDatabaseMap(BaseLangPeer::DATABASE_NAME);
514: if (!$dbMap->hasTable(BaseLangPeer::TABLE_NAME)) {
515: $dbMap->addTableObject(new LangTableMap());
516: }
517: }
518:
519: /**
520: * The class that the Peer will make instances of.
521: *
522: *
523: * @return string ClassName
524: */
525: public static function getOMClass()
526: {
527: return LangPeer::OM_CLASS;
528: }
529:
530: /**
531: * Performs an INSERT on the database, given a Lang or Criteria object.
532: *
533: * @param mixed $values Criteria or Lang object containing data that is used to create the INSERT statement.
534: * @param PropelPDO $con the PropelPDO connection to use
535: * @return mixed The new primary key.
536: * @throws PropelException Any exceptions caught during processing will be
537: * rethrown wrapped into a PropelException.
538: */
539: public static function doInsert($values, PropelPDO $con = null)
540: {
541: if ($con === null) {
542: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
543: }
544:
545: if ($values instanceof Criteria) {
546: $criteria = clone $values; // rename for clarity
547: } else {
548: $criteria = $values->buildCriteria(); // build Criteria from Lang object
549: }
550:
551: if ($criteria->containsKey(LangPeer::ID) && $criteria->keyContainsValue(LangPeer::ID) ) {
552: throw new PropelException('Cannot insert a value for auto-increment primary key ('.LangPeer::ID.')');
553: }
554:
555:
556: // Set the correct dbName
557: $criteria->setDbName(LangPeer::DATABASE_NAME);
558:
559: try {
560: // use transaction because $criteria could contain info
561: // for more than one table (I guess, conceivably)
562: $con->beginTransaction();
563: $pk = BasePeer::doInsert($criteria, $con);
564: $con->commit();
565: } catch (PropelException $e) {
566: $con->rollBack();
567: throw $e;
568: }
569:
570: return $pk;
571: }
572:
573: /**
574: * Performs an UPDATE on the database, given a Lang or Criteria object.
575: *
576: * @param mixed $values Criteria or Lang object containing data that is used to create the UPDATE statement.
577: * @param PropelPDO $con The connection to use (specify PropelPDO connection object to exert more control over transactions).
578: * @return int The number of affected rows (if supported by underlying database driver).
579: * @throws PropelException Any exceptions caught during processing will be
580: * rethrown wrapped into a PropelException.
581: */
582: public static function doUpdate($values, PropelPDO $con = null)
583: {
584: if ($con === null) {
585: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
586: }
587:
588: $selectCriteria = new Criteria(LangPeer::DATABASE_NAME);
589:
590: if ($values instanceof Criteria) {
591: $criteria = clone $values; // rename for clarity
592:
593: $comparison = $criteria->getComparison(LangPeer::ID);
594: $value = $criteria->remove(LangPeer::ID);
595: if ($value) {
596: $selectCriteria->add(LangPeer::ID, $value, $comparison);
597: } else {
598: $selectCriteria->setPrimaryTableName(LangPeer::TABLE_NAME);
599: }
600:
601: } else { // $values is Lang object
602: $criteria = $values->buildCriteria(); // gets full criteria
603: $selectCriteria = $values->buildPkeyCriteria(); // gets criteria w/ primary key(s)
604: }
605:
606: // set the correct dbName
607: $criteria->setDbName(LangPeer::DATABASE_NAME);
608:
609: return BasePeer::doUpdate($selectCriteria, $criteria, $con);
610: }
611:
612: /**
613: * Deletes all rows from the lang table.
614: *
615: * @param PropelPDO $con the connection to use
616: * @return int The number of affected rows (if supported by underlying database driver).
617: * @throws PropelException
618: */
619: public static function doDeleteAll(PropelPDO $con = null)
620: {
621: if ($con === null) {
622: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
623: }
624: $affectedRows = 0; // initialize var to track total num of affected rows
625: try {
626: // use transaction because $criteria could contain info
627: // for more than one table or we could emulating ON DELETE CASCADE, etc.
628: $con->beginTransaction();
629: $affectedRows += BasePeer::doDeleteAll(LangPeer::TABLE_NAME, $con, LangPeer::DATABASE_NAME);
630: // Because this db requires some delete cascade/set null emulation, we have to
631: // clear the cached instance *after* the emulation has happened (since
632: // instances get re-added by the select statement contained therein).
633: LangPeer::clearInstancePool();
634: LangPeer::clearRelatedInstancePool();
635: $con->commit();
636:
637: return $affectedRows;
638: } catch (PropelException $e) {
639: $con->rollBack();
640: throw $e;
641: }
642: }
643:
644: /**
645: * Performs a DELETE on the database, given a Lang or Criteria object OR a primary key value.
646: *
647: * @param mixed $values Criteria or Lang object or primary key or array of primary keys
648: * which is used to create the DELETE statement
649: * @param PropelPDO $con the connection to use
650: * @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows
651: * if supported by native driver or if emulated using Propel.
652: * @throws PropelException Any exceptions caught during processing will be
653: * rethrown wrapped into a PropelException.
654: */
655: public static function doDelete($values, PropelPDO $con = null)
656: {
657: if ($con === null) {
658: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
659: }
660:
661: if ($values instanceof Criteria) {
662: // invalidate the cache for all objects of this type, since we have no
663: // way of knowing (without running a query) what objects should be invalidated
664: // from the cache based on this Criteria.
665: LangPeer::clearInstancePool();
666: // rename for clarity
667: $criteria = clone $values;
668: } elseif ($values instanceof Lang) { // it's a model object
669: // invalidate the cache for this single object
670: LangPeer::removeInstanceFromPool($values);
671: // create criteria based on pk values
672: $criteria = $values->buildPkeyCriteria();
673: } else { // it's a primary key, or an array of pks
674: $criteria = new Criteria(LangPeer::DATABASE_NAME);
675: $criteria->add(LangPeer::ID, (array) $values, Criteria::IN);
676: // invalidate the cache for this object(s)
677: foreach ((array) $values as $singleval) {
678: LangPeer::removeInstanceFromPool($singleval);
679: }
680: }
681:
682: // Set the correct dbName
683: $criteria->setDbName(LangPeer::DATABASE_NAME);
684:
685: $affectedRows = 0; // initialize var to track total num of affected rows
686:
687: try {
688: // use transaction because $criteria could contain info
689: // for more than one table or we could emulating ON DELETE CASCADE, etc.
690: $con->beginTransaction();
691:
692: $affectedRows += BasePeer::doDelete($criteria, $con);
693: LangPeer::clearRelatedInstancePool();
694: $con->commit();
695:
696: return $affectedRows;
697: } catch (PropelException $e) {
698: $con->rollBack();
699: throw $e;
700: }
701: }
702:
703: /**
704: * Validates all modified columns of given Lang object.
705: * If parameter $columns is either a single column name or an array of column names
706: * than only those columns are validated.
707: *
708: * NOTICE: This does not apply to primary or foreign keys for now.
709: *
710: * @param Lang $obj The object to validate.
711: * @param mixed $cols Column name or array of column names.
712: *
713: * @return mixed TRUE if all columns are valid or the error message of the first invalid column.
714: */
715: public static function doValidate($obj, $cols = null)
716: {
717: $columns = array();
718:
719: if ($cols) {
720: $dbMap = Propel::getDatabaseMap(LangPeer::DATABASE_NAME);
721: $tableMap = $dbMap->getTable(LangPeer::TABLE_NAME);
722:
723: if (! is_array($cols)) {
724: $cols = array($cols);
725: }
726:
727: foreach ($cols as $colName) {
728: if ($tableMap->hasColumn($colName)) {
729: $get = 'get' . $tableMap->getColumn($colName)->getPhpName();
730: $columns[$colName] = $obj->$get();
731: }
732: }
733: } else {
734:
735: }
736:
737: return BasePeer::doValidate(LangPeer::DATABASE_NAME, LangPeer::TABLE_NAME, $columns);
738: }
739:
740: /**
741: * Retrieve a single object by pkey.
742: *
743: * @param int $pk the primary key.
744: * @param PropelPDO $con the connection to use
745: * @return Lang
746: */
747: public static function retrieveByPK($pk, PropelPDO $con = null)
748: {
749:
750: if (null !== ($obj = LangPeer::getInstanceFromPool((string) $pk))) {
751: return $obj;
752: }
753:
754: if ($con === null) {
755: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_READ);
756: }
757:
758: $criteria = new Criteria(LangPeer::DATABASE_NAME);
759: $criteria->add(LangPeer::ID, $pk);
760:
761: $v = LangPeer::doSelect($criteria, $con);
762:
763: return !empty($v) > 0 ? $v[0] : null;
764: }
765:
766: /**
767: * Retrieve multiple objects by pkey.
768: *
769: * @param array $pks List of primary keys
770: * @param PropelPDO $con the connection to use
771: * @return Lang[]
772: * @throws PropelException Any exceptions caught during processing will be
773: * rethrown wrapped into a PropelException.
774: */
775: public static function retrieveByPKs($pks, PropelPDO $con = null)
776: {
777: if ($con === null) {
778: $con = Propel::getConnection(LangPeer::DATABASE_NAME, Propel::CONNECTION_READ);
779: }
780:
781: $objs = null;
782: if (empty($pks)) {
783: $objs = array();
784: } else {
785: $criteria = new Criteria(LangPeer::DATABASE_NAME);
786: $criteria->add(LangPeer::ID, $pks, Criteria::IN);
787: $objs = LangPeer::doSelect($criteria, $con);
788: }
789:
790: return $objs;
791: }
792:
793: } // BaseLangPeer
794:
795: // This is the static code needed to register the TableMap for this table with the main Propel class.
796: //
797: BaseLangPeer::buildTableMap();
798:
799: