Source for org.jfree.repository.ContentLocation

   1: /**
   2:  * ===========================================================
   3:  * LibRepository : a free Java content repository access layer
   4:  * ===========================================================
   5:  *
   6:  * Project Info:  http://jfreereport.pentaho.org/librepository/
   7:  *
   8:  * (C) Copyright 2006, by Pentaho Corporation and Contributors.
   9:  *
  10:  * This library is free software; you can redistribute it and/or modify it under the terms
  11:  * of the GNU Lesser General Public License as published by the Free Software Foundation;
  12:  * either version 2.1 of the License, or (at your option) any later version.
  13:  *
  14:  * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
  15:  * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  16:  * See the GNU Lesser General Public License for more details.
  17:  *
  18:  * You should have received a copy of the GNU Lesser General Public License along with this
  19:  * library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  20:  * Boston, MA 02111-1307, USA.
  21:  *
  22:  * [Java is a trademark or registered trademark of Sun Microsystems, Inc.
  23:  * in the United States and other countries.]
  24:  *
  25:  * ------------
  26:  * ContentLocation.java
  27:  * ------------
  28:  * (C) Copyright 2006, by Pentaho Corporation.
  29:  */
  30: 
  31: package org.jfree.repository;
  32: 
  33: /**
  34:  * This represents a container in the repository. If the repository is a
  35:  * filesystem, this will be a directory.
  36:  *
  37:  * @author Thomas Morgner
  38:  */
  39: public interface ContentLocation extends ContentEntity
  40: {
  41:   public ContentEntity[] listContents() throws ContentIOException;
  42: 
  43:   public ContentEntity getEntry (String name) throws ContentIOException;
  44: 
  45:   /**
  46:    * Creates a new data item in the current location. This method must never
  47:    * return null.
  48:    *
  49:    * @param name
  50:    * @return
  51:    * @throws ContentCreationException if the item could not be created.
  52:    */
  53:   public ContentItem createItem (String name) throws ContentCreationException;
  54:   public ContentLocation createLocation (String name) throws ContentCreationException;
  55: 
  56:   public boolean exists(final String name);
  57: }