+ if (empty($ids)) {
+ throw new NoResultException();
+ }
+
+ // random select one in the list
+ $randomId = $ids[mt_rand(0, \count($ids) - 1)]['id'];
+
+ return $this->find($randomId);
+ }
+
+ /**
+ * Inject a UrlHasher.
+ *
+ * @param UrlHasher $hasher
+ */
+ public function setUrlHasher(UrlHasher $hasher)
+ {
+ $this->urlHasher = $hasher;
+ }
+
+ /**
+ * Get the UrlHasher, or create a default one if not injected.
+ *
+ * XXX: the default uses the default hash algorithm
+ *
+ * @return UrlHasher
+ */
+ protected function getUrlHasher()
+ {
+ if (!isset($this->urlHasher)) {
+ $this->setUrlHasher(new UrlHasher());
+ }
+
+ return $this->urlHasher;
+ }
+
+ /**
+ * Return a query builder to be used by other getBuilderFor* method.
+ *
+ * @param int $userId
+ *
+ * @return QueryBuilder
+ */
+ private function getQueryBuilderByUser($userId)
+ {
+ return $this->createQueryBuilder('e')
+ ->andWhere('e.user = :userId')->setParameter('userId', $userId);
+ }
+
+ /**
+ * Return a sorted query builder to be used by other getBuilderFor* method.
+ *
+ * @param int $userId
+ * @param string $sortBy
+ * @param string $direction
+ *
+ * @return QueryBuilder
+ */
+ private function getSortedQueryBuilderByUser($userId, $sortBy = 'createdAt', $direction = 'desc')
+ {
+ return $this->sortQueryBuilder($this->getQueryBuilderByUser($userId), $sortBy, $direction);
+ }
+
+ /**
+ * Return the given QueryBuilder with an orderBy() call.
+ *
+ * @param QueryBuilder $qb
+ * @param string $sortBy
+ * @param string $direction
+ *
+ * @return QueryBuilder
+ */
+ private function sortQueryBuilder(QueryBuilder $qb, $sortBy = 'createdAt', $direction = 'desc')
+ {
+ return $qb->orderBy(sprintf('e.%s', $sortBy), $direction);