001    /**
002     * ===========================================================
003     * LibRepository : a free Java content repository access layer
004     * ===========================================================
005     *
006     * Project Info:  http://jfreereport.pentaho.org/librepository/
007     *
008     * (C) Copyright 2006, by Pentaho Corporation and Contributors.
009     *
010     * This library is free software; you can redistribute it and/or modify it under the terms
011     * of the GNU Lesser General Public License as published by the Free Software Foundation;
012     * either version 2.1 of the License, or (at your option) any later version.
013     *
014     * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
015     * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
016     * See the GNU Lesser General Public License for more details.
017     *
018     * You should have received a copy of the GNU Lesser General Public License along with this
019     * library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
020     * Boston, MA 02111-1307, USA.
021     *
022     * [Java is a trademark or registered trademark of Sun Microsystems, Inc.
023     * in the United States and other countries.]
024     *
025     * ------------
026     * ContentLocation.java
027     * ------------
028     * (C) Copyright 2006, by Pentaho Corporation.
029     */
030    
031    package org.jfree.repository;
032    
033    /**
034     * This represents a container in the repository. If the repository is a
035     * filesystem, this will be a directory.
036     *
037     * @author Thomas Morgner
038     */
039    public interface ContentLocation extends ContentEntity
040    {
041      public ContentEntity[] listContents() throws ContentIOException;
042    
043      public ContentEntity getEntry (String name) throws ContentIOException;
044    
045      /**
046       * Creates a new data item in the current location. This method must never
047       * return null.
048       *
049       * @param name
050       * @return
051       * @throws ContentCreationException if the item could not be created.
052       */
053      public ContentItem createItem (String name) throws ContentCreationException;
054      public ContentLocation createLocation (String name) throws ContentCreationException;
055    
056      public boolean exists(final String name);
057    }