From commits-return-4656-apmail-jackrabbit-commits-archive=jackrabbit.apache.org@jackrabbit.apache.org Tue Oct 02 13:41:23 2007 Return-Path: Delivered-To: apmail-jackrabbit-commits-archive@www.apache.org Received: (qmail 83413 invoked from network); 2 Oct 2007 13:41:22 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 2 Oct 2007 13:41:22 -0000 Received: (qmail 12191 invoked by uid 500); 2 Oct 2007 13:41:11 -0000 Delivered-To: apmail-jackrabbit-commits-archive@jackrabbit.apache.org Received: (qmail 12108 invoked by uid 500); 2 Oct 2007 13:41:11 -0000 Mailing-List: contact commits-help@jackrabbit.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@jackrabbit.apache.org Delivered-To: mailing list commits@jackrabbit.apache.org Received: (qmail 12099 invoked by uid 99); 2 Oct 2007 13:41:11 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 02 Oct 2007 06:41:11 -0700 X-ASF-Spam-Status: No, hits=-100.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 02 Oct 2007 13:41:21 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 5F49F1A9838; Tue, 2 Oct 2007 06:40:31 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r581235 - /jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/IdFactory.java Date: Tue, 02 Oct 2007 13:40:31 -0000 To: commits@jackrabbit.apache.org From: angela@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20071002134031.5F49F1A9838@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: angela Date: Tue Oct 2 06:40:30 2007 New Revision: 581235 URL: http://svn.apache.org/viewvc?rev=581235&view=rev Log: javadoc: mention the intended usage of the idfactory and the fact that the client might not be aware of the uniqueID of an item. Modified: jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/IdFactory.java Modified: jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/IdFactory.java URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/IdFactory.java?rev=581235&r1=581234&r2=581235&view=diff ============================================================================== --- jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/IdFactory.java (original) +++ jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/IdFactory.java Tue Oct 2 06:40:30 2007 @@ -21,6 +21,13 @@ /** * IdFactory defines methods to construct new ItemIds. + * This factory is intended to build ItemIds from the parameters + * passed to the various create methods and should not make an attempt to + * apply additional logic such as e.g. roundtrips to the server or resolution of + * Paths. Similarly the SPI implementation namely the + * {@link RepositoryService} must be able to deal with the various formats of + * an ItemId, since a caller may not (yet) be aware of the uniqueID + * part of an ItemId. */ public interface IdFactory {