org/sonews/storage/StorageProvider.java
author cli
Sun May 09 12:38:46 2010 +0200 (2010-05-09)
changeset 30 146b3275b792
parent 3 2fdc9cc89502
permissions -rw-r--r--
The StorageBackendException is catched two times so that the user see the "500 internal server error" only at the second catch (probably fixes #5).
chris@3
     1
/*
chris@3
     2
 *   SONEWS News Server
chris@3
     3
 *   see AUTHORS for the list of contributors
chris@3
     4
 *
chris@3
     5
 *   This program is free software: you can redistribute it and/or modify
chris@3
     6
 *   it under the terms of the GNU General Public License as published by
chris@3
     7
 *   the Free Software Foundation, either version 3 of the License, or
chris@3
     8
 *   (at your option) any later version.
chris@3
     9
 *
chris@3
    10
 *   This program is distributed in the hope that it will be useful,
chris@3
    11
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
chris@3
    12
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
chris@3
    13
 *   GNU General Public License for more details.
chris@3
    14
 *
chris@3
    15
 *   You should have received a copy of the GNU General Public License
chris@3
    16
 *   along with this program.  If not, see <http://www.gnu.org/licenses/>.
chris@3
    17
 */
chris@3
    18
chris@3
    19
package org.sonews.storage;
chris@3
    20
chris@3
    21
/**
cli@20
    22
 * Provides access to storage backend instances.
chris@3
    23
 * @author Christian Lins
chris@3
    24
 * @since sonews/1.0
chris@3
    25
 */
chris@3
    26
public interface StorageProvider
chris@3
    27
{
chris@3
    28
chris@3
    29
  public boolean isSupported(String uri);
chris@3
    30
chris@3
    31
  /**
chris@3
    32
   * This method returns the reference to the associated storage.
chris@3
    33
   * The reference MAY be unique for each thread. In any case it MUST be
chris@3
    34
   * thread-safe to use this method.
chris@3
    35
   * @return The reference to the associated Storage.
chris@3
    36
   */
chris@3
    37
  public Storage storage(Thread thread)
chris@3
    38
    throws StorageBackendException;
chris@3
    39
chris@3
    40
}