Return-Path: Delivered-To: apmail-jackrabbit-commits-archive@www.apache.org Received: (qmail 8814 invoked from network); 26 Oct 2007 09:17:31 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 26 Oct 2007 09:17:31 -0000 Received: (qmail 93115 invoked by uid 500); 26 Oct 2007 09:17:19 -0000 Delivered-To: apmail-jackrabbit-commits-archive@jackrabbit.apache.org Received: (qmail 93084 invoked by uid 500); 26 Oct 2007 09:17:19 -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 93075 invoked by uid 99); 26 Oct 2007 09:17:19 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 26 Oct 2007 02:17:19 -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; Fri, 26 Oct 2007 09:17:19 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id B0ABF1A9832; Fri, 26 Oct 2007 02:16:58 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r588575 - in /jackrabbit/trunk/jackrabbit-site/src/site: ./ apt/doc/components/ resources/images/arch/ Date: Fri, 26 Oct 2007 09:16:57 -0000 To: commits@jackrabbit.apache.org From: angela@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20071026091658.B0ABF1A9832@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: angela Date: Fri Oct 26 02:16:56 2007 New Revision: 588575 URL: http://svn.apache.org/viewvc?rev=588575&view=rev Log: - replace references to contrib by sandbox - minimal info for promoted spi projects Added: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr2spi.apt jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi-commons.apt jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi.apt jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi2jcr.apt jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-invalidation.pdf (with props) jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-observation.pdf (with props) jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi-overview.gif (with props) jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi.jpg (with props) Modified: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/index.apt jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr-server.apt jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webapp.apt jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webdav.apt jackrabbit/trunk/jackrabbit-site/src/site/site.xml Modified: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/index.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/index.apt?rev=588575&r1=588574&r2=588575&view=diff ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/index.apt (original) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/index.apt Fri Oct 26 02:16:56 2007 @@ -42,7 +42,15 @@ * {{{jca.html}Jackrabbit JCA Resource Adapter}} + * {{{spi.html}Jackrabbit SPI}} + + * {{{spi-commons.html}Jackrabbit SPI Commons}} + + * {{{jcr2spi.html}Jackrabbit JCR to SPI}} + + * {{{spi2jcr.html}Jackrabbit SPI to JCR}} + In addition there are a number of contributed components in the - <<>> folder of the Jackrabbit trunk. These components are + folder of the Jackrabbit project. These components are not yet considered stable enough to be included in the official Apache Jackrabbit releases. Modified: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr-server.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr-server.apt?rev=588575&r1=588574&r2=588575&view=diff ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr-server.apt (original) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr-server.apt Fri Oct 26 02:16:56 2007 @@ -22,50 +22,60 @@ This is the JCR Server component of the Apache Jackrabbit project. This component contains two WebDAV based JCR server implementations: - [[1]] WebDAV server ('simple') + * Simple Webdav Server - DAV1,2 compliant WebDAV server implementation to access a - JSR170 repository. + * JCR Webdav Server + +* Simple Webdav Server + + DAV1,2 and DeltaV compliant WebDAV server implementation to + access a JSR170 repository. Futher information such as configuration as well as the - SimpleWebdavServlet itself may be found in the 'webapp' project. - - Packages: - - * org.apache.jackrabbit.server - server + itself can be found in the + {{{webapp.html} Jackrabbit Webapp}} project. - * org.apache.jackrabbit.server.io - import/export + * Packages: - * org.apache.jackrabbit.webdav.simple - - dav-resource implementation + config +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.server | Common server functionality | +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.server.io | Import and export facilities | +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.webdav.simple | Server side WebDAV implementation (DavResource, ResourceConfig,...). | +*----------+------------------------------------------------------------+ - Servlet (webapp project): + * Servlet: - * org.apache.jackrabbit.j2ee.SimpleWebdavServlet.java - +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.j2ee.SimpleWebdavServlet.java | see {{{webapp.html} Jackrabbit Webapp}} | +*----------+------------------------------------------------------------+ - [[2]] 'jcr' server: +* JCR Webdav Server - Server used to remove JSR170 calls via WebDAV. - No particular effort to be compliant to WebDAV related RFCs. - - The 'client' counterpart of this server is under development and - can be found within the /contrib/spi contribution. + Server used to remote JSR170 calls via WebDAV. - Packages: - - * org.apache.jackrabbit.server - server - - * org.apache.jackrabbit.server.jcr - - jcr-server specific server part - - * org.apache.jackrabbit.webdav.jcr - - dav-resources, reports, properties + The client counterpart of this server is represented by the + {{{jcr2spi.html} JCR to SPI}} project in combination with + the SPI implementation that can be found in the + {{{https://svn.apache.org/repos/asf/jackrabbit/sandbox/spi/spi2dav} Jackrabbit sandbox}}. - Servlet (webapp project): - - * org.apache.jackrabbit.j2ee.JCRServerServlet.java - + * Packages: + +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.server | Common server functionality | +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.server.jcr | JCR-Server | +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.webdav.jcr | Server side WebDAV implementation (DavResources, Reports, Properties) | +*----------+------------------------------------------------------------+ + + * Servlet: + +*----------+------------------------------------------------------------+ +| org.apache.jackrabbit.j2ee.JCRServerServlet.java | see {{{webapp.html} Jackrabbit Webapp}} | +*----------+------------------------------------------------------------+ + Further reading: * {{http://jackrabbit.apache.org/JCR_Webdav_Protocol.doc}} Added: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr2spi.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr2spi.apt?rev=588575&view=auto ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr2spi.apt (added) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/jcr2spi.apt Fri Oct 26 02:16:56 2007 @@ -0,0 +1,41 @@ + --------------------- + Jackrabbit JCR to SPI + --------------------- + +~~ Licensed to the Apache Software Foundation (ASF) under one or more +~~ contributor license agreements. See the NOTICE file distributed with +~~ this work for additional information regarding copyright ownership. +~~ The ASF licenses this file to You under the Apache License, Version 2.0 +~~ (the "License"); you may not use this file except in compliance with +~~ the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, software +~~ distributed under the License is distributed on an "AS IS" BASIS, +~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +~~ See the License for the specific language governing permissions and +~~ limitations under the License. + +Jackrabbit JCR to SPI + + This is the JCR to SPI component of the Apache Jackrabbit project. + It provides and exposes the JCR API to the application and is a + consumer of an implementation of the {{{spi.html} SPI interfaces}}. + + Jackrabbit JCR to SPI is intended to act as a generic implementation + of the transient component that is layered on top of the persistent + state of the JCR repository. The latter is is represented by the + SPI implementation. + + This means that JCR to SPI handles + + * transient storage of pending changes. + + * resolution of namespaces to prefixes. + + * Session-local namespace mappings. + + * Session-mediated XML import. + + * XML export. Added: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi-commons.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi-commons.apt?rev=588575&view=auto ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi-commons.apt (added) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi-commons.apt Fri Oct 26 02:16:56 2007 @@ -0,0 +1,31 @@ + ---------------------- + Jackrabbit SPI Commons + ---------------------- + +~~ Licensed to the Apache Software Foundation (ASF) under one or more +~~ contributor license agreements. See the NOTICE file distributed with +~~ this work for additional information regarding copyright ownership. +~~ The ASF licenses this file to You under the Apache License, Version 2.0 +~~ (the "License"); you may not use this file except in compliance with +~~ the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, software +~~ distributed under the License is distributed on an "AS IS" BASIS, +~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +~~ See the License for the specific language governing permissions and +~~ limitations under the License. + +Jackrabbit SPI Commons + + This is the SPI Commons component of the Apache Jackrabbit project. + This component contains a number of general-purpose classes for + use with SPI implementations: This also includes default implementations + for the various *Info interfaces and for those interfaces that + define the internal representation of JCR names, paths and Item + identifiers. + + In addition this component provides utilities used to convert + JCR name and path Strings as well as values to their corresponding + SPI representation. Added: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi.apt?rev=588575&view=auto ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi.apt (added) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi.apt Fri Oct 26 02:16:56 2007 @@ -0,0 +1,112 @@ + -------------- + Jackrabbit SPI + -------------- + +~~ Licensed to the Apache Software Foundation (ASF) under one or more +~~ contributor license agreements. See the NOTICE file distributed with +~~ this work for additional information regarding copyright ownership. +~~ The ASF licenses this file to You under the Apache License, Version 2.0 +~~ (the "License"); you may not use this file except in compliance with +~~ the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, software +~~ distributed under the License is distributed on an "AS IS" BASIS, +~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +~~ See the License for the specific language governing permissions and +~~ limitations under the License. + +Jackrabbit Service Provider Interface (SPI) + + This is the SPI component of the Apache Jackrabbit project. + The SPI enables a separation between transient and persistent components + of the JCR repository. The transient component ("repository client") is + implemented on top of the persistent component ("repository server") as a + consumer of the SPI and, in turn, exposes the JCR API to the application. + The SPI is not intended to be used by the application directly. + +[../../images/arch/jackrabbit-spi.jpg] + +* Primary Goals + + The Primary goals of the SPI approach are to define support for client-server + architecture and to ease the implementation of the JCR API. + + <> + + The SPI provides a natural division between the client and server + components of a remote JCR repository. The SPI is designed with this + usage in mind, enabling an implementation to minimize network traffic. + The SPI lends itself to protocol mappings to protocols + like WebDAV, SOAP or others in a straightforward yet meaningful way. + + <> + + Introducing the SPI can simplify the implementation of JCR on top of + an existing repository by reducing the task to one of implementing the + SPI. Such an implementation might then rely on a generic transient + layer (such as e.g. {{{jcr2spi.html}Jackrabbit JCR to SPI}}) to provide + the JCR API. + +* Architectur and Design Overview + + The specific functions exposed by the SPI are: + + * Reading from and writing to the persistent storage. + + * Authentication + + * Access control + + * Locking + + * Query + + * Versioning + + * Direct to workspace XML import + + * Storage of the central namespace registry + + * Node type management, enforcement of constraints as well as definition storage. + + Therefore SPI designs a set of interfaces and methods needed to expose + the functionality of the persistent layer of a compliant JCR repository. + The main interfaces of the SPI are and . + + The interface defines the methods used to retrieve + information from the persistent layer. In addition it contains the methods + that affect the persistent state of the repository. + + The is an interface to an ordered list of primitive operations + against the persistent layer. The is then submitted to the + to make the specified sequence of changes. + + In addition the SPI defines interfaces for internal representations + of JCR name, JCR nath and Item identifiers. The SPI itself only uses + names and paths in their fully qualified. + +* Existing Implementations + + The Jackrabbit project currently provides a single SPI implementation: + + * {{{spi2jcr.html}Jackrabbit SPI to JCR}}: An implementation of + the {{{spi.html}SPI}} interfaces wrapping an implementation of + the JCR API such as e.g. {{{core.html}Jackrabbit Core}}. + + Other SPI implementations can be found in the folder of the + Jackrabbit project. + + * <>: SPI implementation on top of WebDAV connecting + to a {{{jcr-server.html}Jackrabbit JCR Server}}. + + * <>: A RMI layer.used to remote any SPI implementation. + While {{{spi2jcr.html} SPI to JCR}} and really + are repository implementations, the is rather a 'repeater' + for SPI calls using RMI. + + * <>: Utility implementation to log SPI usage. + + See {{{../../images/arch/jackrabbit-spi-overview.gif} here}} + for a overview over existing and planned SPI implementations. Added: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi2jcr.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi2jcr.apt?rev=588575&view=auto ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi2jcr.apt (added) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/spi2jcr.apt Fri Oct 26 02:16:56 2007 @@ -0,0 +1,24 @@ + --------------------- + Jackrabbit SPI to JCR + --------------------- + +~~ Licensed to the Apache Software Foundation (ASF) under one or more +~~ contributor license agreements. See the NOTICE file distributed with +~~ this work for additional information regarding copyright ownership. +~~ The ASF licenses this file to You under the Apache License, Version 2.0 +~~ (the "License"); you may not use this file except in compliance with +~~ the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, software +~~ distributed under the License is distributed on an "AS IS" BASIS, +~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +~~ See the License for the specific language governing permissions and +~~ limitations under the License. + +Jackrabbit SPI to JCR + + This is the SPI to JCR component of the Apache Jackrabbit project. + This component contains an implementation of the {{{spi.html}SPI interfaces}} + wrapping around an implementation of JCR API. Modified: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webapp.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webapp.apt?rev=588575&r1=588574&r2=588575&view=diff ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webapp.apt (original) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webapp.apt Fri Oct 26 02:16:56 2007 @@ -32,14 +32,26 @@ * SimpleWebdavServlet.java - Adds webdav support (DAV 1,2) to your jackrabbit repository. - * JCRWebdavServerServlet.java - A servlet used to remove JSR170 calls via webDAV. +* Simple Webdav Server + + Adds WebDAV support (DAV 1,2 and DeltaV) to your jackrabbit repository. + + The servlet configuration goes along with a + {{{https://svn.apache.org/repos/asf/jackrabbit/trunk/jackrabbit-webapp/src/main/webapp/WEB-INF/config.xml}config.xml}} + that provides additional configuration options for the WebDAV resources + including import and export behaviour for both resources and their properties, + mime type and nodetype mappings and simple item filters. + +* JCR Webdav Server + + A servlet used to remote JSR170 calls via webDAV. IMPORTANT: Please note, that this servlet is not intended to provide - common webdav support to the repository. Instead the primary goal is to + common WebDAV support to the repository. Instead the primary goal is to remote JSR170 calls. - For the corresponding client see -> contrib/spi (work in progress). + For the corresponding JCR client see {{{jcr2spi.html} JCR to SPI}} and + the contribution inside the + {{{https://svn.apache.org/repos/asf/jackrabbit/sandbox/spi/spi2dav} Jackrabbit sandbox}}. \ No newline at end of file Modified: jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webdav.apt URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webdav.apt?rev=588575&r1=588574&r2=588575&view=diff ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webdav.apt (original) +++ jackrabbit/trunk/jackrabbit-site/src/site/apt/doc/components/webdav.apt Fri Oct 26 02:16:56 2007 @@ -21,22 +21,22 @@ This is the WebDAV Library component of the Apache Jackrabbit project. This component provides interfaces and common utility classes used for - building a WebDAV server or client. The following RFC have been integrated: + building a WebDAV server or client. - * RFC 2518 (WebDAV - HTTP Extensions for Distributed Authoring) + The following RFCs have been integrated: - * RFC 3253 (DeltaV - Versioning Extensions to WebDAV) + * {{{http://www.ietf.org/rfc/rfc2518.txt}RFC 2518}} (WebDAV - HTTP Extensions for Distributed Authoring) - * RFC 3648 (Ordered Collections Protocol) + * {{{http://www.ietf.org/rfc/rfc3253.txt}RFC 3253}} (DeltaV - Versioning Extensions to WebDAV) - * RFC 3744 (Access Control Protocol) + * {{{http://www.ietf.org/rfc/rfc3648.txt}RFC 3648}} (Ordered Collections Protocol) - * DAV Searching and Locating (DASL) + * {{{http://www.ietf.org/rfc/rfc3744.txt}RFC 3744}} (Access Control Protocol) + + * {{{http://greenbytes.de/tech/webdav/draft-reschke-webdav-search-latest.html}DAV Searching and Locating}} (DASL) In addition this library defines (unspecified) * Observation * Bundling multiple request with extensions to locking - - See "TODO.txt" for the current status and open issues. Added: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-invalidation.pdf URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-invalidation.pdf?rev=588575&view=auto ============================================================================== Binary file - no diff available. Propchange: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-invalidation.pdf ------------------------------------------------------------------------------ svn:mime-type = application/pdf Added: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-observation.pdf URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-observation.pdf?rev=588575&view=auto ============================================================================== Binary file - no diff available. Propchange: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-jcr2spi-cb-observation.pdf ------------------------------------------------------------------------------ svn:mime-type = application/pdf Added: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi-overview.gif URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi-overview.gif?rev=588575&view=auto ============================================================================== Binary file - no diff available. Propchange: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi-overview.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi.jpg URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi.jpg?rev=588575&view=auto ============================================================================== Binary file - no diff available. Propchange: jackrabbit/trunk/jackrabbit-site/src/site/resources/images/arch/jackrabbit-spi.jpg ------------------------------------------------------------------------------ svn:mime-type = image/jpeg Modified: jackrabbit/trunk/jackrabbit-site/src/site/site.xml URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-site/src/site/site.xml?rev=588575&r1=588574&r2=588575&view=diff ============================================================================== --- jackrabbit/trunk/jackrabbit-site/src/site/site.xml (original) +++ jackrabbit/trunk/jackrabbit-site/src/site/site.xml Fri Oct 26 02:16:56 2007 @@ -49,6 +49,10 @@ + + + +