java/src/main/com/google/appengine/api/taskqueue/QueueFactory.java

   1 // Copyright 2010 Google Inc. All rights reserved.
   2 package com.google.appengine.api.taskqueue;
   3
   4 import com.google.appengine.spi.ServiceFactoryFactory;
   5
   6 /**
   7  * Creates {@link Queue} objects.
   8  * {@link QueueFactory} is thread safe.
   9  *
  10  */
  11 public final class QueueFactory {
  12
  13   /**
  14    * Returns the default {@code QueueService}.
  15    */
  16   public static Queue getDefaultQueue() {
  17     return getQueue(Queue.DEFAULT_QUEUE);
  18   }
  19
  20   /**
  21    * Returns the {@link Queue} by name.
  22    * <p>The returned {@link Queue} object may not necessarily refer
  23    * to an existing queue.  Queues must be configured before
  24    * they may be used.  Attempting to use a non-existing queue name
  25    * may result in errors at the point of use of the {@link Queue} object
  26    * and not when calling {@link #getQueue(String)}.
  27    */
  28   public static Queue getQueue(String queueName) {
  29     return getFactory().getQueue(queueName);
  30   }
  31
  32   private QueueFactory() {
  33   }
  34
  35   private static IQueueFactory getFactory() {
  36     return ServiceFactoryFactory.getFactory(IQueueFactory.class);
  37   }
  38 }