@@ -0,0 +1,3682 @@
+/*%0A$Id: PathToDocumentIdMapper.java,v 1.1 2003/09/30 09:04:57 egli Exp $%0A%3CLicense%3E%0A%0A ============================================================================%0A                   The Apache Software License, Version 1.1%0A ============================================================================%0A%0A Copyright (C) 1999-2003 The Apache Software Foundation. All rights reserved.%0A%0A Redistribution and use in source and binary forms, with or without modifica-%0A tion, are permitted provided that the following conditions are met:%0A%0A 1. Redistributions of  source code must  retain the above copyright  notice,%0A    this list of conditions and the following disclaimer.%0A%0A 2. Redistributions in binary form must reproduce the above copyright notice,%0A    this list of conditions and the following disclaimer in the documentation%0A    and/or other materials provided with the distribution.%0A%0A 3. The end-user documentation included with the redistribution, if any, must%0A    include  the following  acknowledgment:  %22This product includes  software%0A    developed  by the  Apache Software Foundation  (http://www.apache.org/).%22%0A    Alternately, this  acknowledgment may  appear in the software itself,  if%0A    and wherever such third-party acknowledgments normally appear.%0A%0A 4. The names %22Apache Lenya%22 and  %22Apache Software Foundation%22  must  not  be%0A    used to  endorse or promote  products derived from  this software without%0A    prior written permission. For written permission, please contact%0A    apache@apache.org.%0A%0A 5. Products  derived from this software may not  be called %22Apache%22, nor may%0A    %22Apache%22 appear  in their name,  without prior written permission  of the%0A    Apache Software Foundation.%0A%0A THIS SOFTWARE IS PROVIDED %60%60AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,%0A INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND%0A FITNESS  FOR A PARTICULAR  PURPOSE ARE  DISCLAIMED.  IN NO  EVENT SHALL  THE%0A APACHE SOFTWARE  FOUNDATION  OR ITS CONTRIBUTORS  BE LIABLE FOR  ANY DIRECT,%0A INDIRECT, INCIDENTAL, SPECIAL,  EXEMPLARY, OR CONSEQUENTIAL  DAMAGES (INCLU-%0A DING, BUT NOT LIMITED TO, PROCUREMENT  OF SUBSTITUTE GOODS OR SERVICES; LOSS%0A OF USE, DATA, OR  PROFITS; OR BUSINESS  INTERRUPTION)  HOWEVER CAUSED AND ON%0A ANY  THEORY OF LIABILITY,  WHETHER  IN CONTRACT,  STRICT LIABILITY,  OR TORT%0A (INCLUDING  NEGLIGENCE OR  OTHERWISE) ARISING IN  ANY WAY OUT OF THE  USE OF%0A THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.%0A%0A This software  consists of voluntary contributions made  by many individuals%0A on  behalf of the Apache Software  Foundation and was  originally created by%0A Michael Wechner %3Cmichi@apache.org%3E. For more information on the Apache Soft-%0A ware Foundation, please see %3Chttp://www.apache.org/%3E.%0A%0A Lenya includes software developed by the Apache Software Foundation, W3C,%0A DOM4J Project, BitfluxEditor, Xopus, and WebSHPINX.%0A%3C/License%3E%0A*/%0Apackage org.apache.lenya.cms.publication;%0A%0Aimport java.io.File;%0A%0A/**%0A * %0A * This interface is basically the reverse of DocumentIdToPathMapper.%0A * %0A * @author Christian Egli%0A *%0A */%0Apublic interface PathToDocumentIdMapper %7B%0A%0A    /**%0A     * Compute the document-id for a given file.%0A     *%0A     * @param publication the publication where the file is.%0A     * @param area the area where the file is.%0A     * @param file the file that is associated with the document%0A     * %0A     * @return the document-id of the document associated with the given file.%0A     * %0A     * @throws DocumentDoesNotExistException if there is no document associated with this file.%0A     */%0A    String getDocumentId(Publication publication, String area, File file)%0A        throws DocumentDoesNotExistException;%0A%7D%0A

Interface that offers a method to fetch the document-id for a given file (publication and area).